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.