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

CKTIS / HTML

role — le rôle d’accessibilité d’un élément

L’attribut `role` indique le rôle sémantique d’un élément aux technologies d’assistance. Il n’ajoute ni apparence ni comportement. Utilisez-le conformément aux règles ARIA in HTML et privilégiez les éléments qui fournissent déjà la sémantique native appropriée.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

role="role-name [fallback-role-name ...]"

L’attribut role indique aux technologies d’assistance le type d’un élément, par exemple un groupe ou un bouton. Il concerne la sémantique dans l’arbre d’accessibilité, et non l’apparence. Il ne remplace pas un nom accessible : dans l’exemple, group fournit le rôle et aria-label fournit le nom Display options.

La valeur peut contenir des noms de rôles séparés par des caractères d’espacement. Pour déterminer le rôle, le navigateur utilise le premier nom reconnu qui correspond à un rôle non abstrait. La liste fournit des rôles de repli, et non plusieurs rôles simultanés. Le rôle ainsi sélectionné n’est pas nécessairement celui qui est exposé dans l’arbre d’accessibilité. Par exemple, pour un button qui peut recevoir le focus, le navigateur doit ignorer none ou presentation et exposer à la place le rôle implicite de bouton. Les rôles abstraits ne doivent pas être utilisés dans le contenu d’une page.

Privilégiez un élément HTML natif ayant la sémantique appropriée. button a déjà le rôle de bouton, le répéter est donc redondant. Les remplacements autorisés dépendent de l’élément et des règles ARIA in HTML ; tous les rôles ne sont pas valides partout. Respectez également les exigences du rôle choisi concernant les noms, les états et la structure.

Ajouter uniquement role="button" n’ajoute ni gestion du clavier, ni possibilité de recevoir le focus, ni action. L’exemple regroupe deux boutons radio natifs (<input type="radio">) sans remplacer leurs rôles. Lorsque l’option sélectionnée change, le script modifie la taille de police du texte d’exemple. output correspond à la sortie de la console : elle affiche les valeurs déclarées de role et de aria-label ainsi que le texte visible du groupe, sans examiner l’arbre d’accessibilité.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Named group of display options</title>
</head>
<body>
  <div id="display-options" role="group" aria-label="Display options">
    <label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
    <label><input type="radio" name="zoom" value="large"> Large size</label>
  </div>
  <p id="sample">Sample text</p>
  <script>
    const group = document.getElementById('display-options');
    const sample = document.getElementById('sample');
    group.addEventListener('change', event => {
      sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
    });
    console.log('Declared role: ' + group.getAttribute('role'));
    console.log('ARIA label: ' + group.getAttribute('aria-label'));
    console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
  </script>
</body>
</html>

Résultat

Declared role: group
ARIA label: Display options
Visible group text: Normal size Large size

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources