Checkbox 复选框
对一组内容进行多选。
基础用法
通过 v-model 绑定选中状态,vi-checkbox 的 label 内容可以当作标签体内容,如果您的标签体内容与 label 内容一致的话,可以省略标签体。
请选择你的武器
禁用状态
通过 disabled 属性,禁用 checkbox。
请选择你的武器
带边框
通过 border 属性,启用边框。
请选择你的武器
Ckeckbox 组
如需使用 Ckeckbox 组,请使用 vi-checkbox-group 标签包裹。它提供 gap 属性来定义间距。
TIP
强烈建议您使用 vi-radio-group,因为它可以更好的组织结构。
使用了 vi-checkbox-group后,可直接将 v-model 绑定在 vi-checkbox-group 上,无需绑定给每个 vi-checkbox。
请选择你的武器
按钮类型
如需使用按钮类型,请使用 vi-checkbox-group 标签包裹并添加 is-button 属性。因为 Violet 需要使用此标签做特殊处理,,而 is-button 属性则表示使用按钮类型。
WARNING
注意:如果使用了按钮类型,border 属性将无效,因为按钮类型自带边框,您无需它。
DANGER
警告:在单独使用 vi-checkbox 时(没有被 vi-checkbox-group 包裹的情况下),请勿单独在 vi-checkbox 上添加 is-btn 属性,否则会导致 UI 错乱!
请选择你的武器
限制选中数量
如需限制选中数量,请使用 vi-checkbox-group 包裹。使用 min 属性来限制最少选中,max 属性来限制最多选中。
请选择你的武器
APIs
Checkbox 属性
| 属性名 | 说明 | 类型 | 默认值 | 是必需项 |
|---|---|---|---|---|
v-model | 绑定值 | string | —— | true |
| label | 选中时的内容 | boolean | false | false |
| disabled | 是否为禁用状态 | boolean | fasle | false |
| border | 是否需要边框 | boolean | false | false |
CheckboxGroup 属性
| 属性名 | 说明 | 类型 | 默认值 | 是必需项 |
|---|---|---|---|---|
v-model | 绑定值 | string | —— | true |
| gap | 间距 | string | '18px' | false |
| min | 限制最少选中 | number | 0 | false |
| max | 限制最多选中 | number | Infinity | false |
| is-button | 是否为按钮类型 | boolean | false | false |
| border | 是否需要边框 | boolean | false | false |
插槽
| 插槽名 | 说明 |
|---|---|
| default | 定义默认内容 |