CKTIS / HTML
aria-label — nome acessível em texto
`aria-label` atribui um nome acessível a um elemento cujo papel permita que o autor forneça esse nome.
Versão: WAI-ARIA 1.2
Sintaxe
<button aria-label="Close notice">×</button>Fornece um nome de ação breve e localizado, como Close notice para um botão de fechar. O atributo não atribui um papel a elementos arbitrários. Quando é possível usar texto visível ou uma etiqueta nativa, essa opção é normalmente preferível.
O nome pode substituir o texto do conteúdo. Inclui a etiqueta visível para que o controlo por voz corresponda ao ecrã. Um aria-labelledby válido tem prioridade. Não é uma dica, uma instrução de funcionamento nem tratamento de eventos.
O botão com ícone do exemplo tem o nome Close notice, enquanto o sinal decorativo fica excluído da acessibilidade. Uma função separada oculta o aviso ao ativar. O teste confirma o nome calculado e o fecho; traduz a etiqueta juntamente com a interface.
Exemplos
<!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
Verificaram-se o nome e a ação do botão; ARIA por si só não fecha o aviso.