文档开发者中心
我的
|

HarmonyOS 5

Grid 网格布局

在 ArkUI 中,如何使用 Grid 组件实现网格布局?如何设置网格的行列数和间距?如何实现不规则的网格布局(如某些项占据多行或多列)?Grid 与 Flex 布局相比有什么优势?如何实现响应式的网格布局?(问题来源项目案例整理:https://github.com/heqiyuan35-creator/HydroQuiz.git)

点赞
收藏
回复
1
分享
举报
浏览155 发布于2025-12-25 02:18湖北
全部评论
最多点赞
最新发布
最早发布

Grid 组件用于创建规则的网格布局。

**基础网格布局**:

```typescript

Grid() {

  ForEach(this.categories, (category: Category) => {

    GridItem() {

      Column() {

        Image(category.icon)

          .width(40)

          .height(40)

        Text(category.name)

          .fontSize(14)

          .margin({ top: 8 })

      }

      .padding(16)

      .backgroundColor(ThemeColors.SURFACE)

      .borderRadius(12)

    }

  })

}

.columnsTemplate('1fr 1fr 1fr')  // 3列等宽

.rowsGap(12)                      // 行间距

.columnsGap(12)                   // 列间距

.width('100%')

.height('auto')

```

**不规则网格(跨行跨列)**:

```typescript

Grid() {

  GridItem() {

    // 大卡片,占据2列2行

    this.LargeCard()

  }

  .columnStart(0)

  .columnEnd(1)

  .rowStart(0)

  .rowEnd(1)

  GridItem() {

    this.SmallCard()

  }

  .columnStart(2)

  .rowStart(0)

  // 更多 GridItem...

}

.columnsTemplate('1fr 1fr 1fr')

.rowsTemplate('1fr 1fr')

```

**响应式网格**:

```typescript

@State screenWidth: number = 0;

aboutToAppear(): void {

  this.screenWidth = px2vp(display.getDefaultDisplaySync().width);

}

private getColumnsTemplate(): string {

  if (this.screenWidth > 600) {

    return '1fr 1fr 1fr 1fr';  // 大屏4列

  } else if (this.screenWidth > 400) {

    return '1fr 1fr 1fr';      // 中屏3列

  }

  return '1fr 1fr';            // 小屏2列

}

Grid() { ... }

  .columnsTemplate(this.getColumnsTemplate())

展开全部
1楼回复于2025-12-25 08:16 来自湖北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。