Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Stanja nevaljanosti i skrivenosti u ARIA-i te upravljanje fokusom uz tabindex

Prijavite pogreške pri provjeri, sakrijte ukrasni sadržaj od asistivnih tehnologija i premjestite fokus bez dodavanja nove postaje pri kretanju tipkom Tab.

Verzija: 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 prenosi rezultat provjere asistivnim tehnologijama; ne provjerava vrijednost i ne sprječava slanje. Postavite ga na "true" kad otkrijete pogrešku, ali za prazno obavezno polje pričekajte pokušaj slanja. Nakon ispravka uklonite atribut ili postavite zadanu vrijednost "false". "grammar" označava gramatičke, a "spelling" pravopisne pogreške. Uz "true" možete pomoću aria-errormessage povezati polje s vidljivom uputom za ispravak tako da navedete ID poruke.

aria-hidden="true" isključuje element i njegove potomke iz stabla pristupačnosti, ali ih ne skriva vizualno niti im onemogućuje primanje fokusa. Upotrebljavajte ga na ukrasnom ili suvišnom sadržaju, nikad na elementu koji može primiti fokus ni na njegovu pretku. aria-hidden="false" ne poništava skrivenost pretka. Običnu poruku sakrijte od svih pomoću message.hidden = true; vrijednošću false poruku ponovno prikažite.

Svojstvo DOM-a tabIndex odgovara atributu HTML-a tabindex. Bez atributa izvorne kontrole zadržavaju zadano ponašanje fokusa. 0 uključuje element u redovni slijed, obično prema redoslijedu u dokumentu. -1 omogućuje poziv focus(), ali element se uglavnom preskače pri kretanju tipkom Tab. Izbjegavajte pozitivne vrijednosti: unutar istog područja navigacije fokusom smještaju elemente prije redovnih postaja, uzlaznim brojčanim redoslijedom. Postavke preglednika i sustava mogu utjecati na slijed.

Prikažite ciljni element prije poziva focus(). Ako skrivate element koji ima fokus, najprije premjestite fokus na prikladno mjesto. U primjeru noValidate preskače automatsku provjeru pri slanju, ali validity.valueMissing i dalje prepoznaje prazno obavezno polje. To su značajke web-platforme, a ne ECMAScripta. document.activeElement provjerava fokus u DOM-u, a ne ono što će čitač zaslona najaviti.

Primjeri

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

Spremite primjer kao `example.html` i otvorite ga u pregledniku. Ispisane retke pogledajte u razvojnoj konzoli. Kliknite `Submit` dok je polje `Name` prazno: pojavit će se poruka o pogrešci i primiti fokus. Na stranici pritisnite Tab, upišite `Ada` u `Name` i ponovno kliknite `Submit`. Poruka nestaje čim unesete vrijednost, a obrazac ne šalje podatke. Strelica ostaje vidljiva i nije dio pristupačnog naziva gumba.

Povezane lekcije

  • JavaScript · Lekcija 23 · Srednje · Verzija: 3

Izvori