CKTIS / HTML
role — el rol de accesibilidad de un elemento
El atributo `role` indica a las tecnologías de asistencia el rol semántico de un elemento. No añade apariencia ni comportamiento. Úsalo según las reglas de ARIA in HTML y da preferencia a los elementos que ya proporcionan la semántica nativa adecuada.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
role="role-name [fallback-role-name ...]"El atributo role comunica a las tecnologías de asistencia el tipo de un elemento, como un grupo o un botón. Se refiere a la semántica en el árbol de accesibilidad, no a la apariencia. No sustituye a un nombre accesible: en el ejemplo, group define el rol y aria-label proporciona el nombre Display options.
El valor puede contener nombres de rol separados por espacios en blanco. Para determinar el rol, el navegador utiliza el primer nombre reconocido que corresponde a un rol no abstracto. La lista proporciona roles alternativos, no varios roles simultáneos. El rol seleccionado de este modo no es necesariamente el que se expone en el árbol de accesibilidad. Por ejemplo, en un button que puede recibir el foco, el navegador debe ignorar none o presentation y exponer en su lugar el rol implícito de botón. Los roles abstractos no deben usarse en el contenido de una página.
Da preferencia a un elemento HTML nativo con la semántica adecuada. button ya tiene el rol de botón, por lo que repetirlo es redundante. Las sobrescrituras permitidas dependen del elemento y de las reglas de ARIA in HTML; no todos los roles son válidos en todas partes. Cumple también los requisitos del rol elegido sobre nombres, estados y estructura.
Añadir solo role="button" no incorpora gestión del teclado, capacidad de recibir el foco ni acciones. El ejemplo agrupa dos botones de opción nativos (<input type="radio">) sin sobrescribir sus roles. Al cambiar la opción seleccionada, el script modifica el tamaño de fuente del texto de muestra. output recoge lo que se registra en la consola: los valores declarados de role y aria-label y el texto visible del grupo. No es una inspección del árbol de accesibilidad.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named group of display options</title>
</head>
<body>
<div id="display-options" role="group" aria-label="Display options">
<label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
<label><input type="radio" name="zoom" value="large"> Large size</label>
</div>
<p id="sample">Sample text</p>
<script>
const group = document.getElementById('display-options');
const sample = document.getElementById('sample');
group.addEventListener('change', event => {
sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
});
console.log('Declared role: ' + group.getAttribute('role'));
console.log('ARIA label: ' + group.getAttribute('aria-label'));
console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
</script>
</body>
</html>Resultado
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
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.