更新记录

0.2.1（2025-10-15） 下载此版本

• fix: 修复iconColor不生效

0.2.0（2025-09-26） 下载此版本

• feat: 把边框改细

0.1.9（2025-09-26） 下载此版本

• chore: 更新文档

平台兼容性

uni-app(4.44)

uni-app x(4.62)

lime-grid 宫格

一个宫格布局组件，用于功能入口布局，将页面或特定区域切分成若干等大的区块，形成若干功能入口。兼容uniapp/uniappx(h5,ios,安卓)。

插件依赖：lime-style,lime-shared

基础功能

• 支持自定义列数
• 支持页面导航跳转
• 支持设置格子间距
• 支持带描述文字的宫格
• 支持内容横向排列
• 支持带边框宫格
• 支持提示信息（小红点、徽标）
• 支持卡片风格

文档链接

📚 组件详细文档请访问以下站点：

• 宫格文档 - 站点1
• 宫格文档 - 站点2
• 宫格文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-grid
2. 首次导入可能需要重新编译

::: tip 注意🔔 本插件依赖的【lime-svg】是原生插件，如果购买(收费为6元)则需要自定义基座，才能使用， 若不需要删除即可 :::

代码演示

基础使用

通过icon属性设置格子内的图标，通过image属性设置格子图片，text属性设置文字内容。

<l-grid>
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
    <l-grid-item text="最多五个字" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
</l-grid>

自定义列数

默认一行展示四个格子，可以通过column自定义列数。

<l-grid :column="5">
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
    <l-grid-item text="最多四字" image="https://tdesign.gtimg.com/mobile/demos/avatar5.png" />
</l-grid>

页面导航

可以通过url属性进行页面跳转，通过openType属性控制跳转类型。

<l-grid :column="3">
    <l-grid-item text="跳到首页" url="/pages/index/index" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="跳到首页" url="/pages/index/index" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="跳到首页" url="/pages/index/index" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
</l-grid>

格子间距

通过gutter属性设置格子之间的距离。

<l-grid :gutter="10">
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
</l-grid>

带描述宫格

通过description属性详细描述

<l-grid :column="3">
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="最多六个文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
</l-grid>

内容横排

通过layout属性设置为horizontal，可以让宫格的内容呈横向排列。

<l-grid :column="2" align="left">
    <l-grid-item text="标题文字" description="描述文字" layout="horizontal" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" description="描述文字" layout="horizontal" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
</l-grid>

带边框宫格

通过border属性设置为true可给格子加描边。

<l-grid :column="3" :border="true">
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar5.png" />
    <l-grid-item text="标题文字" description="描述文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
</l-grid>

提示信息

设置dot属性后，会在图标右上角展示一个小红点。设置badge属性后，会在图标右上角展示相应的徽标。

<l-grid>
    <l-grid-item text="标题文字" :dot="true" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" badge="5" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />
    <l-grid-item text="标题文字" badge="15" image="https://tdesign.gtimg.com/mobile/demos/avatar3.png" />
    <l-grid-item text="标题文字" badge="New" image="https://tdesign.gtimg.com/mobile/demos/avatar4.png" />
</l-grid>

插槽

icon插槽，text插槽,description插槽

<l-grid>
    <l-grid-item text="标题文字">
        <template #icon>
            <l-icon name="undertake-hold-up" size="48rpx"></l-icon>
        </template>
    </l-grid-item>
    <l-grid-item icon="undertake-hold-up">
        <template #text>
            <text>标题文字</text>
        </template>
    </l-grid-item>
    <l-grid-item text="标题文字" icon="undertake-hold-up">
        <template #description>
            <text>详情描述</text>
        </template>
    </l-grid-item>
</l-grid>

卡片

通过inset属性可以设置为卡片

<l-grid :inset="true">
    <l-grid-item text="标题文字" image="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
    <l-grid-item text="标题文字" icon="star"/>
    <l-grid-item text="标题文字" icon="download"/>
    <l-grid-item text="标题文字" icon="edit"/>
</l-grid>

Vue2使用说明

本插件使用了composition-api，请按照官方教程配置。

关键配置代码（在main.js中添加）：

// main.js
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

快速预览

导入插件后，可以直接使用以下标签查看演示效果：

<!-- 代码位于 uni_modules/lime-grid/components/lime-grid -->
<lime-grid />

插件标签说明

• l-grid：宫格容器组件
• l-grid-item：宫格项组件
• lime-grid：演示标签

API文档

Grid Props

GridItem Props

GridItem Events

GridItem Slots

主题定制

组件提供了下列CSS变量，可用于自定义样式。

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：	支付宝赞助	微信赞助