# Checkbox チェックボックス
単独で使用するか、グループで使用します(LhCheckboxGroup)。グループ内では value がメンバーを識別し、group の disabled/size が子項目に適用されます。
チェックボックス
<template>
<div class="demo-col" style="gap: 18px">
<div class="demo-row" style="gap: 20px; flex-wrap: wrap">
<LhCheckbox v-model="single" label="単独チェック" name="agree" />
<LhCheckbox v-model="indeterminate" label="すべて選択" indeterminate />
<LhCheckbox v-model="disabledSingle" label="無効" disabled />
</div>
<div>
<LhCheckboxGroup v-model="picked" name="themes">
<LhCheckbox label="山水" value="shan" />
<LhCheckbox label="花鳥" value="hua" />
<LhCheckbox label="人物" value="ren" disabled />
</LhCheckboxGroup>
</div>
<div>
<LhCheckboxGroup v-model="picked" disabled>
<LhCheckbox label="山水" value="shan" />
<LhCheckbox label="花鳥" value="hua" />
</LhCheckboxGroup>
<p class="demo-note">グループ全体を disabled</p>
</div>
<div class="demo-row" style="gap: 20px; flex-wrap: wrap; align-items: center">
<LhCheckboxGroup v-model="picked" size="small">
<LhCheckbox label="山水" value="shan" />
</LhCheckboxGroup>
<LhCheckboxGroup v-model="picked" size="large">
<LhCheckbox label="山水" value="shan" />
</LhCheckboxGroup>
</div>
<p class="demo-note">グループの値:{{ JSON.stringify(picked) }}</p>
</div>
</template>
<script>
export default {
data: () => ({
single: true,
indeterminate: true,
disabledSingle: false,
picked: ['shan'],
}),
}
</script>
# Checkbox Props
| プロパティ | 説明 | 型 | デフォルト値 |
|---|---|---|---|
| v-model | 選択状態(model: modelValue/input) | boolean | false |
| value | グループ内メンバーの値 | unknown | — |
| label | テキスト(またはデフォルトスロット) | string | — |
| indeterminate | 不確定状態(ネイティブコントロールに作用) | boolean | false |
| disabled / size / name | — | — | — |
# CheckboxGroup Props
| プロパティ | 説明 | 型 | デフォルト値 |
|---|---|---|---|
| v-model | 選択値の配列 | unknown[] | [] |
| disabled / size / name | 子項目に適用 | — | — |
# Events
| イベント | 説明 | コールバックパラメータ |
|---|---|---|
| input | v-model のイベント | — |
| change | 選択状態が変化したときに発火 | (checked) |
group の同名イベントが子項目の変化を集約します。
Copyright © 2024-2026 FengMo WenXue