Checkbox

BCheckbox es un checkbox nativo con su label, compatible con v-model booleano. Renderiza un <label> que envuelve el <input type="checkbox"> y el texto del label en <span class="label">.

---

Importación

import { BCheckbox } from '@bedrock/core/vue';

@use '@bedrock/core/checkbox';

---

Props

Prop	Tipo	Default	Descripción
modelValue	Boolean	false	Estado del checkbox. Vinculado con v-model.
disabled	Boolean	false	Deshabilita el checkbox y aplica data-disabled.
value	String	null	Valor HTML del input. Útil en grupos de checkboxes.
name	String	null	Nombre del campo para envío de formulario.
id	String	null	ID del input nativo. Necesario si se usa fuera de BField.

---

Slots

Slot	Descripción
default	Texto del label. Si está vacío, no se renderiza el <span class="label">.

---

Emits

Evento	Payload	Descripción
update:modelValue	Boolean	Emitido al cambiar el estado. Permite usar v-model.

---

Atributos de datos generados

Atributo	Cuándo aparece
data-disabled	Cuando disabled es true.

---

Estructura HTML generada

<label class="b-checkbox">
  <input type="checkbox" />
  <span class="label">Acepto los términos</span>
</label>

---

Ejemplos de uso

Básico con v-model

<BCheckbox v-model="aceptado">Acepto los términos y condiciones</BCheckbox>

Deshabilitado

<BCheckbox v-model="valor" :disabled="true">Opción no disponible</BCheckbox>

Grupo de checkboxes

<BCheckbox
  v-for="opcion in opciones"
  :key="opcion.value"
  v-model="seleccionados"
  :value="opcion.value"
  name="preferencias"
>
  {{ opcion.label }}
</BCheckbox>

Sin label visible

<BCheckbox v-model="activo" :id="'toggle-activo'" aria-label="Activar notificaciones" />

---

Estilos en el proyecto consumidor

@use 'bedrock-config' as *;
@use '@bedrock/core/checkbox';

.b-checkbox {
  display: inline-flex;
  align-items: center;
  gap: spacing(2);
  cursor: pointer;

  input[type='checkbox'] {
    width: spacing(4);
    height: spacing(4);
    accent-color: color(primary);
    cursor: pointer;
  }

  .label {
    @include typeset(label);
    color: color(text);
    user-select: none;
  }

  @include attr(disabled) {
    opacity: 0.5;
    cursor: not-allowed;

    input[type='checkbox'] { cursor: not-allowed; }
  }
}