Les attributs de régions dynamiques ont pour objectifs d'indiquer les changements de contenus dans une page (quel que soit l'emplacement du focus) et de fournir aux technologies d'assistance (comme les lecteurs d'écran) des informations sur la façon de traiter et signaler ces mises à jour de contenus.

Liste des attributs

aria-live

Cet attribut permet de signaler que le contenu d'un élément sera mis à jour. Les valeurs possibles sont des degrés de politesse qui définissent les moments pendant lesquels les annonces de mises à jour peuvent être faites :

  • aria-live="off"
    Valeur par défaut, la zone ne sera pas mise à jour.
  • aria-live="polite"
    Notification polie : lorsque la zone est mise à jour, l'utilisateur n'est pas interrompu s'il est en train de faire quelque chose.
  • aria-live="assertive"
    Notification autoritaire : l'utilisateur doit être averti le plus tôt possible de la mise à jour.

Retour à la liste

aria-atomic

Cet attribut permet aux technologies d’assistance de savoir si elle doivent décrire à l’utilisateur la zone entière ou seulement la partie mise à jour.

  • aria-atomic="false" (par défaut)
    Les technologies d'assistance ne restituent à l'utilisateur que la partie mise à jour dans la zone identifiée par aria-live.
  • aria-atomic="true"
    Les technologies d'assistance restituent l'ensemble du contenu de la zone identifiée par aria-live, même si seulement une portion est mise à jour.

Retour à la liste

aria-busy

Cet attribut permet de signaler aux technologies d'assistance qu'un contenu est train d'être mis à jour mais qu'il ne doit pas être signalé à l'utilisateur immédiatement.

  • aria-busy="false" (par défaut)
    Les technologies d'assistance peuvent restituer à l'utilisateur le contenu mis à jour.
  • aria-busy="true"
    Les technologies d'assistance doivent attendre que l'attribut passe à false avant de signaler à l'utilisateur le contenu mis à jour.

Retour à la liste

aria-relevant

Cet attribut permet de préciser les types de changements qui doivent être signalés à l'utilisateur par les technologies d'assistance. Plusieurs propriétés peuvent être utilisées :

  • aria-relevant="additions"
    Les ajouts de nœuds au DOM sont signalés.
  • aria-relevant="removals"
    Les suppression de nœuds au DOM sont signalées.
  • aria-relevant="text"
    Les modifications de texte du DOM sont signalées (avec additions seul le nouveau texte est signalé, avec removals l'ancien texte est également mentionné).
  • aria-relevant="all"
    Toutes les modifications sur les nœuds ou textes du DOM sont signalées.

L'attribut aria-relevant peut recevoir plusieurs propriétés, par défaut lorsqu'il n'est pas renseigné l'option suivante est activée : aria-relevant="additions text" (l'ajout de nœuds et les textes modifiés sont signalés, mais pas la suppression de nœuds).