跳到主要内容

Grid 宫格 ​

WebH5

宫格(九宫格)。移动端常见的图标入口网格,支持自定义列数、分隔边框与正方形单元格。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Events ​

名称载荷说明
item-click(item: GridItem, index: number)点击宫格项时触发

示例 ​

九宫格图标入口 ​

示例加载中…

带边框正方形 ​

示例加载中…

点击回显当前格子 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Grid 文档(含手机预览)。