Ratgeber: Ein Hilfetext braucht eine echte Verbindung zum Formularfeld

Nähe allein stellt noch keine Beziehung her

Unter einem Dateifeld steht „PDF, höchstens fünf Megabyte“. Sehende Menschen ordnen den Satz meist intuitiv dem Feld darüber zu. Für assistive Technik sollte diese Beziehung ausdrücklich beschrieben werden. MDN erläutert aria-describedby als Verweis auf beschreibende Elemente im selben Dokument. Die Kennungen mehrerer Beschreibungen können dabei kombiniert werden. Dieser Fachratgeber verwendet die am 21. Oktober 2026 gelesene Originaldokumentation; er stellt eine bestehende Webtechnik anhand eines eigenen Beispiels vor.

Eine verständliche Hilfe schreiben

Beginne ohne Code. Was muss jemand vor der Eingabe wissen? Für unser erfundenes Bewerbungsformular sind das erlaubtes Dateiformat, Größenlimit und der Hinweis, dass ein Dokument genügt. Schreibe diese Information kurz und direkt. Das Feld erhält weiterhin eine klare Beschriftung wie „Arbeitsprobe“. Die Beschreibung ergänzt die Bezeichnung, sie ersetzt sie nicht. Ein langer Absatz mit sämtlichen Datenschutzregeln wäre an dieser Stelle schwer erfassbar und gehört besser in einen passenden eigenen Bereich.

Vergib nun eine eindeutige Kennung für den Hilfetext und verweise vom Feld darauf. Wenn mehrere Dateifelder auf einer Seite erscheinen, dürfen ihre Kennungen nicht versehentlich identisch sein. Sonst kann die sichtbare Hilfe richtig wirken, während die technische Zuordnung auf eine andere Stelle zeigt.

Fehler ergänzen, ohne die Hilfe zu verlieren

Nach einer zu großen Datei sollte ein konkreter Fehler erscheinen: Die ausgewählte Datei überschreitet das erlaubte Limit. Die ursprüngliche Formatangabe bleibt weiterhin nützlich. Plane deshalb, wie Hilfe und Fehler gemeinsam mit dem Feld verbunden werden. Ein neu eingeblendeter Satz ist nicht automatisch eine Live-Mitteilung; die Darstellung und gegebenenfalls die Ankündigung müssen als getrennte Aufgaben geprüft werden. Der Nutzer soll die Eingabe korrigieren können, ohne den Zusammenhang erneut suchen zu müssen.

In einem einfachen Testformular kannst du drei Zustände vorbereiten: noch keine Datei, zulässige Datei und zu große Datei. Verwende harmlose lokale Beispiele. Die Browseransicht muss den richtigen Zustand erklären, und die spätere serverseitige Prüfung muss dieselben sachlichen Grenzen durchsetzen.

Zuordnung statt bloßer Anwesenheit prüfen

Kontrolliere im fertigen Formular, ob jede referenzierte Kennung genau einmal existiert und tatsächlich zum betreffenden Feld gehört. Prüfe anschließend mit Tastatur und einer geeigneten assistiven Testumgebung, ob Name und Beschreibung verständlich zusammenkommen. Eine automatisch gefundene Attributliste allein belegt noch keine gute Bedienung. Halte im Abnahmeprotokoll fest, welche Felder, Zustände und Kombinationen geprüft wurden. So bleibt nachvollziehbar, ob die Hilfe wirklich an der richtigen Stelle ankommt.