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

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

Fontes