Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes