CKTIS / HTML
aria-pressed — dauerhafter Zustand eines Umschaltbuttons
`aria-pressed` unterscheidet einen zustandswechselnden Button von einem gewöhnlichen Button für einen einmaligen Befehl.
Version: WAI-ARIA 1.2
Syntax
<button aria-pressed="false">Bold</button>Verwende auf einem Button true, false oder mixed. Eine fehlende Zustandsangabe kennzeichnet einen gewöhnlichen Button. Gemischt kann unterschiedliche Einstellungen einer Gruppe beschreiben, nicht das physische Gedrückthalten einer Taste.
Behalte einen festen Namen wie Bold und aktualisiere Zustand und sichtbare Wirkung separat. Ein nativer Button bietet die grundlegende Tastaturaktivierung, aber ARIA liefert weder Umschaltlogik noch Gestaltung. Verwende diese Eigenschaft nicht als Ersatz für den Auswahlzustand einer Checkbox.
Das Beispiel ändert Schriftgewicht und Buttonzustand in einer Funktion. Der Test bestätigt den gedrückten Zustand im Barrierefreiheitsbaum und das berechnete Schriftgewicht 700. Damit zeigt er sowohl die Beschreibung für Hilfstechnologien als auch eine echte visuelle Änderung.
Beispiele
<!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>Ergebnis
pressed=true; weight=700
Das Ergebnis zeigt eingeschalteten Fettdruck. Eine erneute Aktivierung kehrt den Zustand um und behält denselben Namen.