ARIA: document-Rolle

Die document-Rolle ist für den oberen Container gedacht, der Inhalte enthält, die Benutzer von unterstützenden Technologien im Lesemodus durchsuchen möchten. Nur innerhalb fokussierbarer Abschnitte innerhalb komplexer zusammengesetzter Widgets oder Anwendungen nützlich, informiert die document-Rolle die assistierenden Technologien, den Lesekontext zurück zum Lesemodus zu schalten: Die document-Rolle weist assistierende Technologien mit Lese- oder Durchsichtsmodi an, den Dokumentmodus zu verwenden, um den im Element enthaltenen Inhalt zu lesen.

<div role="dialog">
  …
  <div id="InfoText" role="document" tabindex="0">
    <p>Some informational text goes here.</p>
  </div>
  …
  <button>Close</button>
</div>

Dieses Beispiel zeigt einen Dialog, eine komplexe zusammengesetzte Widgetrolle, mit einigen Steuerungen und einem Abschnitt mit informativem Text, den die Nutzer der unterstützenden Technologien im Lesemodus lesen können, wenn er fokussiert wird.

Standardmäßig werden Webseiten als Dokumente behandelt; unterstützende Technologien (AT) treten in den Durchsichts- oder Lesemodus ein, wenn sie eine neue Webseite betreten. Dieser Modus kann durch verschiedene Rollen, einschließlich der Widget- und Anwendungsrollen, geändert werden. Die document-Rolle bringt das AT zurück in den Durchsichts- oder Lesemodus.

In der Regel wird die document-Rolle innerhalb einer Anwendungsrolle oder einer anderen interaktiven Widgetrolle platziert und verwendet, um einen Abschnitt eines komplexen zusammengesetzten Widgets zu kennzeichnen, den ein Benutzer von unterstützenden Technologien mit seinem Durchsichts- oder virtuellen Lesemodus, falls verfügbar, lesen sollte.

Da ATs mit Lesemodus standardmäßig diesen Modus für alle Elemente außer solchen mit einer Widget- oder Anwendungsrolle verwenden, ist die document-Rolle nur für fokussierbare Elemente innerhalb eines Widgets oder einer Anwendung nützlich, die als statischer Rich-Text gelesen werden sollten. Wenn role="document" und tabindex="0" zu dem Element hinzugefügt wird, das den Text innerhalb eines Widgets enthält, kann der Benutzer des Screenreaders die Tabulatortaste drücken, um den Fokus auf das Dokumentelement zu legen und den Text mit dem Lesecursor des Screenreaders zu lesen.

Unterstützende Technologien sollten den Kontext zurück zum Dokumentmodus wechseln, möglicherweise indem sie von Steuerungen abgefangen werden, die für den dynamischen Kontext des übergeordneten Elementes neu verdrahtet wurden, um die Standard-Eingabeereignisse, wie Tastaturereignisse für die Pfeiltasten nach oben oder unten, zur Steuerung des Lesecursors wieder zu aktivieren.

Im Gegensatz zur article-Rolle hat die document-Rolle keine Beziehung zu anderen Elementen mit einer Dokumentrolle, sie hat lediglich eine Beziehung zum enthaltenden zusammengesetzten Widget. Ein Artikel kann zugehörige Artikel haben.

aria-expanded

Sollte mit einem Wert von true oder false angegeben werden, wenn das Dokumentelement zusammenklappbar ist, um anzuzeigen, ob das Dokument derzeit erweitert oder eingeklappt ist. Andere Werte schließen die Standardeinstellung undefined ein, was bedeutet, dass das Dokument nicht zusammenklappbar ist.

tabindex="0"

Wird verwendet, um es fokussierbar zu machen, sodass der Benutzer der unterstützenden Technologie darauf tabben und sofort mit dem Lesen beginnen kann.

Das Element sollte fokussierbar gemacht werden, indem das Attribut tabindex="0" darauf gesetzt wird. Auf diese Weise kann der Benutzer darauf tabben, der Lesemodus wird automatisch aktiviert, und der Inhalt kann sofort gelesen werden.

Keine, außer wie von den Attributen erforderlich. Zum Beispiel, wenn das document zusammenklappbar ist, dann müssen der Zustand und der Wert von aria-expanded aufrechterhalten werden.

Ein Beispiel ist Gmail und die Ansicht einer einzelnen Konversation. GMail ist eine Webanwendung. In GMail werden die meisten Benutzeragenten-Interaktionen von der Anwendung übernommen. Wenn jedoch der Tastaturfokus auf die Startüberschrift einer einzelnen Konversation gesetzt wird, die das Thema der Konversation enthält, kann der Benutzer des Screenreaders mit Hilfe der Lesemodus-Befehle durch die Nachrichten lesen, sie erweitern oder zusammenklappen und sie manipulieren. Sobald der Fokus wieder zur Nachrichtenliste zurückkehrt, entweder durch Aktivierung der Zurück-Taste oder durch Drücken eines zugehörigen Tastenkürzels, wird der direkte Anwendungs-Interaktionsmodus wieder aktiviert, und der Benutzer kann mit den Pfeiltasten zu einer anderen Konversation in der Liste wechseln.

Stellen Sie immer sicher, dass ein Element mit der document-Rolle fokussierbar ist, indem Sie das tabindex-Attribut mit einem Wert von 0 setzen. Dadurch wird es auch in die Tabreihenfolge eingeschlossen.

Die document-Rolle ist eine einfache Möglichkeit, das Verhalten unterstützender Technologien indirekt zu steuern, indem unmissverständlich angegeben wird, dass dies Inhalt ist, den der Benutzer mit den Standardbefehlen des Screenreaders lesen sollte.

• ARIA: widget Rolle
• ARIA: application Rolle