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 | 定义默认内容 |