aria-roles-valid

El atributo role debe ser un rol ARIA válido y no abstracto

automaticWCAG 4.1.2 (A)confianza: highgravedad: seriousrobust

Comprueba que un atributo role="" explícito se resuelva en un rol WAI-ARIA real y no abstracto.

Ámbito de aplicación. Se aplica a cualquier elemento con un atributo role="" no vacío en el DOM compuesto.

Resultado esperado. Al menos un token de rol nombra un rol ARIA concreto y no abstracto. Se gradúa según a qué recurre el elemento cuando ninguno lo hace:

  • `fail` en un anfitrión sin rol (div, span, elemento personalizado), que queda expuesto como generic, de modo que el rol que el autor quiso no se expone a las tecnologías de asistencia afectadas.
  • `cantTell` cuando el elemento tiene un rol nativo (un <button>, <nav>, <a href>), que el árbol de accesibilidad sigue usando. ACT 674b10 enumera el 4.1.2 solo como un requisito secundario, "satisfecho mediante el rol implícito", por lo que el token incorrecto merece señalarse, pero no constituye en sí mismo el criterio que falla.

Ejemplos

pass
<div role="button">Click</div>

"button" es un rol ARIA real y concreto.

fail
<div role="buton"></div>

"buton" no es un token de rol ARIA definido (error tipográfico).

Ver código fuente