Skip to content

单独使用/组合使用说明

  • 单独使用:需给组件设置 alone 属性,并且使用 v-model 绑定选中状态。
  • 组合使用:需将组件放到 hi-checkbox-group 组件内,并给组件设置 value 属性。

基础使用 - 单独使用

vue
<hi-checkbox v-model="isChecked" alone label="选项"></hi-checkbox>

基础使用 - 组合使用

vue
<hi-checkbox-group v-model="values">
    <hi-checkbox v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></hi-checkbox>
</hi-checkbox-group>

禁用

通过给组件添加 disabled 属性来将组件禁用。

vue
<hi-checkbox v-model="isChecked" label="选项" alone disabled></hi-checkbox>

异步变更

通过给组件添加 async 属性来开启组件的异步变更特性,此时点击组件后,组件不会变更选中状态,而是提供一个 asyncChange 事件,需要用户处理完相关逻辑后手动变更组件状态。

vue
<hi-checkbox v-model="isChecked" label="选项" alone async @asyncChange="onCheckboxAsyncChange"></hi-checkbox>

Props

参数说明类型默认值可选值
hoverClass组件点击时的类名Stringhi-hover-
disabled是否禁用Booleanfalse-
v-model单独使用时组件的选中状态Booleanfalse-
value组合使用时组件的绑定值[String, Number]--
label组件的文本String--
alone是否单独使用组件Booleanfalse-
iconName图标名称String__checked-
async是否开启异步变更Booleanfalse-
checked是否选中Booleanfalse-

Events

事件名说明回调参数
@change单独使用并且未开启异步变更时选中状态变化时触发isChecked: 变更后的选中状态
@asyncChange单独使用并且开启异步后点击时触发isChecked: 当前的选中状态

Slots

名称说明
#default默认插槽(label 区域