CKTIS / HTML
aria-disabled — estado deshabilitado de un control
aria-disabled informa a las tecnologías de asistencia de que un elemento es perceptible, pero no está disponible para su uso. El atributo por sí solo no impide acciones ni elimina el elemento del orden de foco; el autor debe implementar ese comportamiento.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
aria-disabled="true" | aria-disabled="false"aria-disabled="true" identifica un elemento como deshabilitado, pero todavía perceptible. aria-disabled="false" es el valor predeterminado de este estado; sin embargo, no anula el disabled nativo. No es un atributo booleano de HTML: especifica explícitamente "true" o "false" en lugar de confiar en la mera presencia del atributo.
A diferencia de disabled nativo, aria-disabled por sí solo no impide la activación, no cambia el orden de foco ni proporciona un estilo de deshabilitado. Es preferible usar disabled nativo cuando cumpla los requisitos. Si un botón no disponible debe seguir siendo accesible con Tab, usar aria-disabled también exige impedir su acción mediante un script e indicar visualmente su estado.
El estado se aplica al elemento y a todos sus descendientes que puedan recibir el foco, así que no lo apliques indiscriminadamente a contenedores. Úsalo solo cuando lo permitan las reglas de HTML y el rol del elemento. ARIA 1.2 declara obsoleto su uso como estado global, no el atributo en sí.
En el ejemplo, el botón nativo conserva la compatibilidad con el teclado, pero el controlador click compartido termina antes de realizar la acción. CSS solo indica que no está disponible; no lo impide.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-disabled demo</title>
<style>
button[aria-disabled="true"] { opacity: 0.6; }
</style>
<button type="button" id="save" aria-disabled="true">Save (unavailable)</button>
<p id="result">Actions: 0</p>
<script>
const save = document.getElementById('save');
const result = document.getElementById('result');
let actions = 0;
save.addEventListener('click', () => {
if (save.getAttribute('aria-disabled') === 'true') return;
actions += 1;
result.textContent = `Actions: ${actions}`;
});
save.click();
console.log(result.textContent);
</script>
</html>Resultado
Actions: 0
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.