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

小米椒……

724人浏览 · 2024-04-22 16:00:02

小米椒…… · 2024-04-22 16:00:02 发布

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%')
      }
    }

码牛课堂也为了积极培养鸿蒙生态人才，让大家都能学习到鸿蒙开发最新的技术，针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线。大家可以进行参考学习：https://qr21.cn/FV7h05

①全方位，更合理的学习路径：
路线图包括ArkTS基础语法、鸿蒙应用APP开发、鸿蒙能力集APP开发、次开发多端部署开发、物联网开发等九大模块，六大实战项目贯穿始终，由浅入深，层层递进，深入理解鸿蒙开发原理！

②多层次，更多的鸿蒙原生应用：
路线图将包含完全基于鸿蒙内核开发的应用，比如一次开发多端部署、自由流转、元服务、端云一体化等，多方位的学习内容让学生能够高效掌握鸿蒙开发，少走弯路，真正理解并应用鸿蒙的核心技术和理念。

③实战化，更贴合企业需求的技术点：
学习路线图中的每一个技术点都能够紧贴企业需求，经过多次真实实践，每一个知识点、每一个项目，都是码牛课堂鸿蒙研发团队精心打磨和深度解析的成果，注重对学生的细致教学，每一步都确保学生能够真正理解和掌握。

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05