更新记录

1.0.1（2026-08-25） 下载此版本

1.0.0（2026-04-02） 下载此版本

平台兼容性

uni-app(3.8.2)

uni-app x(3.8.2)

其他

vant-cell

单元格组件（Vant 风格，零业务耦合）

介绍

单元格为一行展示标题、描述、右侧内容的组件，常用于设置中心、个人信息、vant-cell-group 分组列表等页面。本组件为 Vue3 <script setup lang="ts"> 实现，样式令牌统一来自宿主 uni.scss 的 $uni-* 体系。

基础用法

<!-- 基础用法 -->
<vant-cell title="标题" value="内容" />

<!-- 带描述 -->
<vant-cell title="标题" label="描述信息" value="内容" />

<!-- 左侧图标 -->
<vant-cell title="标题" icon="/static/icon.png" value="内容" />

<!-- 右侧箭头 / 可点击 -->
<vant-cell title="地址管理" is-link @click="onClick" />
<vant-cell title="收货地址" clickable value="北京市" @click="onClick" />

<!-- 必填标记 -->
<vant-cell title="昵称" required :border="false" />

<!-- 分组（圆角卡片） -->
<vant-cell-group title="分组标题" inset>
    <vant-cell title="选项一" value="1" />
    <vant-cell title="选项二" value="2" />
</vant-cell-group>

vant-cell Props

vant-cell Events

vant-cell Slots

vant-cell-group Props

vant-cell-group Slots

平台兼容性

• H5 ✓
• 小程序 ✓
• App ✓

设计约束

• 仅 Vue3，不提供 Vue2 / .uvue 实现。
• 组件零业务耦合：点击仅 emit('click', event)，不内嵌任何导航或网络请求。
• 样式令牌统一来自宿主 uni.scss 的 $uni-*，无硬编码色值。