当前位置:   article > 正文

HarmonyOS应用开发:网格布局Grid_鸿蒙gridlayout

鸿蒙gridlayout

网格布局

网格布局(GridLayout)是自适应布局中一种重要的布局,具备较强的页面均分能力,子组件占比控制能力。 通过GridGrid容器组件子组件GridItem实现, Grid用于设置网格布局相关参数,GridItem定义子组件相关特征。优势如下:

  1. 容器组件尺寸发生变化时,所有子组件以及间距等比例调整,实现布局的自适应能力
  2. 支持自定义网格布局行数和列数,以及每行每列尺寸占比
  3. 支持设置网格布局中子组件的行列间距
  4. 支持设置子组件横跨几行或者几列

Grid

网格容器,由“”和“”分割的单元格所组成,通过指定“项目”所在的单元格做出各种各样的布局。

子组件

包含GridItem子组件。

接口

Grid(scroller?: Scroller)

属性

除支持通用属性外,还支持以下属性:

名称参数类型描述
columnsTemplatestring设置当前网格布局列的数量,不设置时默认1列。
例如, ‘1fr 1fr 2fr’ 是将父组件分3列,将父组件允许的宽分为4等份,第一列占1份,第二列占1份,第三列占2份。并支持auto-fill
默认值:‘1fr’
rowsTemplatestring设置当前网格布局行的数量,不设置时默认1行。
例如, '1fr 1fr 2fr’是将父组件分三行,将父组件允许的高分为4等份,第一行占1份,第二行占一份,第三行占2份。并支持auto-fill
默认值:‘1fr’
columnsGapLength设置列与列的间距。
默认值:0
rowsGapLength设置行与行的间距。
默认值:0
scrollBarBarState设置滚动条状态。
默认值:BarState.Off
scrollBarColorstring | number | Color设置滚动条的颜色。
scrollBarWidthstring | number设置滚动条的宽度。
cachedCountnumber设置预加载的GridItem的数量。具体使用可参考减少应用白块说明
默认值:1
editMode 8+boolean设置Grid是否进入编辑模式,进入编辑模式可以拖拽Grid组件内部GridItem
默认值:flase
layoutDirection 8+GridDirection设置布局的主轴方向。
默认值:GridDirection.Row
maxCount 8+number当layoutDirection是Row/RowReverse时,表示可显示的最大行数
当layoutDirection是Column/ColumnReverse时,表示可显示的最大列数。
默认值:1
minCount8+number当layoutDirection是Row/RowReverse时,表示可显示的最小行数。
当layoutDirection是Column/ColumnReverse时,表示可显示的最小列数。
默认值:1
cellLength 8+number当layoutDirection是Row/RowReverse时,表示一行的高度。
当layoutDirection是Column/ColumnReverse时,表示一列的宽度。
默认值:0
multiSelectable 8+boolean是否开启鼠标框选。
默认值:false
- false:关闭框选。
- true:开启框选。
supportAnimation 8+boolean是否支持动画。
默认值:false

GridDirection8+枚举说明

名称描述
Row主轴布局方向沿水平方向布局,即自左往右先填满一行,再去填下一行。
Column主轴布局方向沿垂直方向布局,即自上往下先填满一列,再去填下一列。
RowReverse主轴布局方向沿水平方向反向布局,即自右往左先填满一行,再去填下一行。
ColumnReverse主轴布局方向沿垂直方向反向布局,即自下往上先填满一列,再去填下一列。

事件

除支持通用事件外,还支持以下事件:

名称功能描述
onScrollIndex(event: (first: number) => void)当前网格显示的起始位置item发生变化时触发。
- first: 当前显示的网格起始位置的索引值。
onItemDragStart(event: (event: ItemDragInfo, itemIndex: number) => (() => any) | void)开始拖拽网格元素时触发。
- event: 见ItemDragInfo对象说明
- itemIndex: 被拖拽网格元素索引值。
onItemDragEnter(event: (event: ItemDragInfo) => void)拖拽进入网格元素范围内时触发。
- event: 见ItemDragInfo对象说明
onItemDragMove(event: (event: ItemDragInfo, itemIndex: number, insertIndex: number) => void)拖拽在网格元素范围内移动时触发。
- event: 见ItemDragInfo对象说明
- itemIndex: 拖拽起始位置。
- insertIndex: 拖拽插入位置。
onItemDragLeave(event: (event: ItemDragInfo, itemIndex: number) => void)拖拽离开网格元素时触发。
- event: 见ItemDragInfo对象说明
- itemIndex: 拖拽离开的网格元素索引值。
onItemDrop(event: (event: ItemDragInfo, itemIndex: number, insertIndex: number, isSuccess: boolean) => void)绑定该事件的网格元素可作为拖拽释放目标,当在网格元素内停止拖拽时触发。
- event: 见Grid
- itemIndex: 拖拽起始位置。
- insertIndex: 拖拽插入位置。
- isSuccess: 是否成功释放。

auto-fill说明

Grid的columnsTemplate、rowsTemplate属性的auto-fill仅支持以下格式:

repeat(auto-fill, track-size)

其中repeat、auto-fill为关键字。track-size为行高或者列宽,支持的单位包括px、vp、%或有效数字,track-size至少包括一个有效行高或者列宽。 

ItemDragInfo对象说明

名称类型描述
xnumber当前拖拽点的x坐标。
ynumber当前拖拽点的y坐标。

示例:

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct GridExample {
  5. @State Number: String[] = ['0', '1', '2', '3', '4']
  6. build() {
  7. Column({ space: 5 }) {
  8. Grid() {
  9. ForEach(this.Number, (day: string) => {
  10. ForEach(this.Number, (day: string) => {
  11. GridItem() {
  12. Text(day)
  13. .fontSize(16)
  14. .backgroundColor(0xF9CF93)
  15. .width('100%')
  16. .height('100%')
  17. .textAlign(TextAlign.Center)
  18. }
  19. }, day => day)
  20. }, day => day)
  21. }
  22. .columnsTemplate('1fr 1fr 1fr 1fr 1fr')
  23. .rowsTemplate('1fr 1fr 1fr 1fr 1fr')
  24. .columnsGap(10)
  25. .rowsGap(10)
  26. .width('90%')
  27. .backgroundColor(0xFAEEE0)
  28. .height(300)
  29. Text('scroll').fontColor(0xCCCCCC).fontSize(9).width('90%')
  30. Grid() {
  31. ForEach(this.Number, (day: string) => {
  32. ForEach(this.Number, (day: string) => {
  33. GridItem() {
  34. Text(day)
  35. .fontSize(16)
  36. .backgroundColor(0xF9CF93)
  37. .width('100%')
  38. .height(80)
  39. .textAlign(TextAlign.Center)
  40. }
  41. }, day => day)
  42. }, day => day)
  43. }
  44. .columnsTemplate('1fr 1fr 1fr 1fr 1fr')
  45. .columnsGap(10)
  46. .rowsGap(10)
  47. .onScrollIndex((first: number) => {
  48. console.info(first.toString())
  49. })
  50. .width('90%')
  51. .backgroundColor(0xFAEEE0)
  52. .height(300)
  53. }.width('100%').margin({ top: 5 })
  54. }
  55. }

 

 

auto-fill示例:

  1. // grid-autofill.ets
  2. @Entry
  3. @Component
  4. struct Index {
  5. @State gridItemWidth: string = "100%"
  6. @State gridItemHeight: string = "100%"
  7. @State gridWidth: string = "100%"
  8. @State gridHeight: string = "100%"
  9. @State itemList: string[] = []
  10. build() {
  11. Column() {
  12. Grid() {
  13. ForEach(this.itemList, (item) => {
  14. GridItem() {
  15. Text(item.toString())
  16. .fontSize(16)
  17. .width('100%')
  18. .textAlign(TextAlign.Center)
  19. }
  20. .width(this.gridItemWidth)
  21. .height(this.gridItemHeight)
  22. .backgroundColor(0xF9CF93)
  23. }, item => item)
  24. }
  25. .columnsGap(1)
  26. .rowsGap(1)
  27. .border({ width: 4, color: 0xffdb7093, style: BorderStyle.Dashed, radius: 5 })
  28. .width(this.gridWidth)
  29. .height(this.gridHeight)
  30. .columnsTemplate("15% repeat(auto-fill, 10% 50px 20%) 50px")
  31. .rowsTemplate("150px repeat(auto-fill, 20% 25%)")
  32. }.margin(5)
  33. }
  34. aboutToAppear() {
  35. for(var i = 1; i < 50; i++) {
  36. this.itemList.push(i.toString())
  37. }
  38. }
  39. }

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/我家自动化/article/detail/315225?site
推荐阅读
相关标签
  

闽ICP备14008679号