Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ARIA: Rolle complementary

Die Landmark-Rolle complementary kennzeichnet einen ergänzenden Abschnitt, der mit dem Hauptinhalt zusammenhängt, aber auch für sich allein verständlich ist. Solche Abschnitte werden häufig als Seitenleisten oder hervorgehobene Kästen dargestellt. Verwenden Sie nach Möglichkeit stattdessen das HTML-Element <aside>.

html
<div role="complementary">
  <h2>Our partners</h2>
  <!-- complementary section content -->
</div>

Dies ist eine Seitenleiste mit Links zu den Sponsoren des Projekts.

Beschreibung

Die Rolle complementary ist eine Landmark-Rolle. Assistive Technologien können Landmarks verwenden, um größere Abschnitte eines Dokuments schnell zu erkennen und dorthin zu navigieren. Inhalte in einem Container mit der Landmark-Rolle complementary sollten auch dann verständlich sein, wenn sie vom Hauptinhalt des Dokuments getrennt werden.

Hinweis: Das Element <aside> hat implizit die Rolle complementary, es sei denn, es hat keinen zugänglichen Namen und ist in gliedernde Inhalte eingebettet. Verwenden Sie nach Möglichkeit immer das passende semantische HTML-Element statt ARIA.

Hinweise zur Barrierefreiheit

Landmark-Rollen sollten sparsam eingesetzt werden, um größere Bereiche eines Dokuments zu kennzeichnen. Zu viele Landmark-Rollen können bei Screenreadern zu unnötigen Ansagen führen und es erschweren, den Gesamtaufbau der Seite zu verstehen.

Bewährte Verfahren

HTML bevorzugen

Das Element <aside> hat implizit die Rolle complementary, es sei denn, es hat keinen zugänglichen Namen und ist in gliedernde Inhalte eingebettet. Verwenden Sie nach Möglichkeit das semantische Element <aside> statt der Rolle complementary.

Landmarks beschriften

Mehrere Landmarks

Wenn ein Dokument mehr als eine Landmark mit der Rolle complementary oder mehr als ein <aside>-Element enthält, versehen Sie jede Landmark mit einer Beschriftung. Verwenden Sie dazu das Attribut aria-label. Falls das Aside-Element einen passenden, aussagekräftigen Titel hat, können Sie stattdessen mit dem Attribut aria-labelledby darauf verweisen. Anhand der Beschriftung können Nutzer assistiver Technologien den Zweck jeder Landmark schnell erkennen.

html
<aside aria-label="Note about usage">
  <!-- content -->
</aside>

…

<aside id="sidebar" aria-label="Sponsors">
  <!-- content -->
</aside>

Redundante Beschreibungen

Screenreader geben den Rollentyp einer Landmark bekannt. Daher müssen Sie den Typ der Landmark nicht in ihrer Beschriftung beschreiben. Beispielsweise könnte role="complementary" mit aria-label="Sidebar" redundant als „ergänzende Seitenleiste“ angesagt werden.

Weitere Vorteile

Bestimmte Technologien, etwa Browser-Erweiterungen, können Listen aller Landmark-Rollen auf einer Seite erstellen. So können auch Nutzer ohne Screenreader größere Abschnitte eines Dokuments schnell erkennen und dorthin navigieren.

Beispiele

html
<div role="complementary">
  <h2>Trending articles</h2>
  <ul>
    <li><a href="#">18 tweets that will make you feel all the feels</a></li>
    <li>
      <a href="#">Stop searching! I've found the perfect lunch containers.</a>
    </li>
    <li>
      <a href="#">The time has come to decide how to call these foods</a>
    </li>
    <li><a href="#">17 really good posts we saw on Tumblr this week</a></li>
    <li><a href="#">10 parent hacks we know work because we tried them</a></li>
  </ul>
</div>

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA)
# complementary
Unknown specification

Siehe auch