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

CKTIS / HTML

aria-label — nombre accesible mediante texto

`aria-label` asigna un nombre accesible a un elemento cuyo rol permite que el autor proporcione ese nombre.

Versión: WAI-ARIA 1.2

Sintaxis

<button aria-label="Close notice">×</button>

Proporciona un nombre de acción breve y localizado, como Close notice para un botón de cierre. El atributo no asigna un rol a cualquier elemento. Si puedes usar texto visible o una etiqueta nativa, normalmente es preferible.

El nombre puede sustituir al texto del contenido. Incluye la etiqueta visible para que el control por voz coincida con la pantalla. Un aria-labelledby válido tiene prioridad. No es una ayuda emergente, una instrucción de uso ni un manejador de eventos.

El botón con icono del ejemplo se llama Close notice y su símbolo decorativo queda excluido de la accesibilidad. Una función independiente oculta el aviso al activarlo. La prueba confirma el nombre calculado y el cierre; traduce la etiqueta junto con la interfaz.

Ejemplos

<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>

Resultado

noticeHidden=true

Se verificaron el nombre y la acción del botón; ARIA por sí solo no cierra el aviso.

Fuentes