Skip to content
On this page

基本使用

通过 v-model 进行双向绑定,通过 label 指定显示内容,也可以通过默认插槽进行自定义

html
<uv-checkbox v-model="test1" label="数据1"/>

自定义形状

通过 shape 设置,可选值为 squareround

html
<uv-checkbox
 v-model="test2"
 label="test2"
 shape="square"
/>

禁用状态

通过 disabled 设置

html
<uv-checkbox
 v-model="test2"
 disabled
 label="单选框"
/>

自定义选中背景色

通过 checkedColor 设置

html
<uv-checkbox
 v-model="test2"
 checked-color="red"
>
 单选框
</uv-checkbox>

文本位置

通过 labelPosition 设置,可选值为 leftright,默认 right

html
<uv-checkbox
 v-model="test2"
 label="单选框"
 shape="square"
 label-position="left"
/>

是否两边排布

通过 spaceBetween 开启

html
<uv-checkbox
 v-model="test3"
 label="单选框"
 space-between
 label-position="left"
/>

多选组

通过 uv-checkbox-group 组件包裹,通过 v-model 绑定数组类型数据

html
<uv-checkbox-group v-model="checkArr">
 <uv-checkbox
   label="test1"
 />
 <uv-checkbox
   label="test2"
 />
 <uv-checkbox
   label="test3"
 />
 <uv-checkbox
   label="test4"
 />
 <uv-checkbox
   label="test41"
 />
 <uv-checkbox
   label="test42"
 />
 <uv-checkbox
   label="test43"
 />
</uv-checkbox-group>

限制最大选择数量

通过 max 属性设置

html
<uv-checkbox-group v-model="checkArr1" :max="2">
  <uv-checkbox
    label="test1"
  />
  <uv-checkbox
    label="test2"
  />
  <uv-checkbox
    label="test3"
  />
  <uv-checkbox
    label="test4"
  />
</uv-checkbox-group>

checkbox props

属性含义类型默认值
modelValue双向绑定的值Booleanfalse
shape选项形状,可选'round','square'String'round'
label标签名String-
disabled是否禁用Booleanfalse
checkedColor选择的颜色String-
labelPosition标签名位置,可选'left','right'String'right'
spaceBetween是否两边排布Booleanfalse

checkbox-group props

属性含义类型默认值
modelValue双向绑定的值Array[]
max最大选中个数Number-
direction排布规则,可选'column'纵向,'row'横向String'row'
iconSize图标大小[Number, String]18
checkedColor选中的背景颜色String'#1989fa'
shape选项形状,可选'round','square'String'round'

checkbox events

事件名称含义参数
change选项改变时当前的值

checkbox-group events

事件名称含义参数
change选项改变时当前选择的数组

checkbox css变量

css
--uv-check-box-icon-border: 1px solid #c8c9cc;
    --uv-check-box-icon-active-border: 1px solid #1989fa;
    --uv-check-box-icon-active-bg-color: #1989fa;
    --uv-check-box-icon-disabled-border: 1px solid #c8c9cc;
    --uv-check-box-icon-disabled-bg-color: #ebedf0;
    --uv-check-box-text-margin: 8px;
    --uv-check-box-text-size: 14px;
    --uv-check-box-space-between-padding: 0 10px;

checkbox-group css变量

css
--uv-checkbox-group-gap: 10px;

Released under the MIT License.