鴻蒙ArkTS聲明式開發：跨平臺支持列表【柵格設置】通用屬性

柵格設置

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。
柵格布局的列寬、列間距由距離最近的GridContainer父組件決定。使用柵格屬性的組件樹上至少需要有1個GridContainer容器組件。

gridSpan、gridOffset屬性調用時其父組件或祖先組件必須是GridContainer。

屬性

名稱	參數類型	描述
gridSpan	number	默認占用列數，指useSizeType屬性沒有設置對應尺寸的列數(span)時，占用的柵格列數。說明：設置了柵格span屬性，組件的寬度由柵格布局決定。默認值：1
gridOffset	number	默認偏移列數，指useSizeType屬性沒有設置對應尺寸的偏移(offset)時，當前組件沿著父組件Start方向，偏移的列數，也就是當前組件位于第n列。說明：- 配置該屬性后，當前組件在父組件水平方向的布局不再跟隨父組件原有的布局方式，而是沿著父組件的Start方向偏移一定位移。 - 偏移位移 = （列寬 + 間距）* 列數。 - 設置了偏移(gridOffset)的組件之后的兄弟組件會根據該組件進行相對布局，類似相對布局。默認值：0

示例

// xxx.ets
@Entry
@Component
struct GridContainerExample1 {
  build() {
    Column() {
      // 單獨設置組件的span和offset,在sm尺寸大小的設備上使用useSizeType中sm的數據實現一樣的效果
      Text('gridSpan,gridOffset').fontSize(15).fontColor(0xCCCCCC).width('90%')
      GridContainer() {
        Row() {
          Row() {
            Text('Left').fontSize(25)
          }
          .gridSpan(1)
          .height("100%")
          .backgroundColor(0x66bbb2cb)

          Row() {
            Text('Center').fontSize(25)
          }
          .gridSpan(2)
          .gridOffset(1)
          .height("100%")
          .backgroundColor(0x66b6c5d1)

          Row() {
            Text('Right').fontSize(25)
          }
          .gridSpan(1)
          .gridOffset(3)
          .height("100%")
          .backgroundColor(0x66bbb2cb)
        }.height(200)
      }
    }
  }
}