跳到正文

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 ​

属性类型默认值说明
clickablebooleantrue是否可点击(影响 cursor 和 hover),默认 true
activebooleanfalse激活状态(当前选中项)
selectedbooleanfalse选中状态(多选模式)
disabledbooleanfalse禁用状态
size'compact' | 'normal' | 'large''normal'尺寸:compact / normal / large,默认 normal
titlestring—标题文本(便捷模式,也可用 title slot)
subtitlestring—副标题文本
metastring—右侧元信息文本(计数、时间)
showArrowbooleanfalse是否显示右侧箭头(导航项常用)
borderboolean | 'top' | 'bottom'false分隔线:true=bottom / false=none / 'top' / 'bottom'。
分割线模式的默认风格:内容左右内收 12px(--uikit-cell-border-padding-x)、cell 间距归零,
底部发丝线左侧跟随内收(--uikit-cell-border-inset 可独立覆盖,0 = 通栏)、右侧顶满。
autoHeightbooleanfalse内容驱动高度(而非固定高度)
dangerbooleanfalse危险操作样式(文字/图标显示为红色)
insetHoverbooleantruehover 背景是否内缩(默认 true,卡片内操作项可设为 false 使 hover 背景顶满)

Events ​

事件名参数说明
clickevent: MouseEvent点击 cell 时触发(disabled 时不触发),负载为原生点击事件
contextmenuevent: MouseEvent右键点击 cell 时触发(disabled 时不触发),常用于唤出上下文菜单

Slots ​

插槽名说明
leading—
title—
subtitle—
trailing—