ARIA: Dokumentstrukturelle Rollen

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

Strukturelle ARIA-Rollen wurden ursprünglich als Brücke geschaffen, um unterstützenden Technologien Informationen über HTML5-Elemente bereitzustellen, die in Browsern noch nicht vollständig unterstützt wurden. Einige Rollen, wie presentation, toolbar und tooltip, liefern Informationen über die Dokumentstruktur an unterstützende Technologien in Fällen, in denen es keine äquivalenten nativen HTML-Elemente gibt. Andere Rollen, einschließlich der in der unten stehenden Tabelle aufgeführten, sind nicht erforderlich, da es semantische HTML-Elemente mit denselben Bedeutungen gibt. In vielen Fällen wurden diese äquivalenten HTML-Elemente schon immer unterstützt.

Hinweis: Diese strukturellen Rollen haben alle semantische HTML-Äquivalente. Sie sind hier für die 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 separate Dokumentationen. 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, wurden aber in ARIA hinzugefügt, um Vollständigkeit zu gewährleisten. Wir haben sie auch hier zur 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 `associationlistitemkey`-Kinder und deren Geschwister `associationlistitemvalue`.	`<dl>`
`associationlistitemkey` Muss in einer `associationlist` enthalten sein.	`<dt>`
`associationlistitemvalue` Immer ein nachfolgendes Geschwister eines `associationlistitemkey`.	`<dd>`
`blockquote` Ein Abschnitt mit Inhalt, der aus einer anderen Quelle zitiert wurde.	`<blockquote>`
`caption` Sichtbarer Inhalt, der einen `figure`, `table`, `grid` oder `treegrid` benennt und möglicherweise auch beschreibt. Nur in diesen 4 Rollen zu finden. Die `id` einer Beschriftung wird im Allgemeinen von einem `figure`, `grid`, `table` oder `treegrid`-Element über das `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 bilden. Synonym für `img`-Rolle.	`<img>`
`img` Container für eine Sammlung von Elementen, die ein Bild bilden. Zugänglicher Name ist erforderlich. Siehe die `img`-Rolle für weitere Informationen.	`<img>`
`insertion` Inhalt, der als hinzugefügt oder als hinzuzufügend vorgeschlagen markiert ist. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<ins>`
`list` Ein Abschnitt, der `listitem`-Elemente enthält. Siehe `list`-Rolle für weitere Informationen	`<ol>` `<ul>`
`listitem` Ein einzelnes Element in einer `list` oder `directory`. Muss in einer `list` enthalten sein (wie `<li>`). Siehe `listitem`-Rolle für weitere Informationen.	`<li>`
`mark` Markiert oder hervorgehoben für Referenz- oder Notationszwecke. Siehe `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 `meter`-Rolle für weitere Informationen.	`<meter>`
`paragraph` Ein Absatz von Inhalt. 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 einer 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 einer 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 `term`-Rolle für weitere Informationen.	`<dfn>`
`time` Ein gültiges Datum- oder Zeitstringformat, das einen bestimmten Zeitpunkt auflistet. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<time>`

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

Beste Praktiken

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

Spezifikationen

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