更新记录

0.1.3（2025-08-31） 下载此版本

• chore: 更新文档

0.1.2（2025-05-30） 下载此版本

• feat: 增加默认插槽

0.1.1（2025-05-07） 下载此版本

• feat: 增加组件属性提示

平台兼容性

uni-app(4.74)

uni-app x(4.76)

其他

lime-cell 单元格

一个功能丰富的单元格组件，用于各个类别行的信息展示，可组成列表。组件兼容uni-app和uni-app x，支持多种布局和样式，适用于各种场景的信息展示和交互。

插件依赖：lime-shared、lime-icon、lime-style

文档链接

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

• 单元格组件文档 - 站点1
• 单元格组件文档 - 站点2
• 单元格组件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-cell
2. 导入后可能需要重新编译项目
3. 在页面中使用l-cell和l-cell-group组件（组件）或lime-cell（演示）

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

代码演示

基础用法

Cell 可以单独使用，也可以与 CellGroup 搭配使用，CellGroup 可以为 Cell 提供上下外边框。

<l-cell-group>
  <l-cell title="单行标题" :arrow="true"></l-cell>
  <l-cell title="单行标题" :arrow="true" :hover="true" :required="true" />
</l-cell-group>

export default {
  data() {
    return {
      // 示例数据
    }
  },
  methods: {
    onCellClick(event) {
      console.log('单元格点击', event);
    }
  }
}

卡片风格

通过 CellGroup 的 inset 属性，可以将单元格转换为圆角卡片风格。

<l-cell-group inset>
  <l-cell title="单行标题" note="辅助信息" :arrow="true" />
  <l-cell title="单行标题" description="一段很长很长的内容文字" :arrow="true"></l-cell>
</l-cell-group>

单元格大小

通过 size 属性可以控制单元格的大小。

<l-cell title="单行标题" note="辅助信息" size="small" />
<l-cell title="单行标题" note="辅助信息" size="small" description="一段很长很长的内容文字" />

图标图片

通过 icon 属性在标题左侧展示图标，通过 image 属性在标题左侧展示图片。

<l-cell title="单行标题" icon="animation-1" :arrow="true" :hover="true" />
<l-cell title="多行带头像" description="一段很长很长的内容文字" :arrow="true">
  <template #icon>
    <l-avatar shape="circle" src="https://tdesign.gtimg.com/mobile/demos/avatar1.png" />
  </template>
</l-cell>
<l-cell title="多行带图片" description="一段很长很长的内容文字" image="https://tdesign.gtimg.com/mobile/demos/avatar2.png" />

展示箭头

设置 arrow 属性后会在单元格右侧显示箭头。

<l-cell title="单元格" :arrow="true" />

页面导航

可以通过 url 属性进行 URL 跳转。通过openType设置跳转类型。

<l-cell title="URL 跳转" :arrow="true" url="/pages/test/index" />
<l-cell title="重定向跳转" :arrow="true" url="/pages/test/index" openType="redirectTo" />

分组标题

通过 CellGroup 的 title 属性可以指定分组标题。

<l-cell-group title="分组1">
  <l-cell title="单行标题" />
</l-cell-group>
<l-cell-group title="分组2">
  <l-cell title="单行标题" />
</l-cell-group>

使用插槽

如以上用法不能满足你的需求，可以使用插槽来自定义内容。

<l-cell value="内容" :arrow="true">
  <!-- 使用 title 插槽来自定义标题 -->
  <template #title>
    <text class="custom-title">单行标题</text>
    <l-tag type="primary">标签</l-tag>
  </template>
</l-cell>

<l-cell title="左侧图标">
  <!-- 使用 icon 插槽来自定义左侧图标 -->
  <template #icon>
    <l-icon name="search" />
  </template>
</l-cell>

<l-cell title="右侧图标">
  <!-- 使用 rightIcon 插槽来自定义右侧图标 -->
  <template #rightIcon>
    <l-icon name="search" />
  </template>
</l-cell>

<l-cell title="辅助信息">
  <!-- 使用 note 插槽来自定义右侧辅助信息 -->
  <template #note>
    <l-badge :content="20" />
  </template>
</l-cell>

<l-cell title="内容描述">
  <!-- 使用 description 插槽来自定义下方内容描述 -->
  <template #description>
    <text>多行高度不定，长文本自动换行，该选项的描述是一段很长的内容</text>
  </template>
</l-cell>

对齐方式

通过 align 可以设置内容的对齐方式，可选项：top/middle/bottom，默认是middle。

<l-cell align="bottom" title="单行标题" note="内容" description="一段很长很长的内容文字" />

快速预览

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

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

插件标签说明

• 默认 l-cell 为组件标签
• 默认 l-cell-group 为组件标签
• 默认 lime-cell 为演示标签

Vue2使用说明

本插件使用了composition-api，如需在Vue2项目中使用，请按照官方教程配置。

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

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

API文档

CellGroup Props

Cell Props

Cell Events

Cell Slots

主题定制

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

支持与赞赏

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

支付宝赞助	微信赞助