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

CKTIS / HTML

aria-describedby — descrição complementar de um controlo

`aria-describedby` liga um elemento a uma explicação que complementa o seu nome acessível.

Versão: WAI-ARIA 1.2

Sintaxe

<input aria-describedby="hint limit">

Indica identificadores de elementos existentes separados por espaços. O texto desses elementos forma a descrição pela ordem das referências. Mantém curto e claro o nome do próprio controlo; a explicação pode indicar formato, limite ou sugestão.

Não substitui a etiqueta nem estabelece regras de validação. Uma estrutura de descrição complexa é reduzida a texto, pelo que não equivale a navegar num painel de ajuda interativo. A informação adicional deve continuar disponível visualmente.

O campo do exemplo tem a etiqueta nativa Project code e duas explicações. O teste da árvore de acessibilidade verifica um nome separado e a descrição combinada. Maximum 8 characters não impõe um limite de comprimento: essa regra deve ser implementada separadamente.

Exemplos

<!doctype html><meta charset="utf-8">
<label for="code">Project code</label><input id="code" aria-describedby="hint limit">
<p id="hint">Use letters.</p><p id="limit">Maximum 8 characters.</p>
<output id="result"></output>
<script>
const input = document.querySelector('#code');
input.focus();
document.querySelector('#result').textContent = 'label=' + input.labels[0].textContent + '; description=' + input.getAttribute('aria-describedby').split(' ').map(id => document.getElementById(id).textContent).join(' ');
</script>

Resultado

label=Project code; description=Use letters. Maximum 8 characters.

Verificaram-se a descrição calculada e o nome do campo, não apenas a presença de identificadores no HTML.

Fontes