Cell 单元格
uni-appH5微信小程序App
uni-app 跨端列表单元格。左侧标题、右侧值,可显示箭头并响应点击。
何时使用
用于列表、表单项等需要左右信息对称展示的场景。
何时不使用
需要复杂布局或多行内容时,使用自定义列表项。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | - | 左侧标题 |
value | string | - | 右侧值 |
arrow | boolean | false | 是否显示右侧箭头 |
label | string | "''" | 标题下方的小字描述 |
icon | string | "''" | 左侧内置图标名,取值见 Icon |
showArrow | boolean | false | 右侧显示 chevron-right 箭头 |
clickable | boolean | false | 可点击,启用 hover/tap 反馈态 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | Event | 点击整行时触发 |
Slots
| 名称 | 说明 |
|---|---|
icon | 自定义左侧图标(优先于 icon prop) |
示例
基础用法
vue
<CellGroup>
<Cell title="用户名" value="Ruanno" />
<Cell title="会员等级" value="PLUS" />
</CellGroup>箭头与点击
vue
<CellGroup>
<Cell title="收货地址" value="广东深圳" arrow @click="onCellClick" />
<Cell title="账号安全" arrow @click="onCellClick" />
</CellGroup>单行独立使用
vue
<Cell title="当前版本" value="v1.0.0" />图标与描述
vue
<CellGroup>
<Cell icon="user" title="个人资料" label="头像、昵称、签名" show-arrow clickable />
<Cell icon="settings" title="通用设置" label="隐私、通知、清理缓存" show-arrow clickable />
</CellGroup>