Checkbox

复选框。v-model；label；indeterminate 半选（无 group 组件，由宿主组合）。

基础

接受条款

v-model：unchecked

禁用（已选）禁用（未选）

smmdlg

<script setup lang="ts">
import { ref } from 'vue'
import { HCheckbox } from 'happier-ui'

const on = ref(false)
</script>

<template>
  <h-checkbox v-model="on" label="接受条款" />
</template>

半选 / 全选

半选点击时 emit true；宿主负责清除 indeterminate。

全选（半选演示）

子项 A子项 B子项 C

API

Props

名称	类型	默认	说明
modelValue	boolean	false	是否选中
indeterminate	boolean	false	半选展示
label	string	—	文案
disabled	boolean	false	禁用
size	'sm' | 'md' | 'lg'	'md'	尺寸
ariaLabel	string	—	无 label 时的可访问名
name	string	—	表单 name

Emits

事件	载荷	说明
update:modelValue	boolean	选中变化；半选点击为 true

Slots

无。

无障碍

• 原生 checkbox
• 提供 label 或 ariaLabel
• 半选状态由 indeterminate 同步到原生属性