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.