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

CKTIS / HTML

aria-pressed — état persistant d’un bouton bascule

`aria-pressed` distingue un bouton bascule d’un bouton ordinaire qui exécute une commande ponctuelle.

Version : WAI-ARIA 1.2

Syntaxe

<button aria-pressed="false">Bold</button>

Sur un bouton, utilisez true, false ou mixed. Un état absent indique un bouton ordinaire. L’état mixte peut décrire des réglages différents au sein d’un groupe, pas le maintien physique d’une touche.

Conservez un nom stable comme Bold et actualisez séparément l’état et l’effet visible. Un bouton natif fournit l’activation de base au clavier, mais ARIA n’apporte ni logique de bascule ni style. N’utilisez pas cette propriété à la place de l’état coché d’une case.

L’exemple modifie la graisse du texte et l’état du bouton dans une seule fonction. Le test vérifie l’état enfoncé dans l’arbre d’accessibilité et la graisse calculée 700. Il montre ainsi la description destinée aux technologies d’assistance et un véritable changement visuel.

Exemples

<!doctype html><meta charset="utf-8">
<style>.bold {font-weight:700} #sample:not(.bold) {font-weight:400}</style>
<button id="bold" aria-pressed="false">Bold</button><p id="sample">Selected text</p>
<output id="result"></output>
<script>
const button = document.querySelector('#bold'), sample = document.querySelector('#sample');
button.addEventListener('click', () => {
  const pressed = button.getAttribute('aria-pressed') !== 'true';
  button.setAttribute('aria-pressed', String(pressed)); sample.classList.toggle('bold', pressed);
});
button.click();
document.querySelector('#result').textContent = 'pressed=' + button.getAttribute('aria-pressed') + '; weight=' + getComputedStyle(sample).fontWeight;
</script>

Résultat

pressed=true; weight=700

Le résultat correspond au gras activé. Une nouvelle activation inverse l’état tout en gardant le même nom.

Sources