ARIA: Dokumentstrukturrollen

ARIA-Dokumentstrukturrollen werden verwendet, um eine strukturelle Beschreibung für einen Inhaltsabschnitt bereitzustellen.

Strukturelle ARIA-Rollen wurden ursprünglich als Brücke geschaffen, um assistiven Technologien HTML5-Elemente zu vermitteln, die von Browsern noch nicht vollständig unterstützt wurden. Einige Rollen wie presentation, toolbar und tooltip liefern Informationen zur Dokumentstruktur an assistive Technologien in Fällen, in denen gleichwertige native HTML-Elemente nicht existieren. Andere Rollen, einschließlich der unten aufgeführten, sind nicht erforderlich, da es semantische HTML-Elemente mit derselben Bedeutung gibt. In vielen Fällen wurden diese äquivalenten HTML-Elemente immer schon unterstützt.

Hinweis: Diese strukturellen Rollen haben alle semantische HTML-Äquivalente. Sie sind hier zur Vollständigkeit der Dokumentation enthalten. Vorzugsweise sollten sie nicht von Webautoren verwendet werden.

Einige strukturelle Rollen, wie suggestion, haben keine HTML-Äquivalente und haben daher eine separate Dokumentation. Einige strukturelle Rollen mit HTML-Äquivalenten, wie heading, haben ARIA-Attributanforderungen. Sie sind unten mit Links zu ihrer individuellen Rollendokumentation aufgeführt.

Die meisten der folgenden Rollen waren nie erforderlich, aber sie wurden zu ARIA für die Vollständigkeit hinzugefügt. Wir haben sie hier ebenfalls aus Gründen der Vollständigkeit aufgenommen.

Strukturelle Rollen mit HTML-Äquivalenten

Die Strukturrollen mit HTML-Äquivalenten sind unten aufgeführt:

ARIA-Rolle & Beschreibung HTML-Äquivalent
associationlist
Enthält nur Kinder von associationlistitemkey und deren Geschwister associationlistitemvalue.
<dl>
associationlistitemkey
Muss in einem associationlist enthalten sein.
<dt>
associationlistitemvalue
Immer ein Geschwister-Element, das auf ein associationlistitemkey folgt.
<dd>
blockquote
Ein Abschnitt von Inhalten, der aus einer anderen Quelle zitiert wird.
<blockquote>
caption
Sichtbarer Inhalt, der ein figure, table, grid oder treegrid benennt und möglicherweise beschreibt.
Nur in diesen 4 Rollen zu finden. Die id einer Beschriftung wird im Allgemeinen von einem figure, grid, table oder treegrid-aria-labelledby-Attribut referenziert.
Verbotene Attribute: aria-label und aria-labelledby.
<caption>
<figcaption>
code
Ein Abschnitt, der ein Fragment von Computercode darstellt.
Verbotene Attribute: aria-label und aria-labelledby.
<code>
deletion
Inhalt, der als entfernt oder zur Entfernung vorgeschlagen markiert ist.
Verbotene Attribute: aria-label und aria-labelledby.
<del>
emphasis
Wird verwendet, um Inhalte zu betonen oder hervorzuheben, jedoch nicht, um Wichtigkeit zu suggerieren.
Verbotene Attribute: aria-label und aria-labelledby.
<em>
figure
Container für ein grafisches Dokument, Bilder, Code-Snippets oder Beispieltext.
<figure>
heading
Eine Überschrift für einen Abschnitt der Seite.
Das aria-level-Attribut ist erforderlich, um die Verschachtelungsebene anzugeben.
Siehe die heading-Rolle für weitere Informationen.
h1, h2, h3, h4, h5, und h6
image
Container für eine Sammlung von Elementen, die ein Bild formen. Synonym für img-Rolle.
<img>
img
Container für eine Sammlung von Elementen, die ein Bild formen.
Zugänglicher Name erforderlich.
Siehe die img-Rolle für weitere Informationen.
<img>
insertion
Inhalt, der als hinzugefügt oder als Hinzufügung vorgeschlagen markiert ist.
Verbotene Attribute: aria-label und aria-labelledby.
<ins>
list
Ein Abschnitt, der listitem-Elemente enthält.
Siehe die list-Rolle für weitere Informationen.
<ol>
<ul>
listitem
Ein Einzelposten in einer list oder directory.
Muss in einer list enthalten sein (ähnlich <li>).
Siehe die listitem-Rolle für weitere Informationen.
<li>
mark
Gekennzeichnet oder hervorgehoben für Verweis- oder Notationszwecke.
Siehe die mark-Rolle für weitere Informationen.
<mark>
meter
Eine skalare Messung innerhalb eines bekannten Bereichs oder ein Bruchwert.
Zugänglicher Name erforderlich. aria-valuenow erforderlich.
Siehe die meter-Rolle für weitere Informationen.
<meter>
paragraph
Ein Absatz von Inhalten.
Verbotene Attribute: aria-label und aria-labelledby.
<p>
strong
Wichtiger, ernster oder dringender Inhalt.
Verbotene Attribute: aria-label und aria-labelledby.
<strong>
subscript
Ein oder mehrere tiefgestellte Zeichen.
Nur verwenden, wenn das Fehlen der Rolle die Bedeutung des Inhalts ändern würde.
Verbotene Attribute: aria-label und aria-labelledby.
<sub>
superscript
Ein oder mehrere hochgestellte Zeichen.
Nur verwenden, wenn das Fehlen der Rolle die Bedeutung des Inhalts ändern würde.
Verbotene Attribute: aria-label und aria-labelledby.
<sup>
term
Wort oder Phrase mit einer optionalen entsprechenden Definition.
Verbotene Attribute: aria-label und aria-labelledby.
Siehe die term-Rolle für weitere Informationen.
<dfn>
time
Ein gültiges Datums- oder Zeitformat, das einen bestimmten Zeitpunkt angibt.
Verbotene Attribute: aria-label und aria-labelledby.
<time>

Hinweis: Die Attribute aria-label und aria-labelledby sind bei code, caption, deletion, emphasis, generic, insertion, mark, paragraph, presentation, none, strong, subscript, superscript, suggestion, term und time verboten und sollten nur auf interaktiven Inhalten verwendet werden.

Best Practices

Verwenden Sie keine strukturellen Rollen. Wählen Sie stattdessen HTML-Semantikelemente.

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# document_structure_roles

Siehe auch