Cell 单元格
列表单元格组件,常用于设置项、联系人列表、操作行等场景。
使用方式
组件以 EmCell 为名导出,全局注册后可直接使用:
vue
<template>
<em-cell title="黑名单" meta="12" show-arrow border />
</template>基础导航
头像列表项
尺寸与状态
使用建议
| ✅ Do | ❌ Don't |
|---|---|
列表项主文案用 title,辅助信息用 meta | 在 title 里塞入两行以上内容 |
导航入口设置 show-arrow 提示可点击 | 所有 Cell 都默认带箭头 |
头像、图标放在 leading 插槽,操作放在 trailing | 在 title 区手写 flex 布局塞图标 |
| 相关设置项用分组标题 + 边框分隔 | 一个长列表无任何分组 |
禁用项使用 disabled 并配合说明 | 禁用项不给出任何原因 |
API
Cell API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| clickable | boolean | true | 是否可点击(影响 cursor 和 hover),默认 true |
| active | boolean | false | 激活状态(当前选中项) |
| selected | boolean | false | 选中状态(多选模式) |
| disabled | boolean | false | 禁用状态 |
| size | 'compact' | 'normal' | 'large' | 'normal' | 尺寸:compact / normal / large,默认 normal |
| title | string | — | 标题文本(便捷模式,也可用 title slot) |
| subtitle | string | — | 副标题文本 |
| meta | string | — | 右侧元信息文本(计数、时间) |
| showArrow | boolean | false | 是否显示右侧箭头(导航项常用) |
| border | boolean | 'top' | 'bottom' | false | 分隔线:true=bottom / false=none / 'top' / 'bottom'。 分割线模式的默认风格:内容左右内收 12px(--uikit-cell-border-padding-x)、cell 间距归零, 底部发丝线左侧跟随内收(--uikit-cell-border-inset 可独立覆盖,0 = 通栏)、右侧顶满。 |
| autoHeight | boolean | false | 内容驱动高度(而非固定高度) |
| danger | boolean | false | 危险操作样式(文字/图标显示为红色) |
| insetHover | boolean | true | hover 背景是否内缩(默认 true,卡片内操作项可设为 false 使 hover 背景顶满) |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
click | event: MouseEvent | 点击 cell 时触发(disabled 时不触发),负载为原生点击事件 |
contextmenu | event: MouseEvent | 右键点击 cell 时触发(disabled 时不触发),常用于唤出上下文菜单 |
Slots
| 插槽名 | 说明 |
|---|---|
leading | — |
title | — |
subtitle | — |
trailing | — |
