Skip to content

Cell 单元格 ​

列表行单元格。标题 + 说明 + 右侧值的经典三段式布局,支持图标、必填红星、分隔线与点击箭头。

契约源:lh-ui-core/specs/cell.json · 黄金用例:lh-ui-core/cases/cell.json(6 条,已翻译为 hypium 测试)

基本用法 ​

title 为主文字,value 右对齐,label 为标题下方的次要说明。

9:41Cell 基本
标题文字
右侧值
带说明
这是说明文字
无分隔线(bordered=false)

HTML 模拟预览(鸿蒙 / ArkUI 外观),非真机渲染

typescript
LhCell({ title: '标题文字', value: '右侧值', label: '说明文字' })

图标 / 必填 / 可点击 ​

icon 在左侧绘制图标,required 在标题前绘制必填红星(取 color.danger.default), clickable 为 true 时右侧出现指示箭头并响应点击。

9:41Cell 变体
⌕
带图标
可点击
→
*必填项
可点击单元格
→

HTML 模拟预览(鸿蒙 / ArkUI 外观),非真机渲染

API ​

Props ​

属性说明类型默认值
title标题(主文字)string''
value右侧值(右对齐次文字)string''
label标题下方的说明文字string''
bordered是否绘制底部分隔线booleantrue
clickable是否可点击;为 true 时显示右侧箭头并响应点击booleanfalse
required是否在标题前显示必填红星booleanfalse
icon左侧图标名(本地图形体系渲染)string?undefined
onClick点击回调;clickable 为 false 时不触发() => void空函数

令牌对照 ​

令牌用途
cell.paddingHorizontal / cell.paddingVertical单元格内边距(16 / 8vp)
cell.fontSizeTitle / cell.fontSizeLabel / cell.fontSizeValue三段文字字号(14 / 13 / 14)
cell.gap标题与说明的垂直间距
color.text.primary / color.text.secondary标题色 / 说明与值色
color.border.lighter底部分隔线色
color.danger.default必填红星色
icon.size.medium左侧图标与右侧箭头尺寸

黄金用例对照 ​

cases/cell.json 的 6 条断言与 hypium 测试的对应关系(entry/src/test/Cell.test.ets):

case id断言本地测试
title-and-value-render标题与值消费字号令牌title_and_value_use_font_tokens
label-renders-secondary-tone说明取次要文字色label_uses_secondary_tone
required-uses-danger-token必填红星取危险色required_uses_danger_token
bordered-emits-line-command分隔线消费描边令牌bordered_uses_border_lighter_token
clickable-emits-onclick可点击时触发回调clickable_state_is_resolved
not-clickable-no-onclick不可点击时不触发clickable_state_is_resolved(gate 断言)

另有暗色专项:dark_colors_come_from_dark_tokens / dimensions_are_identical_in_dark_mode。 运行:DevEco Studio 右键 entry/src/test → Run Tests。