Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

aria-checked — estado marcado de un control

`aria-checked` describe el estado marcado de un control con un rol apropiado; no implementa el comportamiento de una casilla.

Versión: WAI-ARIA 1.2

Sintaxis

<button role="checkbox" aria-checked="mixed">All topics</button>

Para una casilla usa las cadenas true, false o mixed. La ausencia del estado significa indefinido, no desmarcado; el rol checkbox exige un estado explícito. El estado mixto corresponde a un grupo parcialmente marcado; los roles radio y switch no lo admiten. No es un atributo booleano HTML activado por su presencia.

Prefiere primero una casilla nativa. Un control personalizado necesita teclado, foco, etiqueta y apariencia coherente con su estado. Cambiar ARIA por sí solo no marca los campos asociados.

El ejemplo usa un botón nativo con semántica de casilla para controlar un grupo. Al principio hay un tema marcado; activarlo marca ambos y actualiza el estado a verdadero. La prueba verifica los campos reales y el estado del árbol de accesibilidad, no una frase concreta de un lector de pantalla.

Ejemplos

<!doctype html><meta charset="utf-8">
<button id="all" role="checkbox" aria-checked="mixed">All topics</button>
<label><input class="topic" type="checkbox" checked> HTML</label>
<label><input class="topic" type="checkbox"> CSS</label>
<output id="result"></output>
<script>
const all = document.querySelector('#all');
const topics = [...document.querySelectorAll('.topic')];
function sync() {
  const n = topics.filter(input => input.checked).length;
  all.setAttribute('aria-checked', n === 0 ? 'false' : n === topics.length ? 'true' : 'mixed');
}
topics.forEach(input => input.addEventListener('change', sync));
all.addEventListener('click', () => {
  const checked = all.getAttribute('aria-checked') !== 'true';
  topics.forEach(input => { input.checked = checked; }); sync();
});
all.click();
document.querySelector('#result').textContent = 'selected=' + topics.filter(x => x.checked).length + '; checked=' + all.getAttribute('aria-checked');
</script>

Resultado

selected=2; checked=true

El resultado muestra dos temas marcados y el estado true. El comportamiento lo aporta el manejador del clic, no ARIA por sí solo.

Fuentes