Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Stavy neplatnosti a skrytia v ARIA a riadenie fokusu pomocou tabindex

Oznamujte chyby validácie, skryte ozdoby pred asistenčnými technológiami a presúvajte fokus bez pridania ďalšej zastávky pri navigácii klávesom Tab.

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

Syntax

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 oznamuje výsledok validácie asistenčným technológiám; hodnotu samo nekontroluje ani neblokuje odoslanie. Pri zistenej chybe nastavte "true", ale pri prázdnom povinnom poli počkajte na pokus o odoslanie. Po oprave odstráňte atribút alebo nastavte predvolenú hodnotu "false". "grammar" označuje gramatické chyby a "spelling" pravopisné chyby. Pri hodnote "true" môžete pomocou aria-errormessage prepojiť pole s viditeľným návodom na opravu prostredníctvom ID správy.

aria-hidden="true" vyradí prvok a jeho potomkov zo stromu prístupnosti bez toho, aby ich vizuálne skrylo alebo im zabránilo získať fokus. Používajte ho na dekoratívny alebo nadbytočný obsah, nikdy na prvok, ktorý môže získať fokus, ani na jeho predka. aria-hidden="false" nezruší skrytie nastavené na predkovi. Bežnú správu skryjete pred všetkými pomocou message.hidden = true; hodnotou false ju zobrazíte.

Vlastnosť DOM tabIndex zodpovedá atribútu HTML tabindex. Bez atribútu si natívne ovládacie prvky zachovajú predvolené správanie fokusu. 0 zaradí prvok do bežnej postupnosti, spravidla podľa poradia v dokumente. -1 umožní použiť focus(), ale pri navigácii klávesom Tab sa prvok zvyčajne preskočí. Vyhnite sa kladným hodnotám: v rovnakom rozsahu navigácie fokusu umiestňujú prvky pred bežné zastávky vzostupne podľa hodnoty. Poradie môžu ovplyvniť nastavenia prehliadača a systému.

Zobrazte cieľ pred volaním focus(). Ak skrývate prvok, ktorý má fokus, najprv presuňte fokus na vhodné miesto. V príklade noValidate vypína automatickú validáciu pri odosielaní, ale validity.valueMissing stále odhalí prázdne povinné pole. Ide o funkcie webovej platformy, nie ECMAScriptu. document.activeElement overuje fokus v DOM, nie to, čo oznámi čítačka obrazovky.

Prí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ýsledok

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

Uložte príklad ako `example.html` a otvorte ho v prehliadači. Výstupné riadky uvidíte vo vývojárskej konzole. Kliknite na `Submit` s prázdnym poľom `Name`: zobrazí sa chybová správa a získa fokus. Na stránke stlačte Tab, do poľa `Name` napíšte `Ada` a znova kliknite na `Submit`. Správa zmizne hneď po zadaní hodnoty a formulár neodošle žiadne údaje. Šípka zostane viditeľná a nie je súčasťou prístupného názvu tlačidla.

Súvisiace lekcie

  • JavaScript · Lekcia 23 · Stredne pokročilá · Verzia: 3

Zdroje