Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Stanji neveljavnosti in skritosti v ARIA ter upravljanje fokusa s tabindex

Sporočite napake pri preverjanju, skrijte okrasno vsebino pred podpornimi tehnologijami in premaknite fokus brez dodatnega postanka pri krmarjenju s tipko Tab.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 sporoči rezultat preverjanja podpornim tehnologijam; sam ne preveri vrednosti in ne prepreči oddaje. Ob zaznani napaki nastavite "true", vendar pri praznem obveznem polju počakajte na poskus oddaje. Po popravku odstranite atribut ali nastavite privzeto vrednost "false". "grammar" označuje slovnične, "spelling" pa pravopisne napake. Pri "true" lahko z aria-errormessage povežete polje z vidnim navodilom za popravek tako, da navedete ID sporočila.

aria-hidden="true" izloči element in njegove potomce iz drevesa dostopnosti, vendar jih ne skrije vizualno in jim ne prepreči prejemanja fokusa. Uporabite ga za okrasno ali podvojeno vsebino, nikoli na elementu, ki lahko prejme fokus, ali na njegovem predniku. aria-hidden="false" ne razveljavi skritosti prednika. Običajno sporočilo skrijete pred vsemi z message.hidden = true; s false ga prikažete.

Lastnost DOM tabIndex ustreza atributu HTML tabindex. Brez atributa vgrajeni kontrolniki ohranijo privzeto vedenje fokusa. 0 vključi element v običajno zaporedje, navadno po vrstnem redu v dokumentu. -1 omogoča klic focus(), vendar se element pri krmarjenju s tipko Tab praviloma preskoči. Izogibajte se pozitivnim vrednostim: znotraj istega območja krmarjenja s fokusom uvrstijo elemente pred običajne postanke po naraščajoči številski vrednosti. Na zaporedje lahko vplivajo nastavitve brskalnika in sistema.

Cilj prikažite pred klicem focus(). Če skrivate element, ki ima fokus, ga najprej premaknite na smiselno mesto. V primeru noValidate ob oddaji preskoči samodejno preverjanje, vendar validity.valueMissing še vedno zazna prazno obvezno polje. To so funkcije spletne platforme, ne ECMAScripta. document.activeElement preverja fokus v DOM, ne pa tega, kaj bo sporočil bralnik zaslona.

Primeri

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

Rezultat

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

Primer shranite kot `example.html` in ga odprite v brskalniku. Izpisane vrstice si oglejte v konzoli za razvijalce. Kliknite `Submit`, ko je polje `Name` prazno: sporočilo o napaki se prikaže in prejme fokus. Na strani pritisnite Tab, v `Name` vnesite `Ada` in znova kliknite `Submit`. Sporočilo izgine takoj po vnosu vrednosti, obrazec pa ne pošlje podatkov. Puščica ostane vidna in ni del dostopnega imena gumba.

Povezane lekcije

  • JavaScript · Lekcija 23 · Srednja · Različica: 3

Viri