Skip to content
Version:

Accessible Text ​

Accessible Text stellt längere Texte so dar, dass sie in jeder Situation vollständig lesbar und für alle Nutzer zugänglich bleiben, auch wenn der verfügbare Platz begrenzt ist.

Overview ​

Intro ​

Lange Texte stoßen in Benutzeroberflächen schnell an Grenzen: In schmalen Spalten, Kopfzeilen oder bei starkem Zoom (z. B. 400 %) werden sie abgeschnitten und mit Auslassungspunkten („…“) gekürzt. Der restliche Text ist dann zwar für Mausnutzer per Tooltip erreichbar, für Nutzer, die nur mit der Tastatur arbeiten, jedoch nicht.

Accessible Text löst dieses Problem: Sobald ein Text gekürzt wird, erscheint automatisch ein fokussierbares Info-Icon, über das der vollständige Text angezeigt werden kann. Mehrzeilige Texte werden außerdem automatisch auf eine gut lesbare Zeilenlänge begrenzt.

Accessible Text Beispiel

Verwendung ​

👍 Do👎 Don't
... für lange Texte, die bei wenig Platz gekürzt werden müssen, z. B. Überschriften in Kopfzeilen, Titel in Karten oder Inhalte in Tabellenzellen.
... für Fließtexte, deren Zeilenlänge auf ein gut lesbares Maß begrenzt werden soll.
... wenn ein Text um eine kurze Erklärung ergänzt werden soll, die über ein Info-Icon abrufbar ist.
... für Texte innerhalb von Links oder Überschriften, die bei Platzmangel gekürzt werden.
... für kurze Texte, die garantiert immer vollständig angezeigt werden können (z. B. Feldbezeichnungen oder Buttontexte).
... für Texte, die interaktive Elemente wie Links oder Buttons enthalten; der Tooltip zeigt nur reinen Text an.
... für wichtige Informationen, die für den Abschluss eines Arbeitsflusses benötigt werden; diese sollten immer vollständig sichtbar sein.
... als Ersatz für ausführliche Hilfetexte; verwende hierfür z. B. einen Hilfetext am Eingabefeld oder das Side Panel.

Guidelines ​

Aufbau ​

Accessible Text besteht aus zwei Elementen:

  • Text: Der eigentliche Inhalt. Er wird je nach Einstellung einzeilig, mehrzeilig oder ungekürzt dargestellt.
  • Info-Icon: Ein fokussierbares Icon am Ende des Textes. Es erscheint nur dann, wenn der Text gekürzt ist oder eine zusätzliche Erklärung hinterlegt wurde. Über das Icon wird ein Tooltip mit dem vollständigen Text bzw. der Erklärung geöffnet.

Das Info-Icon steht immer auf der Grundlinie der ersten Textzeile, damit es optisch zum Text gehört, auch innerhalb von Überschriften oder Links.

Varianten/Typen ​

Einzeilig gekürztDer Text wird auf eine Zeile begrenzt. Passt er nicht in den verfügbaren Platz, wird er mit Auslassungspunkten („…“) gekürzt und das Info-Icon erscheint. Einsatz z. B. für Überschriften in Kopfzeilen, Kartentitel oder Tabellenzellen.
Mehrzeilig gekürztDer Text wird auf eine festgelegte Anzahl Zeilen (z. B. zwei) begrenzt. Ist er länger, wird er am Ende der letzten Zeile gekürzt und das Info-Icon erscheint. Einsatz z. B. für Beschreibungen in Karten oder Listen, die eine einheitliche Höhe haben sollen.
UngekürztDer Text wird vollständig angezeigt und bei Bedarf in die nächste Zeile umgebrochen. Die Zeilenlänge wird dabei automatisch begrenzt (siehe Verhalten). Einsatz für Fließtexte und Beschreibungen.
Mit ErklärungZu jeder der oben genannten Varianten kann eine kurze Erklärung hinterlegt werden. Das Info-Icon ist dann immer sichtbar, unabhängig davon, ob der Text gekürzt ist. Ist der Text zusätzlich gekürzt, zeigt der Tooltip zuerst die Erklärung und darunter den vollständigen Text.

Info für Dev

Die maximale Zeilenanzahl wird über das Attribut max-lines gesetzt, die Erklärung über tooltip-text. Die Position des Tooltips lässt sich über tooltip-position anpassen (Standard: end). Die Beschriftung des Info-Icons für Screenreader ist über i18n.tooltipToggleAriaLabel übersetzbar.

Verhalten ​

Kürzen und Anzeigen des vollständigen Textes ​

Accessible Text erkennt selbstständig, ob der Text in den verfügbaren Platz passt. Ändert sich die Breite, z. B. durch Verkleinern des Browserfensters, Verschieben eines Splitters oder durch Zoom, wird die Darstellung sofort angepasst: Das Info-Icon erscheint, sobald der Text gekürzt wird, und verschwindet wieder, sobald er vollständig sichtbar ist.

Auch wenn das Kürzen nicht von der Komponente selbst, sondern vom umgebenden Element ausgeht (z. B. eine Tabellenzelle mit Auslassungspunkten), wird dies erkannt und das Info-Icon angezeigt.

Fährt der Nutzer mit der Maus über das Info-Icon oder fokussiert es mit der Tastatur, öffnet sich ein Tooltip mit dem vollständigen Text. Standardmäßig erscheint der Tooltip in Leserichtung hinter dem Icon (rechts); die Position kann bei Bedarf angepasst werden, z. B. oberhalb, wenn rechts zu wenig Platz ist.

Begrenzung der Zeilenlänge ​

Bricht ein Text in mehrere Zeilen um, wird seine Breite automatisch auf ca. 80 Zeichen pro Zeile begrenzt. Zu lange Zeilen erschweren das Lesen, da das Auge beim Zeilenwechsel leicht den Anschluss verliert. Die Begrenzung entspricht den Empfehlungen der WCAG (Erfolgskriterium 1.4.8 „Visuelle Darstellung“).

Einzeilig gekürzte Texte sind von dieser Begrenzung ausgenommen. Sie dürfen den gesamten verfügbaren Platz nutzen, damit so viel Text wie möglich sichtbar bleibt.

Barrierefreiheit ​

Accessible Text stellt sicher, dass ein Text in jeder Kombination aus Länge, Zeilenanzahl und verfügbarem Platz vollständig zugänglich bleibt:

  • Einzeilige Texte, die abgeschnitten werden, sind über das fokussierbare Info-Icon auch ohne Maus vollständig erreichbar.
  • Mehrzeilige Texte werden auf eine gut lesbare Zeilenlänge von ca. 80 Zeichen begrenzt.
  • Mehrzeilig gekürzte Texte sind wie einzeilige Texte über das Info-Icon vollständig erreichbar.

Das Info-Icon trägt für Screenreader die Beschriftung „Kompletten Text anzeigen“. Das Icon selbst ist rein dekorativ und wird von Screenreadern nicht vorgelesen. Der Inhalt des Tooltips ist semantisch mit dem Icon verknüpft und wird beim Fokussieren vorgelesen.

Besonders wichtig ist das Verhalten bei starkem Zoom (bis 400 %, WCAG Erfolgskriterium 1.4.10 „Reflow“): Hier werden auch Texte gekürzt, die in der Standardansicht vollständig sichtbar sind, z. B. Überschriften in der Kopfzeile einer Anwendung.

Tastaturbedienung

Über die Tabulatortaste („Tab“) oder Hochstell- und Tabulatortaste („Shift“ + „Tab“) ist das Info-Icon fokussierbar, sobald es sichtbar ist. Beim Fokussieren öffnet sich der Tooltip mit dem vollständigen Text bzw. der Erklärung. Mit der Escape-Taste („Esc“) kann der Tooltip geschlossen werden.

Ist der Text vollständig sichtbar und keine Erklärung hinterlegt, wird das Info-Icon ausgeblendet und ist nicht Teil der Tab-Reihenfolge.