Checkbox 是对标准复选框元素的扩展，具有主题功能。
import Checkbox from 'primevue/checkbox';
import CheckboxGroup from 'primevue/checkboxgroup';
二进制复选框与 v-model 一起使用进行双向值绑定，并使用 binary 属性。
<Checkbox v-model="checked" binary />
多个复选框可以组合在一起。
<div class="card flex flex-wrap justify-center gap-4">
<div class="flex items-center gap-2">
<Checkbox v-model="pizza" inputId="ingredient1" name="pizza" value="Cheese" />
<label for="ingredient1"> Cheese </label>
</div>
<div class="flex items-center gap-2">
<Checkbox v-model="pizza" inputId="ingredient2" name="pizza" value="Mushroom" />
<label for="ingredient2"> Mushroom </label>
</div>
<div class="flex items-center gap-2">
<Checkbox v-model="pizza" inputId="ingredient3" name="pizza" value="Pepper" />
<label for="ingredient3"> Pepper </label>
</div>
<div class="flex items-center gap-2">
<Checkbox v-model="pizza" inputId="ingredient4" name="pizza" value="Onion" />
<label for="ingredient4"> Onion </label>
</div>
</div>
Checkbox 与 PrimeVue Forms 库无缝集成。
<Form v-slot="$form" :resolver="resolver" :initialValues="initialValues" @submit="onFormSubmit" class="flex justify-center flex-col gap-4">
<div class="flex flex-col gap-2">
<CheckboxGroup name="ingredient" class="flex flex-wrap gap-4">
<div class="flex items-center gap-2">
<Checkbox inputId="cheese" value="Cheese" />
<label for="cheese"> Cheese </label>
</div>
<div class="flex items-center gap-2">
<Checkbox inputId="mushroom" value="Mushroom" />
<label for="mushroom"> Mushroom </label>
</div>
<div class="flex items-center gap-2">
<Checkbox inputId="pepper" value="Pepper" />
<label for="pepper"> Pepper </label>
</div>
<div class="flex items-center gap-2">
<Checkbox inputId="onion" value="Onion" />
<label for="onion"> Onion </label>
</div>
</CheckboxGroup>
<Message v-if="$form.ingredient?.invalid" severity="error" size="small" variant="simple">{{ $form.ingredient.error?.message }}</Message>
</div>
<Button type="submit" severity="secondary" label="Submit" />
</Form>
可以使用值列表生成复选框。
<div v-for="category of categories" :key="category.key" class="flex items-center gap-2">
<Checkbox v-model="selectedCategories" :inputId="category.key" name="category" :value="category.name" />
<label :for="category.key">{{ category.name }}</label>
</div>
当存在 indeterminate 时，复选框会在视觉上掩盖实际值。
<Checkbox v-model="checked" indeterminate binary />
将 variant 属性指定为 filled，以显示比默认 outlined 样式具有更高视觉强调的组件。
<Checkbox v-model="checked" binary variant="filled" />
Checkbox 提供 small 和 large 尺寸作为基础尺寸的替代选择。
<div class="card flex flex-wrap justify-center gap-4">
<div class="flex items-center gap-2">
<Checkbox v-model="size" inputId="size_small" name="size" value="Small" size="small" />
<label for="size_small" class="text-sm">Small</label>
</div>
<div class="flex items-center gap-2">
<Checkbox v-model="size" inputId="size_normal" name="size" value="Normal" />
<label for="size_normal">Normal</label>
</div>
<div class="flex items-center gap-2">
<Checkbox v-model="size" inputId="size_large" name="size" value="Large" size="large" />
<label for="size_large" class="text-lg">Large</label>
</div>
</div>
使用 invalid 属性显示无效状态以指示验证失败。在与表单验证库集成时可以使用此样式。
<Checkbox v-model="checked" :invalid="!checked" binary />
当存在 disabled 时，元素无法编辑和获得焦点。
<Checkbox v-model="checked1" binary disabled />
<Checkbox v-model="checked2" binary disabled />
Checkbox 组件内部使用隐藏的原生复选框元素，仅对屏幕阅读器可见。描述组件的值可以通过 label 标签结合 inputId 属性提供，或使用 aria-labelledby、aria-label 属性。
<label for="chkbox1">Remember Me</label>
<Checkbox inputId="chkbox1" />
<span id="chkbox2">Remember Me</span>
<Checkbox aria-labelledby="chkbox2" />
<Checkbox aria-label="Remember Me" />
| 按键 | 功能 |
|---|---|
| tab | 将焦点移动到复选框。 |
| space | 切换选中状态。 |