跳到主要内容

Grid 宫格 ​

uni-appH5微信小程序App

跨端宫格布局,支持图标、列数、边框和正方形单元格。

何时使用 ​

移动端首页/菜单页的图标入口导航,功能平铺展示。

何时不使用 ​

结构化数据列表用 Cell/Table;需要左右布局用 Row/Col。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Grid 宫格 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
itemsGridItem[][]宫格项:{ icon?: string; text: string },icon 为 Icon 组件 name
columnsnumber4列数
borderbooleanfalse是否显示分隔边框
squarebooleanfalse单元格是否正方形(aspect-ratio 1:1)

Events ​

名称载荷说明
item-clickGridItem, number点击宫格项时触发

示例 ​

四列宫格 ​

vue
<Grid :items="gridItems" />

三列带边框 ​

vue
<Grid :items="gridItems" :columns="3" border />

方形宫格 ​

vue
<Grid :items="[{ text: '扫一扫', icon: 'search' }, { text: '付款码', icon: 'lock' }, { text: '出行', icon: 'home' }, { text: '卡包', icon: 'star' }]" :columns="4" square />