跳到主要内容

Cell 单元格 ​

uni-appH5微信小程序App

uni-app 跨端列表单元格。左侧标题、右侧值,可显示箭头并响应点击。

何时使用 ​

用于列表、表单项等需要左右信息对称展示的场景。

何时不使用 ​

需要复杂布局或多行内容时,使用自定义列表项。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Cell 单元格 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring-左侧标题
valuestring-右侧值
arrowbooleanfalse是否显示右侧箭头
labelstring"''"标题下方的小字描述
iconstring"''"左侧内置图标名,取值见 Icon
showArrowbooleanfalse右侧显示 chevron-right 箭头
clickablebooleanfalse可点击,启用 hover/tap 反馈态

Events ​

名称载荷说明
clickEvent点击整行时触发

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>