Skip to content
目录

Checkbox 复选框

对一组内容进行多选。

基础用法

通过 v-model 绑定选中状态,vi-checkboxlabel 内容可以当作标签体内容,如果您的标签体内容与 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选中时的内容booleanfalsefalse
disabled是否为禁用状态booleanfaslefalse
border是否需要边框booleanfalsefalse

CheckboxGroup 属性

属性名说明类型默认值是必需项
v-model绑定值string——true
gap间距string'18px'false
min限制最少选中number0false
max限制最多选中numberInfinityfalse
is-button是否为按钮类型booleanfalsefalse
border是否需要边框booleanfalsefalse

插槽

插槽名说明
default定义默认内容

Powered by ❤️ L1en