Grid 宫格
uni-appH5微信小程序App
跨端宫格布局,支持图标、列数、边框和正方形单元格。
何时使用
移动端首页/菜单页的图标入口导航,功能平铺展示。
何时不使用
结构化数据列表用 Cell/Table;需要左右布局用 Row/Col。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
items | GridItem[] | [] | 宫格项:{ icon?: string; text: string },icon 为 Icon 组件 name |
columns | number | 4 | 列数 |
border | boolean | false | 是否显示分隔边框 |
square | boolean | false | 单元格是否正方形(aspect-ratio 1:1) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
item-click | GridItem, 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 />