Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Stavy neplatnosti a skrytí v ARIA a řízení fokusu pomocí tabindex

Oznamujte chyby validace, skryjte dekorace před asistivními technologiemi a přesouvejte fokus bez přidání další zastávky při navigaci klávesou Tab.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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 předává výsledek validace asistivním technologiím; samo hodnotu nekontroluje ani nezabrání odeslání. Při zjištěné chybě nastavte "true", ale u prázdného povinného pole počkejte na pokus o odeslání. Po opravě atribut odstraňte nebo použijte výchozí hodnotu "false". "grammar" a "spelling" označují gramatické, respektive pravopisné chyby. Při hodnotě "true" lze pomocí aria-errormessage propojit pole s viditelným návodem k opravě podle ID zprávy.

aria-hidden="true" vyřadí prvek i jeho potomky ze stromu přístupnosti, ale vizuálně je neskryje ani jim nezabrání získat fokus. Používejte ho pro dekorativní nebo nadbytečný obsah, nikdy na prvku, který může získat fokus, ani na jeho předkovi. aria-hidden="false" nezruší skrytí nastavené na předkovi. Běžnou zprávu skryjete všem pomocí message.hidden = true; hodnotou false ji zobrazíte.

Vlastnost DOM tabIndex odpovídá atributu HTML tabindex. Bez atributu si nativní ovládací prvky zachovají výchozí chování fokusu. 0 zařadí prvek do běžné posloupnosti, obvykle podle pořadí v dokumentu. -1 dovoluje použít focus(), ale při navigaci klávesou Tab se prvek obvykle přeskočí. Vyhněte se kladným hodnotám: ve stejné oblasti navigace fokusu řadí prvky před běžné zastávky, vzestupně podle hodnoty. Pořadí může ovlivnit nastavení prohlížeče a systému.

Zobrazte cíl před voláním focus(). Pokud skrýváte prvek s fokusem, nejprve přesuňte fokus na vhodné místo. V ukázce noValidate vypne automatickou validaci při odeslání, ale validity.valueMissing stále odhalí prázdné povinné pole. Jde o funkce webové platformy, nikoli ECMAScriptu. document.activeElement ověří fokus v DOM, nikoli to, co oznámí čtečka obrazovky.

Příklady

<!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>

Výsledek

aria-invalid=true; hidden=false; errorFocused=true
aria-invalid=null; hidden=true; errorFocused=false

Uložte ukázku jako `example.html` a otevřete ji v prohlížeči. Výstupní řádky uvidíte ve vývojářské konzoli. Klikněte na `Submit` s prázdným polem `Name`: chybová zpráva se zobrazí a získá fokus. Na stránce stiskněte Tab, zadejte do pole `Name` hodnotu `Ada` a znovu klikněte na `Submit`. Zpráva zmizí hned po zadání hodnoty a formulář neodešle žádná data. Šipka zůstane viditelná a není součástí přístupného názvu tlačítka.

Související lekce

  • JavaScript · Lekce 23 · Středně pokročilá · Verze: 3

Zdroje