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 |