База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Състояния за невалидност и скриване в ARIA и управление на фокуса с tabindex

Обозначавайте грешки при проверка, скривайте украса от помощните технологии и премествайте фокуса, без да добавяте допълнителна позиция при навигация с Tab.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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 съобщава резултата от проверката на помощните технологии; не проверява стойността и не блокира изпращането. Задайте "true" при открита грешка, но за празно задължително поле изчакайте опит за изпращане. След поправка премахнете атрибута или задайте "false", стойността по подразбиране. "grammar" обозначава граматични, а "spelling" — правописни грешки. При "true" можете чрез aria-errormessage да свържете полето с видимо указание за поправка, като посочите идентификатора на съобщението.

aria-hidden="true" изключва елемента и потомците му от дървото на достъпността, без да ги скрива визуално или да им пречи да получат фокус. Използвайте го за декоративно или повтарящо се съдържание, но никога върху елемент, който може да получи фокус, или негов предшественик. aria-hidden="false" не отменя скриването от предшественик. За да скриете обикновено съобщение от всички, задайте message.hidden = true; използвайте false, за да го покажете.

Свойството tabIndex в DOM съответства на HTML атрибута tabindex. Без атрибута вградените контроли запазват стандартното си поведение при фокусиране. 0 включва елемента в обичайната последователност, най-често според реда в документа. -1 позволява извикване на focus(), но обикновено изключва елемента от навигацията с Tab. Избягвайте положителни стойности: в един и същ обхват на навигация с фокуса те подреждат елементите преди обичайните позиции във възходящ числов ред. Настройките на браузъра и системата могат да повлияят на реда.

Покажете целевия елемент, преди да извикате focus(). Ако скривате елемент с фокус, първо преместете фокуса на подходящо място. В примера noValidate пропуска автоматичната проверка при изпращане, но validity.valueMissing все още открива празното задължително поле. Това са възможности на уеб платформата, не на ECMAScript. document.activeElement проверява фокуса в DOM, а не какво ще съобщи екранният четец.

Примери

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

Резултат

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

Запазете примера като `example.html` и го отворете в браузър. Отворете конзолата за разработчици, за да видите изведените редове. Щракнете върху `Submit`, докато `Name` е празно: съобщението за грешка се появява и получава фокуса. На страницата натиснете Tab, въведете `Ada` в `Name` и щракнете отново върху `Submit`. Съобщението изчезва веднага след въвеждане на стойност, а формулярът не изпраща данни. Стрелката остава видима и не е част от достъпното име на бутона.

Свързани уроци

  • JavaScript · Урок 23 · Средно · Версия: 3

Източници