# UCheckboxCard 多选卡片 - [示例](#示例) - [基本用法](#基本用法) - [设置空态](#设置空态) - [卡牌宽度](#卡牌宽度) - [固定每行展示数据个数](#固定每行展示数据个数) - [表单校验](#表单校验) - [部分选项不可选择](#部分选项不可选择) - [自定义placeholder](#自定义placeholder) - [自定义选择项](#自定义选择项) - [API]() - [Props/Attrs](#propsattrs) - [Slots](#slots) - [Events](#events) ## 示例 ### 基本用法 ``` vue ``` ### 设置空态 ``` vue ``` ### 卡牌宽度 ``` vue ``` ### 固定每行展示数据个数 ``` vue ``` ### 表单校验 由于checkbox card的value值是数组类型的，这里需要指定type=‘array’同时需要使用validator做判断 ``` vue ``` ### 部分选项不可选择 ``` vue ``` ### 自定义placeholder ``` vue ``` ### 自定义选择项 ``` vue ``` ## API ### Props/Attrs | Prop/Attr | Type | Options | Default | Description | | --------- | ---- | ------- | ------- | ----------- | | data | array | | `[]` | 可供选择的数据 | | value.sync, v-model | Array | | | 被选中数据 | | placeholder | string | | | 没有数据时的占位显示 | | size | enum | `'normal'` | `'normal'` | 卡片尺寸 | | column | number | | | 一行固定多少个选择项，如果不传则固定单项宽度为158px，每行个数自适应行宽 | | converter | string | `[object Object]`
`[object Object]`
`[object Object]`
`[object Object]` | `'join'` | value 与 values 的转换器。可选值：`'join'`表示将 values 数组 join 之后变成 value。也可以用`:`修改分隔符，类似 Vue 的指令参数。也可以传入一个包含 { get, set } 的一个对象 | ### Slots #### (default) 插入 HTML或 `Component`, 可展示额外内容。 #### placeholder 空数据占位显示内容 ### Events #### @input 输入时触发。 | Param | Type | Description | | ----- | ---- | ----------- | | $event | string | 输入框的值 | | senderVM | UInput | 发送事件实例 | #### @change 值变化时触发。（注意：与原生事件不同） | Param | Type | Description | | ----- | ---- | ----------- | | $event | object | 自定义事件对象 | | $event.value | string | 改变后的值 | | $event.oldValue | string | 旧的值 | | senderVM | UInput | 发送事件实例 |