Synonyme: Textfeld, Edit, Input, Inputfield, Textbox, one line plain text edit control
Siehe auch: Eingabefeld (mehrzeilig), Kennwort-Eingabefeld, Drehfeld, Eingabefeld mit Autocomplete-Funktion, kombiniertes Eingabefeld
Eingabefelder ermöglichen die Eingabe und Bearbeitung von Zeichen (Zahlen, Buchstaben, Sonderzeichen) (siehe DIN EN ISO 9241-161: 8.12).
Ein Eingabefeld ist ein meist rechteckiger Bereich der Seite, der sich z. B. durch einen Rahmen, eine Linie oder eine abweichender Hintergrundfarbe von der Umgebung abhebt. Im Eingabefeld können sich weitere Bedienelemente befinden, die im Bezug zur Werteingabe stehen.
Darstellung
Permalink zu "Darstellung"Nr. | Eigenschaft | Beschreibung | Klassifizierung | Referenz |
---|---|---|---|---|
583 | Kontrast | Der Text im Eingabefeld muss einen Kontrast von mindestens 4,5:1 aufweisen. | Muss | EN 301 549: 9.1.4.3, 11.1.4.3 |
584 | Kontrast | Der Rahmen oder die Linie des Eingabefeldes muss zum Hintergrund der Seite oder des Eingabefeldes ein Kontrastverhältnis von mindestens 3:1 aufweisen. Alternativ muss das Kontrastverhältnis zwischen der Hintergrundfarbe der Seite und des Eingabefeldes mindestens 3:1 betragen. | Muss | EN 301 549: 9.1.4.11, 11.1.4.11 |
585 | Beschriftung | Das Eingabefeld muss eine sichtbare Beschriftung besitzen (siehe Beschriftung) Hinweis: Die Beschriftung kann auch implizit erfolgen, z. B.
| Muss | EN 301 549 9.3.3.2, 11.3.3.2 |
586 | Beschriftung | Die Beschriftung soll sich nicht im Eingabefeld befinden, damit sie dauerhaft sichtbar ist und nicht mit einem Wert verwechselt werden kann. | Soll | DIN EN ISO 9241-125: 5.1.14 |
587 | Fokussichtbarkeit | Erhält das Eingabefeld den Tastaturfokus, dann muss der Fokusindikator sichtbar sein (siehe Fokusindikator). | Muss | EN 301 549: 9.2.4.7, 11.2.4.7 |
588 | Fokussichtbarkeit | Im Eingabefeld muss der Standard-Textcursor angezeigt werden (siehe Textcursor). | Muss | EN 301 549: 9.2.4.7, 11.2.4.7, 11.5.2.13 |
589 | Wert | Wenn in das Eingabefeld nur bestimmte Zeichen eingegeben werden dürfen oder ein besonderes Eingabeformat erforderlich ist und dies nicht aus der Beschriftung des Feldes ersichtlich ist, so muss ein Eingabehinweis in der Beschreibung oder Beschriftung die zulässigen Zeichen oder erforderlichen Eingabeformate erläutern. | Muss | EN 301 549: 9.3.3.2, 11.3.3.2 |
590 | Wert | Das Eingabefeld soll so lang sein, dass die maximale Zeichenzahl ohne Scrollen angezeigt werden kann. Hinweis 1: Für lange Texteingaben soll ein mehrzeiliges Eingabefeld verwendet werden. Hinweis 2: Das gilt nicht bei der Schriftgrößenanpassung bis 400%. | Soll | DIN EN ISO 9241-143: 6.2.8 |
Bedienung
Permalink zu "Bedienung"Nr. | Eigenschaft | Beschreibung | Klassifizierung | Referenz |
---|---|---|---|---|
591 | Tastaturbedienung | Das Eingabefeld muss mit der Tastatur erreicht, bedient und verlassen werden können (siehe folgende Tabelle Tastaturbedienung). | Muss | 9.2.1.1, 11.2.1.1, 9.2.1.2, 11.2.1.2 |
592 | Tastaturbedienung | Enthält das Eingabefeld weitere interaktive Elemente, wie z. B. Schalter, so müssen diese mit der Tabulatortaste nach dem Eingabefeld den Fokus erhalten. Hinweis: Davon ausgenommen sind interaktive Elemente, für die eine allgemein bekannte Tastaturbedienung implementiert ist, wie z. B. ein Schalter zum Löschen der Eingaben im Eingabefeld. Davon ausgenommen sind ebenfalls Elemente, für die ein Tastaturkürzel implementiert wurde, sofern dieses Tastaturkürzel beim Eingabefeld visuell und mit Assistenztechnologie wahrnehmbar ist. | Muss | EN 301 549: 9.2.2.1, 11.2.1.1 |
593 | Aktualisierungen | Bei Fokussierung und Bedienung des Eingabefeldes darf keine unerwartete Kontextänderung erfolgen. | Muss | EN 301 549: 9.3.2.1, 11.3.2.1, 9.3.2.2, 11.3.2.2 |
594 | Klickbereich | Der Klickbereich des Eingabefeldes soll mindestens 24 x 24 px betragen (siehe Zeigeinstrumentbedienung). | Soll | WCAG 2.2 |
595 | Klickbereich | Sowohl über Klick auf das Eingabefeld als auch über Klick auf die Beschriftung soll der Fokus in das Eingabefeld gesetzt werden können. | Soll |
Tastaturbedienung Eingabefeld
Permalink zu "Tastaturbedienung Eingabefeld"Aktion | Taste | Klassifizierung |
---|---|---|
Fokussieren des Eingabefeldes | TAB | Erforderlich |
Verlassen des Eingabefeldes | TAB | Erforderlich |
Eingabe eines Werts | [Eingabe druckbarer Zeichen] Hinweis: Können bestimmte Zeichen nicht eingegeben werden, muss ein entsprechender impliziter oder expliziter Eingabehinweis beim Eingabefeld vorhanden sein. Ein impliziter Eingabehinweis wäre z. B. die Beschriftung „Telefonnummer“, die anzeigt, dass keine Buchstaben eingegeben werden können. | Erforderlich |
Navigation im Eingabefeld | PFEIL RECHTS/LINKS POS1, ENDE | Erforderlich |
Löschen von Text im Eingabefeld | ENTF, RÜCKSCHRITT | Erforderlich |
Markieren von Text im Eingabefeld | UMSCHALT+[beliebige Navigationstaste], STRG+A | Erforderlich |
Aufheben der Markierung | [beliebige Navigationstaste] | Erforderlich |
Einfügen von Text aus der Zwischenablage | STRG+V | Erforderlich |
Kopieren oder Ausschneiden von markiertem Text | STRG+C, STRG+X | Erforderlich |
Zeigeinstrumentbedienung Eingabefeld
Permalink zu "Zeigeinstrumentbedienung Eingabefeld"Aktion | Taste | Klassifizierung |
---|---|---|
Fokus an eine bestimmte Position ins Eingabefeld setzen | Linksklick in das Eingabefeld | Erforderlich |
Fokus ins Eingabefeld setzen | Linksklick auf die Beschriftung | Empfohlen |
Text im Eingabefeld markieren | Ziehen mit gedrückter linker Maustaste | Erforderlich |
Wort im Eingabefeld markieren | Doppelklick | Empfohlen |
Gesamten Inhalt im Eingabefeld markieren | Dreifachklick | Empfohlen |
Programmierung/Schnittstellen
Permalink zu "Programmierung/Schnittstellen"Nr. | Eigenschaft | Beschreibung | Klassifizierung | Referenz |
---|---|---|---|---|
596 | Rolle | Die Rolle Eingabefeld muss an die Accessibility API übermittelt werden (siehe Accessibility API). | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.5 |
597 | Rolle | Wenn die verwendete Technologie den Eingabezweck von Formularfeldern identifizieren kann, dann muss der Zweck der Formularfelder für Daten der jeweiligen Benutzenden (wie z. B. Nachname, Geburtstag, Wohnort) gemäß https://www.w3.org/TR/WCAG21/#input-purposes" ausgezeichnet werden. | Muss | EN 301 549: 9.1.3.5, 11.1.3.5.1 |
598 | Wert | Der Wert des Eingabefeldes muss an die Accessibility API übermittelt werden (siehe Accessibility API). | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.7 |
599 | Status | Der Status des Eingabefeldes muss an die Accessibility API übermittelt werden (siehe Elementstatus). | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.5 |
600 | Name | Das Eingabefeld muss einen knappen und aussagekräftigen Accessible Name besitzen. | Muss | EN 301 549: 9.2.4.6, 11.2.4.6, 9.4.1.2, 11.4.1.2, 11.5.2.5, 11.5.2.8 |
601 | Name | Sofern das Eingabefeld eine Beschreibung besitzt, muss diese als Accessible Description übermittelt werden. | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.5 |
602 | Bedienung | Das Eingabefeld muss mit Assistenztechnologie erreicht, bedient und verlassen werden können (siehe Accessibility API). | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.12, 11.5.2.17 |
603 | Aktualisierung | Aktualisierungen hinsichtlich des Accessible Names, Werts oder Status des Eingabefeldes müssen an die Accessibility API übermittelt werden (siehe Accessibility API). | Muss | EN 301 549: 9.4.1.2, 11.4.1.2, 11.5.2.15 |
604 | Desktop: Position | Größe und Position des Eingabefeldes müssen an die Accessibility API übermittelt werden (siehe Accessibility API). | Muss | EN 301 549: 11.5.2.5, 11.5.2.13 |
605 | Desktop: Position | Die Position des Textcursors im Eingabefeld muss an die Accessibility API übermittelt werden (siehe Fokusindikator) | Muss | EN 301 549: 11.5.2.13 |
Praxistipp einzeiliges Eingabefeld in Web-Anwendungen
Permalink zu "Praxistipp einzeiliges Eingabefeld in Web-Anwendungen"Screenreader-Ausgabe
Permalink zu "Screenreader-Ausgabe"- JAWS: [Beschriftung] Eingabefeld [Wert] [Hinweis zur Texteingabe]
- NVDA: [Beschriftung] Eingabefeld [Wert]
- Windows Sprachausgabe: [Beschriftung] Bearbeiten [Wert]
Das Eingabefeld sollte mit dem HTML-Element <input type=text>
umgesetzt werden.
Für ein Eingabefeld, welches zur Eingabe von Suchbegriffen dient, kann <input type=search>
verwendet werden. Die Screenreader geben das Suchfeld als normales Eingabefeld aus, d. h. die Beschriftung muss auf den Zweck, die Suche, hinweisen.
Der initiale Wert wird über das value
-Attribut übermittelt.
Die Beschriftung des Eingabefeldes sollte mit dem Element <label for=ID>
mit dem Eingabefeld verknüpft werden.
Die maximal erlaubte und minimal erforderliche Länge des Werts kann mit maxlength
und minlength
festgelegt werden. Beide Werte sind weder visuell noch mit Assistenztechnologien wahrnehmbar. Werden sie verwendet, sollte beim Eingabefeld ein entsprechender Hinweis erfolgen.
Wird ein besonderes Eingabeformat verlangt, können anstelle von <input type=text>
u. a. die folgenden Elemente verwendet werden:
<input type=tel>
für Telefonnummern,<input type=email>
für Email-Adressen,<input type=url>
für Internet-Adressen,<input type=text pattern=…>
für Eingaben, die dem regulären Ausdruck impattern
-Attribut entsprechen müssen,<input type=number>
für Zahlen (siehe Drehfeld),<input type=date>
,<input type=time>
usw. für Datums- und Zeitangaben (siehe Datumswähler).
Diese Eingabefelder mit einem vordefinierten Format werden vom Browser automatisch validiert. Die Fehlermeldungen der Browser sind jedoch nicht barrierefrei und sollten somit durch eigene Fehlermeldungen der Anwendung ersetzt oder ergänzt werden (siehe auch: Browser-Validierung des required
-Attributs im
.
Die Eingabefelder für Telefonnummern, Email- und Internet-Adressen sowie Eingabefelder mit dem pattern
-Attribut sind weder visuell noch mit Assistenztechnologie als solche zu erkennen – sie werden als normale Eingabefelder angezeigt bzw. vom Screenreader ausgegeben. Deshalb müssen sie aussagekräftig beschriftet werden und sollten zusätzlich Bedienhinweise zum erforderlichen Eingabeformat erhalten.
Mit dem Attribut inputmode
kann festgelegt werden, welche virtuelle Tastatur auf Mobilgeräten angezeigt werden soll, weil entsprechende Eingaben erwartet werden (z. B. Eingabe von Zahlen, Text, URLs, Email-Adressen). Die Verwendung von inputmode
bewirkt keine automatische Browser-Validierung. Sofern sich die zu verwendende Tastatur nicht bereits aus dem type
-Attribut des Eingabefeldes ergibt, wird die Verwendung von inputmode
empfohlen, da auch Assistenztechnologien diese Information sinnvoll nutzen können, um z. B. entsprechende virtuelle Tastaturen anzuzeigen. Es sollte jedoch beachtet werden, dass das Attribut inputmode
nicht notwendige Eingabehinweise ersetzt.
Für einen Platzhalter kann das Attribut placeholder
verwendet werden. Es wird allerdings empfohlen, Eingabehinweise neben dem Feld anzuzeigen und per aria-describedby
mit dem Eingabefeld zu verknüpfen. Das placeholder
-Attribut hat folgende Nachteile:
- Die Kontraste sind häufig nicht ausreichend (entweder zum Hintergrund oder zum Text im Eingabefeld, so dass Platzhalter und Wert schlecht zu unterscheiden sind).
- Der Platzhalter wird nicht angezeigt, sobald das Feld einen Wert enthält.
Ein Eingabefeld kann als deaktiviert (disabled
) und als schreibgeschützt (readonly
) ausgezeichnet werden.
Ein Eingabefeld kann mit required
als Pflichtfeld ausgezeichnet werden.
Weitere Informationen: 4.10.5 The input element - HTML Standard (whatwg.org)
Wird das Eingabefeld nicht mit dem HTML-Element umgesetzt, sollte u. a. Folgendes beachtet werden:
- Die Rolle wird mit
role=textbox
übermittelt. - Für ein Eingabefeld, welches zur Eingabe von Suchbegriffen dient, kann
role=searchbox
verwendet werden. Die Screenreader geben das Suchfeld als normales Eingabefeld aus, d. h. die Beschriftung muss auf den Zweck, die Suche, hinweisen. - Die Beschriftung des Eingabefeldes kann per
aria-label
oderaria-labelledby
erfolgen. - Der Wert des Eingabefeldes ergibt sich aus dem Textinhalt des Elements, welches mit
role=textbox
ausgezeichnet ist. - Das Eingabefeld kann mit
aria-required
als Pflichtfeld, mitaria-disabled
als deaktiviert und mitaria-readonly
als schreibgeschützt ausgezeichnet werden. - Für einen Platzhalter wird
aria-placeholder
verwendet. - Die Darstellung des Eingabefeldes sollte im Hochkontrast-Modus von Windows überprüft werden.
- Das sichtbare Eingabefeld und das programmatisch fokussierte Element sollten die gleiche Position und Größe besitzen.
Weitere Informationen: textbox role - Accessible Rich Internet Applications (WAI-ARIA) 1.2 (w3.org) (Externer Link)