Skip to content

FaCheckbox 复选框

单个复选框组件,支持普通选中、禁用和半选状态。

使用场景

  • 表单中的同意协议选项
  • 单个布尔开关配置
  • 树形结构中的半选状态展示
  • 单项功能启用/禁用

Props

属性类型默认值说明
idstring自动生成复选框 id
disabledbooleanfalse是否禁用
classHTMLAttributes['class']-外层容器类名
itemClassHTMLAttributes['class']-复选框本体类名
labelClassHTMLAttributes['class']-标签内容类名

Slots

名称说明
default复选框标签内容

Events

事件名说明回调参数
change选中值变化时触发value: boolean | 'indeterminate' | undefined

通过 v-model 实现双向绑定。

注意事项

  1. 单个使用FaCheckbox 只负责单个复选框,不承担组选项逻辑。
  2. v-model 类型:支持 boolean'indeterminate' 两种状态值。
  3. 标签点击:点击标签文字也能触发复选框状态切换。
  4. 空标签隐藏:当不提供默认插槽内容时,标签元素会自动隐藏。
  5. 禁用状态:禁用状态下复选框和标签都无法点击。