Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

États ARIA d’invalidité et de masquage, et gestion du focus avec tabindex

Signalez les erreurs de validation, masquez les éléments décoratifs aux technologies d’assistance et déplacez le focus sans ajouter d’arrêt dans l’ordre de tabulation.

Version : 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 communique le résultat de la validation aux technologies d’assistance : il ne valide pas la valeur et ne bloque pas l’envoi. Attribuez-lui "true" si une erreur est détectée, mais attendez une tentative d’envoi avant de signaler un champ obligatoire vide. Après correction, supprimez l’attribut ou donnez-lui sa valeur par défaut, "false". "grammar" et "spelling" signalent respectivement une faute de grammaire ou d’orthographe. Avec "true", aria-errormessage peut associer au champ une consigne de correction visible en référençant son identifiant.

aria-hidden="true" retire un élément et ses descendants de l’arbre d’accessibilité sans les masquer visuellement ni les empêcher de recevoir le focus. Réservez cet attribut aux contenus décoratifs ou redondants, jamais aux éléments pouvant recevoir le focus ni à leurs ancêtres. aria-hidden="false" n’annule pas le masquage d’un ancêtre. Pour masquer un message ordinaire à tout le monde, utilisez message.hidden = true ; utilisez false pour l’afficher.

La propriété DOM tabIndex correspond à l’attribut HTML tabindex. Sans cet attribut, les contrôles natifs conservent leur comportement de focus par défaut. 0 insère l’élément dans la séquence normale, généralement selon l’ordre du document. -1 permet focus(), mais écarte normalement l’élément de la navigation avec Tab. Évitez les valeurs positives : dans un même périmètre de navigation du focus, elles placent les éléments avant les arrêts habituels, par ordre numérique croissant. Les réglages du navigateur et du système peuvent modifier la séquence.

Affichez la cible avant d’appeler focus(). Avant de masquer un élément qui a le focus, déplacez celui-ci vers un endroit utile. Dans l’exemple, noValidate désactive la validation automatique à l’envoi, mais validity.valueMissing détecte toujours le champ obligatoire vide. Ces fonctionnalités relèvent de la plateforme web et non d’ECMAScript. document.activeElement vérifie le focus dans le DOM, pas ce qu’annonce un lecteur d’écran.

Exemples

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

Résultat

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

Enregistrez l’exemple sous le nom `example.html` et ouvrez-le dans un navigateur. Ouvrez la console de développement pour voir les lignes affichées. Cliquez sur `Submit` en laissant `Name` vide : le message d’erreur apparaît et reçoit le focus. Sur la page, appuyez sur Tab, saisissez `Ada` dans `Name` et cliquez de nouveau sur `Submit`. Le message disparaît dès la saisie d’une valeur et le formulaire n’envoie aucune donnée. La flèche reste visible et ne fait pas partie du nom accessible du bouton.

Leçons associées

  • JavaScript · Leçon 23 · Intermédiaire · Version : 3

Sources