ARIA: Rolle progressbar
Die Rolle progressbar definiert ein Element, das den Fortschritt länger dauernder Aufgaben anzeigt.
Beschreibung
Das Bereichs-Widget progressbar zeigt an, dass eine Anfrage eingegangen ist und die Anwendung bei der Ausführung der angeforderten Aktion Fortschritte macht.
Autoren können aria-valuemin und aria-valuemax festlegen, um den Mindest- und Höchstwert der Fortschrittsanzeige anzugeben. Andernfalls gelten für die impliziten Werte dieselben Regeln wie für <input type="range"> in HTML:
- Wenn
aria-valueminfehlt oder keine Zahl ist, wird standardmäßig0(null) verwendet. - Wenn
aria-valuemaxfehlt oder keine Zahl ist, wird standardmäßig100verwendet. - Die Eigenschaften
aria-valueminundaria-valuemaxmüssen für die Rolleprogressbarnur festgelegt werden, wenn der Mindestwert der Fortschrittsanzeige nicht0oder der Höchstwert nicht100ist. - Das schreibgeschützte Attribut
aria-valuenowsollte angegeben und aktualisiert werden, sofern der Wert nichtindeterminateist. In diesem Fall darf das Attribut nicht enthalten sein. Wenn es gesetzt ist, muss der Wert vonaria-valuenowzwischen dem Mindest- und dem Höchstwert liegen.
Wenn die Rolle progressbar auf ein HTML-Element <progress> angewendet wird, kann der zugängliche Name vom zugehörigen Element <label> stammen. Verwenden Sie andernfalls aria-labelledby, wenn eine sichtbare Beschriftung vorhanden ist, oder aria-label, wenn keine sichtbare Beschriftung vorhanden ist.
Alle Nachfahren sind rein präsentationsbezogen
Manche Arten von Benutzeroberflächenkomponenten können in einer Barrierefreiheits-API der Plattform nur Text enthalten. Barrierefreiheits-APIs können semantische Elemente innerhalb einer progressbar nicht darstellen. Um diese Einschränkung zu berücksichtigen, weisen Browser allen Nachfahren eines progressbar-Elements automatisch die Rolle presentation zu, da die Rolle progressbar keine semantischen Kindelemente unterstützt.
Betrachten Sie beispielsweise das folgende progressbar-Element, das eine Überschrift enthält.
<div role="progressbar"><h3>Title of my progressbar</h3></div>
Da Nachfahren von progressbar rein präsentationsbezogen sind, ist der folgende Code gleichwertig:
<div role="progressbar">
<h3 role="presentation">Title of my progressbar</h3>
</div>
Aus Sicht von Nutzern assistiver Technologien existiert die Überschrift nicht, da die vorherigen Codebeispiele im Barrierefreiheitsbaum dem Folgenden entsprechen:
<div role="progressbar">Title of my progressbar</div>
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
aria-valuenow-
Nur vorhanden und erforderlich, wenn der Wert nicht unbestimmt ist. Legen Sie einen Dezimalwert fest, der den aktuellen Wert der Fortschrittsanzeige angibt und zwischen
0beziehungsweise, falls vorhanden,aria-valueminundaria-valuemaxliegt. aria-valuetext-
Assistive Technologien geben den Wert von
aria-valuenowhäufig als Prozentsatz wieder. Falls dies nicht zutreffend wäre, verwenden Sie diese Eigenschaft, um den Wert der Fortschrittsanzeige verständlich anzugeben. aria-valuemin-
Legen Sie einen Dezimalwert fest, der den Mindestwert darstellt und kleiner als
aria-valuemaxist. Falls die Eigenschaft nicht vorhanden ist, beträgt der Standardwert0. aria-valuemax-
Legen Sie einen Dezimalwert fest, der den Höchstwert darstellt und größer als
aria-valueminist. Falls die Eigenschaft nicht vorhanden ist, beträgt der Standardwert100. aria-labeloderaria-labelledby-
Definiert den Zeichenfolgenwert oder identifiziert das Element beziehungsweise die Elemente, die das
progressbar-Element beschriften und ihm damit einen zugänglichen Namen geben. Ein zugänglicher Name ist erforderlich.
Es wird empfohlen, statt der Rolle progressbar ein natives Element <progress> oder <input type="range"> zu verwenden. User Agents stellen für das Element <progress> ein gestaltetes Widget bereit, das auf dem aktuellen value im Verhältnis zu 0, dem Mindestwert und dem Wert von max basiert. Werden nicht semantische Elemente verwendet, müssen sämtliche Funktionen des nativen semantischen Elements mit ARIA-Attributen, JavaScript und CSS nachgebildet werden.
Bewährte Verfahren
Wenn die Fortschrittsanzeige den Ladefortschritt eines bestimmten Bereichs einer Seite beschreibt, verwenden Sie das Attribut aria-describedby, um auf den Status der Fortschrittsanzeige zu verweisen. Setzen Sie außerdem das Attribut aria-busy für den Bereich auf true, bis er vollständig geladen ist.
HTML bevorzugen
Es wird empfohlen, statt der Rolle progressbar ein natives Element <progress> oder <input type="range"> zu verwenden.
Beispiele
Im folgenden Beispiel verwendet die Fortschrittsanzeige für aria-valuemin und aria-valuemax die Standardwerte 0 und 100:
<div>
<span id="loadinglabel">Loading:</span>
<span role="progressbar" aria-labelledby="loadinglabel" aria-valuenow="23">
<svg width="100" height="10">
<rect height="10" width="100" stroke="black" fill="black" />
<rect height="10" width="23" fill="white" />
</svg>
</span>
</div>
Mit semantischem HTML könnte dies wie folgt geschrieben werden:
<label for="loadinglabel">Loading:</label>
<progress id="loadinglabel" max="100" value="23"></progress>
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # progressbar> |
Siehe auch
- HTML-Element
<progress> - Weitere Bereichs-Widgets:
meterscrollbarseparator(wenn fokussierbar)sliderspinbutton