ArkUI容器类组件-格栅布局容器（GridContainer）

原创

小帅聊鸿蒙

发布于 2024-09-28 20:18:31

1020

发布于 2024-09-28 20:18:31

文章被收录于专栏：鸿蒙开发笔记

ArkUI开发框架提供了纵向排布栅格布局容器 GridContainer ，它仅在栅格布局场景中使用。

GridContainer定义介绍

interface GridContainerInterface {
  (value?: GridContainerOptions): GridContainerAttribute;
}

declare interface GridContainerOptions {
  columns?: number | "auto";
  sizeType?: SizeType;
  gutter?: number | string;
  margin?: number | string;
}

value：设置布局的可选参数， GridContainerOptions 说明如下：
- columns：设置当前布局总列数，默认为 auto。
- sizeType：设置选用设备宽度类型， SizeType 参数说明如下：
  - XS：最小宽度类型设备。
  - SM：小宽度类型设备。
  - MD：中等宽度类型设备。
  - LG：大宽度类型设备。
  - Auto（默认值）：根据设备类型进行选择。
- gutter：设置栅格布局列间距。
- margin：设置栅格布局两侧间距。

简单样例如下所示：

    @Entry @Component struct ComponentTest {

      @State sizeType: SizeType = SizeType.XS // 默认采用最小宽度设备类型

      build() {
        Column() {
          GridContainer({
            columns: 12,                      // 设置格栅布局为12列
            sizeType: this.sizeType,          // 设置格栅布局类型
            gutter: 10,                       // 设置格栅布局列间距，该版本还有bug
            margin: 20                        // 设计格栅布局两侧间距
          }) {
            Row() {
              Text('1')
                .useSizeType({
                  xs: { span: 6, offset: 0 }, // Text1在xs设备上占用6列
                  sm: { span: 2, offset: 0 }, // Text1在sm设备上占用2列
                  md: { span: 2, offset: 0 }, // Text1在md设备上占用2列
                  lg: { span: 3, offset: 0 }  // Text1在lg设备上占用3列
                })
                .fontSize(20)
                .height(50)
                .backgroundColor(0x4682B4)
                .textAlign(TextAlign.Center)
              Text('2')
                .useSizeType({
                  xs: { span: 2, offset: 0 }, // Text2在xs设备上占用2列
                  sm: { span: 6, offset: 0 }, // Text2在sm设备上占用6列
                  md: { span: 2, offset: 0 }, // Text2在md设备上占用2列
                  lg: { span: 3, offset: 0 }  // Text2在lg设备上占用3列
                })
                .fontSize(20)
                .height(50)
                .backgroundColor(0x00BFFF)
                .textAlign(TextAlign.Center)
              Text('3')
                .useSizeType({
                  xs: { span: 2, offset: 0 }, // Text3在xs设备上占用2列
                  sm: { span: 2, offset: 0 }, // Text3在sm设备上占用2列
                  md: { span: 6, offset: 0 }, // Text3在md设备上占用6列
                  lg: { span: 3, offset: 0 }  // Text3在lg设备上占用3列
                })
                .fontSize(20)
                .height(50)
                .backgroundColor(0x4682B4)
                .textAlign(TextAlign.Center)
              Text('4')
                .useSizeType({
                  xs: { span: 2, offset: 0 }, // Text4在xs设备上占用2列
                  sm: { span: 2, offset: 0 }, // Text4在sm设备上占用2列
                  md: { span: 2, offset: 0 }, // Text4在md设备上占用2列
                  lg: { span: 3, offset: 0 }  // Text4在lg设备上占用3列
                })
                .fontSize(20)
                .height(50)
                .backgroundColor(0x00BFFF)
                .textAlign(TextAlign.Center)
            }
          }
          .backgroundColor(Color.Pink)
          .width('90%')
          .margin({top: 10})

          Row({space: 10}) {
            Button('XS')
              .onClick(() => {
                this.sizeType = SizeType.XS
              }).backgroundColor(0x317aff)
            Button('SM')
              .onClick(() => {
                this.sizeType = SizeType.SM
              }).backgroundColor(0x317aff)
            Button('MD')
              .onClick(() => {
                this.sizeType = SizeType.MD
              }).backgroundColor(0x317aff)
            Button('LG')
              .onClick(() => {
                this.sizeType = SizeType.LG
              }).backgroundColor(0x317aff)
          }
          .margin({top: 10})
        }.width('100%')
      }
    }