CKTIS / JavaScript
Estados ARIA de invalidade e ocultação e gestão do foco com tabindex
Comunique erros de validação, oculte conteúdo decorativo às tecnologias de apoio e desloque o foco sem adicionar uma paragem na navegação com a tecla Tab.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
HTML attributes: aria-invalid="true|false|grammar|spelling"; aria-hidden="true|false"; aria-errormessage="message-id"; hidden; tabindex="integer".
JavaScript DOM: control.setAttribute("aria-invalid", "true"); control.removeAttribute("aria-invalid"); message.hidden = false; message.tabIndex = -1; message.focus(); document.activeElement === message.aria-invalid comunica o resultado da validação às tecnologias de apoio; não valida o valor nem bloqueia a submissão. Use "true" quando detetar um erro, mas aguarde por uma tentativa de submissão antes de assinalar um campo obrigatório vazio. Após a correção, remova o atributo ou use "false", o valor predefinido. "grammar" e "spelling" assinalam erros gramaticais e ortográficos, respetivamente. Com "true", pode associar uma instrução de correção visível através de aria-errormessage, indicando o ID da mensagem.
aria-hidden="true" exclui um elemento e os seus descendentes da árvore de acessibilidade sem os ocultar visualmente nem os impedir de receber o foco. Use-o em conteúdo decorativo ou redundante, nunca num elemento que possa receber foco ou num dos seus antepassados. aria-hidden="false" não anula a ocultação de um antepassado. Para ocultar uma mensagem comum a todos os utilizadores, defina message.hidden = true; use false para a mostrar.
A propriedade DOM tabIndex corresponde ao atributo HTML tabindex. Sem o atributo, os controlos nativos mantêm o comportamento de foco predefinido. 0 inclui o elemento na sequência normal, geralmente pela ordem do documento. -1 permite usar focus(), mas normalmente exclui o elemento da navegação com Tab. Evite valores positivos: no mesmo âmbito de navegação do foco, colocam os elementos antes das paragens normais, por ordem numérica crescente. As definições do navegador e do sistema podem afetar a sequência.
Mostre o destino antes de chamar focus(). Se for ocultar um elemento que tem o foco, mova primeiro o foco para um local útil. No exemplo, noValidate evita a validação automática na submissão, mas validity.valueMissing continua a detetar o campo obrigatório vazio. São funcionalidades da plataforma web, não de ECMAScript. document.activeElement permite verificar o foco no DOM, não aquilo que um leitor de ecrã anuncia.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form validation and focus</title>
</head>
<body>
<script>
(() => {
const form = document.createElement('form');
form.noValidate = true;
const input = document.createElement('input');
input.required = true;
const label = document.createElement('label');
label.append('Name ', input);
const error = document.createElement('p');
error.id = 'ck-focus-name-error';
error.textContent = 'Enter your name.';
error.hidden = true;
error.tabIndex = -1;
const submit = document.createElement('button');
submit.type = 'submit';
const decoration = document.createElement('span');
decoration.textContent = ' →';
decoration.setAttribute('aria-hidden', 'true');
submit.append('Submit', decoration);
function clearError() {
input.removeAttribute('aria-invalid');
input.removeAttribute('aria-errormessage');
error.hidden = true;
}
input.addEventListener('input', () => {
if (!input.validity.valueMissing) clearError();
});
form.addEventListener('submit', (event) => {
event.preventDefault();
if (input.validity.valueMissing) {
error.hidden = false;
input.setAttribute('aria-invalid', 'true');
input.setAttribute('aria-errormessage', error.id);
error.focus();
} else {
clearError();
}
console.log(`aria-invalid=${input.getAttribute('aria-invalid')}; hidden=${error.hidden}; errorFocused=${document.activeElement === error}`);
});
form.append(error, label, ' ', submit);
document.body.append(form);
})();
</script>
</body>
</html>Resultado
aria-invalid=true; hidden=false; errorFocused=true aria-invalid=null; hidden=true; errorFocused=false
Guarde o exemplo como `example.html` e abra-o num navegador. Abra a consola de programador para ver as linhas registadas. Clique em `Submit` deixando `Name` vazio: a mensagem de erro aparece e recebe o foco. Na página, prima Tab, escreva `Ada` em `Name` e clique novamente em `Submit`. A mensagem desaparece assim que introduz um valor e o formulário não envia dados. A seta continua visível e não contribui para o nome acessível do botão.
Lições relacionadas
- JavaScript · Lição 23 · Intermédio · Versão: 3