Skip to content

KvExpandableCardList ​

可展开卡片列表,适合展示分组配置、任务清单和带明细的摘要数据。组件不假设具体业务字段。

实时预览 ​

可展开卡片列表

点击卡片标题,或聚焦后使用 Enter、Space 键切换展开状态。

实时渲染
服务
用户服务配置3 个配置项
配置详情超时时间 30 秒,最大重试次数 3 次。

Props ​

属性类型默认值必填说明
itemsT[]—是卡片数据
rowKeykeyof T | ((item, index) => key)—是卡片唯一键
accentColorstring | ((item) => string)—否卡片左侧强调色
columnsKvExpandableCardColumn[][]否默认明细表列
detailData(item) => Record<string, unknown>[]当前项单行否默认明细表数据转换函数
cellStyle(context) => CSSProperties—否默认明细表单元格样式
defaultExpandAllbooleantrue否数据变化后是否默认全部展开
emptyTextstring'暂无数据'否空状态文案

v-model ​

名称类型默认值说明
expandedKeys(string | number)[][]当前展开的卡片键

Slots ​

插槽参数说明
header{ item, expanded }完整自定义卡片头部
tag{ item }默认头部标签区
meta{ item }默认头部摘要区
detail{ item, expanded }卡片明细内容
empty—自定义空状态

Exposed ​

  • expandAll():展开全部卡片;
  • collapseAll():收起全部卡片;
  • toggle(key):切换指定卡片;
  • setExpanded(keys):设置展开键。

示例代码 ​

vue
<KvExpandableCardList :items="items" row-key="id">
  <template #meta="{ item }">{{ item.name }}</template>
  <template #detail="{ item }">{{ item.description }}</template>
</KvExpandableCardList>