集合多种相关联说明信息,并且可被选择的卡片。特点:
最常用的选项卡示例,包括头像,标题,描述等部分,可被选择。
在多个选项存在的情况下可通过 CheckCard.Group
分组,默认选项卡组件为单选模式。
通过设置 CheckCard.Group
的 multiple
属性配置多选,注意多选模式下表单项返回值为数组。
配置 size
尺寸大小,当前可选 large
,default
,small
,不同尺寸仅宽度不同。
当然你也可以通过 style
或 className
自定义卡片大小。
CheckCard 可以和表单组件一起使用,这里给出演示示例。
头像,标题,描述区域可以自由组合或者单独呈现,组件会为你调整为最合适的对齐方式。
你可以通过 avatar
属性自定义头像区域。
你可以通过 title
属性自定义标题区域。
描述区域可通过 description
自定义 React 节点。
通过配置 defaultChecked
属性为 true
来配置选项默认被选中。
配置 extra
为卡片添加操作栏。
通过配置 loading
属性为 true
来配置内容在加载中。
通过仅仅配置 cover
属性可以让你的选项成为一个纯图片选项。
通过配置 disabled
属性配置选项不可用。
CheckCard.Group
支持通过 options
属性配置化来列表展示多个选项。
这里展示在实际 AiDesk 中图像算法选择的使用示例。
CheckCard.Group
内嵌 CheckCard
并与 Grid
组件一起使用,可以实现更灵活的布局。
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
checked | 指定当前是否选中 | boolean | false | |
bordered | 是否显示边框 | boolean | true | 1.20.0 |
value | 选项值 | string | - | |
defaultChecked | 初始是否选中 | boolean | false | |
disabled | 失效状态 | boolean | false | |
size | 选择框大小,可选 large small | string | default | |
onChange | 变化时回调函数 | Function(checked) | - | |
loading | 当卡片内容还在加载中时,可以用 loading 展示一个占位 | boolean | false | |
title | 标题 | string | ReactNode | - | |
description | 描述 | ReactNode | - | |
avatar | 选项元素的图片地址 | link | ReactNode | - | |
extra | 动作区域 | 卡片右上角的操作区域 | - | |
cover | 卡片背景图片, 注意使用该选项后title ,description 和avatar 失效 | ReactNode | - |
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
multiple | 多选 | boolean | false | |
bordered | 是否显示边框 | boolean | true | 1.20.0 |
defaultValue | 默认选中的选项 | string | string[] | - | |
disabled | 整组失效 | boolean | false | |
loading | 当卡片组内容还在加载中时,可以用 loading 展示一个占位 | boolean | false | |
options | 指定可选项 | string[] | Array<{ title: ReactNode, value: string, description?: ReactNode, avatar?: link or ReactNode, cover?:ReactNode, disabled?: boolean }> | [] | |
value | 指定选中的选项 | string | string[] | - | |
size | 选择框大小,可选 large small | string | default | |
onChange | 变化时回调函数 | Function(checkedValue) | - |