Saltar al contenido
SilktideAyuda

---\ntitle: Rol ARIA no válido\ncheck: valid-role\nnavHidden: true\ncategory: Accesibilidad\nstandard: ARIA 1.2 / WCAG 2.0 A 4.1.2\ncreated: 2026-07-16T02:59:36Z\nupdated: 2026-08-23T19:10:16Z\n---\n\n# Rol ARIA no válido\n\nSilktide comprueba cada atributo role de tus páginas frente a la lista de roles que define el estándar ARIA. Un role mal escrito, inventado, vacío o reservado para uso interno es ignorado sin avisar por los navegadores, así que el significado previsto del elemento nunca llega a las personas que dependen de él.\n\nhtml\n<!-- Problema: \"buton\" no es un rol real, así que este div no tiene significado -->\n<div role=\"buton\" tabindex=\"0\">Guardar</div>\n\n<!-- Solución: usa un rol válido (o mejor, un elemento button real) -->\n<button>Guardar</button>\n\n\n## Por qué es importante\n\nUn role indica a las qué es un elemento: un botón, una pestaña, un diálogo. Cuando el role no es válido, los navegadores lo descartan: un usuario de oye texto plano donde el autor pretendía un control y puede no tener forma de saber siquiera que el elemento es interactivo. Como la página se ve y funciona con normalidad para los usuarios que ven y usan el ratón, estos errores pasan desapercibidos si no se hacen pruebas.\n\n## Cómo solucionarlo\n\n1. Corrige las erratas para que el role coincida con un rol ARIA real (lista completa) — por ejemplo, role=\"navigation\", no role=\"nav\".\n2. Sustituye los roles abstractos (widget, composite, landmark, section y similares) por un rol concreto: los roles abstractos existen solo para organizar la especificación y no deben usarse en las páginas.\n3. Elimina los atributos vacíos role=\"\".\n4. Cuando un elemento nativo de aporta el significado correcto (<button>, <nav>, <main>), dale preferencia y elimina por completo el atributo role.\n\n## Cómo lo comprueba Silktide\n\n1. Encuentra cada elemento de la página con un atributo role.\n2. Informa de los valores vacíos del atributo role.\n3. Comprueba cada palabra del valor de role frente a los roles definidos por ARIA 1.2. Se aceptan los roles de las extensiones de publicación digital (doc-) y de gráficos (graphics-).\n4. Informa de las palabras que no coinciden con ningún rol definido y de las que nombran un rol abstracto.\n\n## Solución de problemas\n\n### El atributo role tiene varias palabras\n\nEl atributo role puede enumerar varios roles como alternativas de respaldo; los navegadores usan el primero que reconocen. Silktide informa de cada palabra no válida o abstracta de la lista para que también puedas limpiar esas alternativas.\n\n### Esta comprobación no muestra nada aunque espero incidencias\n\nLas pruebas de ARIA pueden desactivarse por sitio web. Revisa la configuración avanzada del sitio web.\n\n## Más información\n\n- Rol ARIA en conflicto\n- Atributo ARIA obligatorio ausente\n- Roles WAI-ARIA (MDN)\n- WCAG 2.2: Comprender nombre, rol y valor\n

Última actualización

¿Le ha resultado útil esta página?

Invalid ARIA role | Ayuda de Silktide