L'attributaria-busy est un état ARIA global qui indique si un élément est en cours de modification.Il aide les technologies d'assistance à comprendre que les changements apportés au contenu ne sont pas encore terminés, et qu'elles doivent attendre avant d'informer l'utilisateur·ice de la mise à jour.Siaria-busy est couramment utilisé dans lesrégions ARIA dynamiques pour retarder les annonces jusqu'à la fin des mises à jour, il peut aussi être utilisé en dehors de ces régions : par exemple, dans des widgets ou des fils d'actualités, pour signaler des modifications en cours ou un chargement.

Lorsque plusieurs parties d'une région dynamique doivent être chargées avant d'annoncer les changements à l'utilisateur·ice, définissezaria-busy="true" jusqu'à la fin du chargement, puis passez àaria-busy="false". Cela empêche les technologies d'assistance d'annoncer les changements avant que les mises à jour ne soient terminées.

Description

Il existe une section de contenu qui se met à jour. Ces mises à jour sont importantes et vous souhaitez informer l'utilisateur·ice lorsqu'elle a été modifiée, vous l'avez donc transformée enrégion ARIA dynamique avec l'attributaria-live. Vous pouvez vouloir mettre à jour plusieurs composants de cette section en même temps, mais il est possible que tout ne se mette pas à jour simultanément. Même s'il s'agit d'une région dynamique très importante avecaria-live="assertive", vous ne souhaitez pas interrompre l'utilisateur·ice plusieurs fois à mesure que différentes parties du contenu se chargent. C'est là quearia-busy est utile.

La propriétéaria-busy est une propriété optionnelle des régions dynamiques qui peut prendre la valeurtrue oufalse. L'attributaria-busy avec la valeurtrue peut être ajouté à un élément en cours de modification, pour informer la technologie d'assistance qu'elle doit attendre la fin des modifications avant d'exposer le contenu à l'utilisateur·ice. Utilisez la propriétéariaBusy de l'objet pour passer la valeur àfalse une fois le téléchargement terminé.

ariaLiveElement.ariaBusy = "false";

La valeur dearia-live détermine si les changements sont annoncés immédiatement lors du passage àfalse, ou si la technologie d'assistance attend la fin de la tâche en cours avant d'interrompre l'utilisateur·ice.

Dans unfeed

Si un élément avec le rôlefeed aaria-busy àtrue, les changements de rendu à l'intérieur du fil ne seront pas annoncés, sauf s'ils sont initiés par l'utilisateur·ice.

Dans un widget

Si les modifications d'un widget affiché créent un état où le widget manque d'éléments enfants requis pendant l'exécution du script, définissezaria-busy àtrue sur le widget pendant le processus de mise à jour. Par exemple, si une arborescence affichée met à jour plusieurs branches qui ne sont pas nécessairement rendues simultanément, une alternative au remplacement de tout l'arbre en une seule mise à jour consiste à marquer l'arbre comme occupé pendant la modification de chaque branche.

Valeurs

false (valeur par défaut) :

Aucun changement n'est attendu pour l'élément.

true

L'élément est en cours de modification.

Interfaces associées

Element.ariaBusy

La propriétéariaBusy, qui fait partie de l'interface de chaque élément, reflète la valeur de l'attributaria-busy et indique si un élément est en cours de modification.

<div   role="timer"  aria-live="polite"  aria-atomic="true"  aria-busy="false"></div>

const el = document.getElementById("clock");console.log(el.ariaBusy); // falseel.ariaBusy = "true";console.log(el.ariaBusy); // true

Rôles associés

Utilisé dansTOUS les rôles

Spécifications

Voir aussi

• Régions ARIA dynamiques
• L'attribut ARIAaria-live
• L'attribut ARIAaria-relevant
• L'attribut ARIAaria-atomic