Skip to content

Check Card 选择卡片

xy-check-cardxy-check-card-group 适合把“选项”渲染成更完整的信息块。比普通单选更适合套餐切换、场景入口选择、模板挑选和后台工作台导航。

单卡片

单个 xy-check-card 适合承接启用/停用这类布尔切换,也可以作为更重的功能入口卡片。

当前状态:选中

单选卡片组

xy-check-card-group 默认是单选模式,再次点击当前项会取消选中。

当前选择:dashboard

多选卡片组

开启 multiple 后,适合权限模块、导出维度和展示能力组合选择。

已选:search

插槽自定义

支持统一插槽,也支持 title-值avatar-值extra-值 这类按 value 定向覆盖。

最近操作:vip

API

CheckCard Attributes

属性说明类型默认值
model-value是否选中booleanfalse
size卡片尺寸ComponentSize跟随全局配置
disabled是否禁用booleanfalse
title标题文本string''
description描述文本string''
extra右上角轻操作文案string''
avatar头像配置CheckCardAvatar
tag标题旁标签string | CheckCardTag
aria-label无障碍标签string''

CheckCard Events

事件说明参数
update:model-value选中状态变化时触发(checked: boolean) => void
change选中状态变化时触发(checked: boolean) => void
extra点击右上角操作区时触发() => void

CheckCard Slots

插槽说明
avatar自定义头像区
title自定义标题区
tag自定义标签区
description自定义描述区
extra自定义右上角轻操作区

CheckCardAvatar

属性说明类型
text默认文字头像内容string
icon图标头像图标名string
src图片头像地址string
alt图片替代文本string
src-set图片 srcsetstring
fit图片裁切方式AvatarFit
shape头像形状AvatarShape
size头像尺寸number | ComponentSize

CheckCardGroup Attributes

属性说明类型默认值
model-value当前值CheckCardSingleValue | CheckCardValue[]
options卡片组数据CheckCardGroupOption[][]
size组内默认尺寸ComponentSize
disabled是否整组禁用booleanfalse
multiple是否多选booleanfalse
aria-label无障碍标签string''

CheckCardGroup Events

事件说明参数
update:model-value当前值变化时触发(value: CheckCardSingleValue | CheckCardValue[]) => void
change当前值变化时触发(value: CheckCardSingleValue | CheckCardValue[]) => void
extra某一项操作区被点击时触发(option: CheckCardGroupOption) => void

CheckCardGroup Slots

插槽说明
avatar所有项共用头像插槽
title所有项共用标题插槽
tag所有项共用标签插槽
description所有项共用描述插槽
extra所有项共用操作区插槽

额外说明:

  • 支持按值定向插槽覆盖,例如 title-dashboardavatar-reportextra-export
  • 当同一位置同时存在通用插槽和按值插槽时,按值插槽优先