Hinweis: Folgende Designerweiterungen sind für 1.1 nicht für Entwicklung und Testing vorgesehen:
Im einzeiligen Eingabefeld können Informationen eingegeben werden.
Je nach Einsatz kann das Feld mit Hinweistext und/oder einer maximalen Zeichenanzahl versehen sein. Pflichtfelder sind mit “*” (Sternchen”) nach dem Label markiert. Bei Read-Only-Feldern gibt es keine visuelle Pflichtfeldauszeichnung, auch wenn diese im Backend ggf. als Pflichtfelder geprüft werden.
Die Eingabefeldbezeichnung sollte so kurz und präzise wie möglich formuliert sein. Sollte ein Label dennoch länger sein müssen, so bricht es um und wird mehrzeilig.
Wenn eine maximale Zeichenzahl definiert wird:
Bei Erreichen der maximal erlaubten Zeichenzahl wird keine weitere Eingabe zugelassen. Bei jedem weiteren Tastenanschlag (keydown) ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
Wenn keine maximale Zeichenzahl definiert wird:
Die Standardanzahl erlaubter Zeichen beträgt 255. Da dies abhängig von der technischen Umgebung ist, kann die Anzahl aber auch variieren. Falls die eingegebene Zeichenanzahl das Zeichenlimit überschreitet, wird bei Verlassen des Feldes ein Validierungsfehler an Formularfeldern ausgelöst (siehe Formular: Validierungsfehlern an Formularfeldern). Die Fehlermeldung lautet „Maximale Zeichenanzahl überschritten: [Eingegebene Zeichen im Feld]/[technisch maximal mögliche Zeichen]”.
Das Standardverhalten für Fehlermeldungen findet Anwendung (siehe Formular: Ablauf Front-/Backend-Validierung).
Bei fehlerhaften oder fehlenden Eingaben (Ablauf siehe Formulare: Ablauf Front-/Backend-Validierung) erscheint ein Ausrufezeichen-Icon mit erklärendem Text, dieses muss als Layoutgrafik deklariert werden. Gleichzeitig ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
Die Standardfehlermeldungen bei falscher Eingabe lauten:
Details zur Anwendung der Standardfehlermeldungen sind im Meldungskonzept beschrieben (siehe Meldungskonzept: Standard-Meldungen für Formular-Validierungsfehler). Bei anderen Fehlermeldungen sind die Formulierungsregeln für Formular-Valididierungsfehler zu beachten (siehe Meldungskonzept: Formulierungsregeln für Formular-Validierungsfehler).
Das IBAN-Eingabefeld ist ein Sonderfall des einzeiligen Eingabefeldes. Es unterscheidet sich in folgendem:
Die Zeichenzahl ist auf 48 Zeichen begrenzt.
Erklärung: 34 Zeichen ist die maximale Zeichenzahl bei internationalen IBANs (bei deutschen IBANS 22 Stellen) + max. 9 Leerzeichen (für deutsche IBANS 5 Leerzeichen).
Nutzende können die IBAN mit oder ohne Leerzeichen eingeben. Buchstaben können groß oder klein geschrieben werden. Während der Eingabe wird keine Umformatierung vorgenommen.
Nach Verlassen des Feldes wird der Inhalt umformatiert:
Bei erneuten Fokuserhalt des Eingabefeldes bleiben die Leerzeichen erhalten und Nutzer:innen müssen diese ggf. händisch löschen. Wird das Feld wieder verlassen, werden erneut die Umformatierung (siehe oben) durchgeführt.
Wenn Nutzende den Feldinhalt kopieren, so wird der Wert inklusive Leerzeichen, so wie er im Feld steht, in die Zwischenablage eingefügt.
Der Speicherwert des Feldes in der Datenbank ist weiterhin der unformatierte Wert ohne Leerzeichen (ist noch technisch zu entscheiden).
Die Standardfehlermeldung bei falscher IBAN lautet, unabhängig davon, ob der Fehler durch fehlerhaftes Eingabeformat oder eine falsche Prüfsumme entsteht:
(siehe Meldungskonzept: Formular-Validierungsfehler - Standard-Meldungen)
Telefonnummern werden in einem einzeiligen Eingabefeld (ohne Umformatierungen) erfasst, dabei wird zwischen Festnetz- und Mobilfunknummer unterschieden.
Die Telefonnummer muss gemäß ISO 5008 eingetragen werden. Beim Verlassen des Feldes wird die Eingabe validiert und ggf. ein Fehler angezeigt.
Unter Festnetznummernfelder wird immer folgender Hinweistext zum Eingabeformat angezeigt: “Formatbeispiel: 030 12345-67 (nur für Deutschland) oder +31 20 1234567 (international)“. Bei Mobilfunknummernfeldern lautet der Hinweistext: “Formatbeispiel: 0171 123456 (nur für Deutschland) oder +31 6 1234567 (international)“.
Bei Bedarf kann zusätzlich zur Formatbeschreibung noch ein fachlicher Hinweistext am Feld ergänzt werden. Dieser wird mit einem Gedankenstrich getrennt vor dem Formathinweis angezeigt: “[Fachlicher Hinweis] – [Formathinweis]”.
Die Standardfehlermeldung bei falsch eingegebener Telefonnummer lautet “Falsches Eingabeformat” (siehe Meldungskonzept: Formular-Validierungsfehler - Standard-Meldungen)
Das E-Mail-Eingabefeld ist ein Sonderfall des einzeiligen Eingabefeldes. Es unterscheidet sich in folgendem:
Erlaubt ist die Eingabe von Buchstaben, Zahlen, Punkte, Bindestriche, Unterstriche und dem Sonderzeichen “@”. Die Eingabe von anderen Sonderzeichen, Leerzeichen, Akzentbuchstaben oder Buchstaben außerhalb des lateinischen Alphabets ist nicht erlaubt. Das Sonderzeichen “@” muss in der Eingabe verwendet werden, darf aber nur ein mal vorkommen. Zudem muss die E-Mail mit einer gültigen Top-Level-Domain (z.B “.de”,”.com”, “.net”) enden.
Beispiel:
Siehe [Einzeiliges Eingabefeld]
Die Standardfehlermeldung bei fehlerhafter E-Mail (z.B. durch falsche Top-Level-Domain) lautet:
(siehe Meldungskonzept: Formular-Validierungsfehler - Standard-Meldungen)
Wie im normalen einzeiligen Eingabefeld, kann hier ein beliebiger Zahlenwert eingegeben werden. Dabei wird die Einheit des einzugegenen Wertes stets als Teil des Feldlabels angegeben:
"[Feldtitel] in [Einheit]"
Pflichtfelder sind mit “*” (Sternchen) nach dem Label markiert.
Numerische Werte werden im deutschen Format eingegeben. Dabei wird "Punkt" für 1000-Trennzeichen und "Komma" für die Unterteilung in Nachkommastellen verwendet.
Falls es eine fachliche Anforderung gibt, dass Werte in eine einheitliche Form gebracht werden sollen (Beispiel: Geldbeträge immer mit zwei Nachkommastellen), dann geschieht die Umformatierung erst bei Verlassen des Feldes (siehe Eingabefeld: Verhalten bei Eingabe einer IBAN).
Für allgemeine Richtlinien zur Darstellung von Einheiten, siehe Schriften: Allgemeines zur Darstellung von Einheiten und Sonderzeichen.
Standardfehlermeldung für Zahlenfelder lauten:
Details zur Anwendung der Standardfehlermeldungen sind in den Standard-Meldungen beschrieben (siehe Meldungskonzept: Formular-Validierungsfehler - Standard-Meldungen).
Ist das zulässige Format des Eingabefeldes nicht mit den oben beschriebenen Standardmeldungen abgedeckt, z. B. nur eine Nachkommastelle zulässig oder führende Nullen erforderlich, ist dies fachlich zu beschreiben. Die Fehlermeldung setzt sich aus den oben genannten Varianten (Zahlen allgemein; nur positive Zahlen etc.) und einem aussagekräftigen Beispiel zusammen. Das Beispiel des definierten Formats ist so zu wählen, dass es zum fachlichen Kontext passt und einfach verständlich ist.:
Bei anderen Fehlermeldungen sind die Formulierungsregeln für Formular-Valididierungsfehler zu beachten (siehe Meldungskonzept: Formulierungsregeln für Formular-Validierungsfehler).
Wie im normalen einzeiligen Eingabefeld, kann hier ein beliebiger Wert eingegeben werden.
Pflichtfelder sind mit “*” (Sternchen”) nach dem Label markiert. Bei Read-Only-Feldern gibt es keine visuelle Pflichtfeldauszeichnung, auch wenn diese im Backend ggf. als Pflichtfelder geprüft werden.
Die Eingabefeldbezeichnung sollte so kurz und präzise wie möglich formuliert sein. Sollte ein Label dennoch länger sein müssen, so bricht es um und wird mehrzeilig.
Fangen Nutzende im Eingabefeld an zu Tippen, so wird nach Eingabe des ersten Zeichens eine Vorschlagliste angezeigt, sofern Werte aus der hinterlegten statischen Liste bzw. einer angebundenen Datenbanktabelle mit dem eingegebenen Wert übereinstimmen. Zwischen jeder Wertänderungen und der entsprechenden Aktualisierung der Trefferliste besteht eine Verzögerung von 400ms. So haben Nutzende die Möglichkeit, Ihre Eingabe zunächst zu beenden (statt Ausführen der Aktion bei jedem Tastendruck).
Basierend auf fachlicher Anforderung sollte definiert werden, ob eine der folgenden Suchverhalten gilt:
Falls nicht definiert gilt die Regel “Beinhaltet [Suchbegriff]”.
Der mit dem Suchbegriff übereinstimmende Textabschnitt in der Vorschlagliste ist im Schriftschnitt Bold gesetzt. Der restliche Text des Vorschlags ist in Regular gesetzt.
Sobald Ergebnisse gefunden oder aktualisiert wurden, wird vom Screenreader die Anzahl der gefundenen Einträge automatisch ausgeben. Text: “[Anzahl] Vorschläge vorhanden”
Falls die Serverabfrage für die Suche länger dauert (über 200ms), wird ein Ladezustand (loading spinner) im Dropdown angezeigt, bis Suchergebnisse vorhanden sind. Der Alternativtext des Symbols, der vom Screenreader ausgegeben wird lautet “Ergebnisse werden geladen”. Dies wird nur ausgegeben, wenn das Laden davor länger als 2 Sekunden gedauert hat und die Ergebnisse nicht vorher sichtbar wurden.
Falls das Laden noch länger dauert, wird alle 10 Sekunden erneut der Alternativtext des Ladesymbols “Ergebnisse werden geladen” ausgelesen.
Noch offen: Verhalten bei ausbleibender Server-Antwort (Hier ist vorher die technische Umsetzung zu klären)
Bei Erreichen des Maximalwerts wird keine weitere Eingabe zugelassen. Bei jedem weiteren Tastenanschlag (keydown) ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
Bei fehlerhaften oder fehlenden Eingaben (Ablauf siehe Formulare: Ablauf Front-/Backend-Validierung) erscheint ein Ausrufezeichen-Icon mit erklärendem Text. Das Icon muss als Layoutgrafik deklariert werden. Gleichzeitig ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
(Standard-)Fehlermeldungen und Formulierungsregeln für Fehlermeldungen sind identisch zum einzeiligen Eingabefeld siehe oben Fehlerfälle / Validierung Einzeiliges Eingabefeld.
Im Read-Only Status verhält sich das Element wie ein normales schreibgeschütztes Eingabefeld und die Vorschlagliste wird nicht mehr angezeigt.
Verhalten der Ausklappliste bei kleiner Bildschirmhöhe (siehe Eingabe- und Auswahlfeldern: Ausklapplisten bei kleiner Bildschirmhöhe).
Verhalten der Ausklappliste bei über 100 gefundenen Treffern (siehe Eingabe- und Auswahlfeldern: Ausklapplisten bei mehr als 100 Einträgen).
Mehrzeilige Eingabefelder wachsen mit Ihrem Inhalt. Somit ist ein Scrollen innerhalb von Eingabefeldern nie erforderlich. Die Breite wird im Layout vordefiniert und die Höhe wird durch die Textmenge bestimmt und passt sich adaptiv während der Eingabe an.
Pflichtfelder sind mit “*” (Sternchen”) nach dem Label markiert. Bei Read-Only-Feldern gibt es keine visuelle Pflichtfeldauszeichnung, auch wenn diese im Backend ggf. als Pflichtfelder geprüft werden.
Die Eingabefeldbezeichnung sollte so kurz und präzise wie möglich formuliert sein. Sollte ein Label dennoch länger sein müssen, so bricht es um und wird mehrzeilig. Das Eingabefeld vergrößert sich dann entsprechend (siehe Beispiele).
In der Regel ist eine zulässige Zeichenzahl definiert. Darüber hinaus kann kein Inhalt eingegeben werden.
Bei fehlerhaften oder fehlenden Eingaben (Ablauf siehe Formulare: Ablauf Front-/Backend-Validierung) erscheint ein Ausrufezeichen-Icon mit erklärendem Text, dieses muss als Layoutgrafik deklariert werden. Gleichzeitig ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
(Standard-)Fehlermeldungen, Formulierungsregeln für Fehlermeldungen und das Verhalten bei Erreichen einer definierten maximalen Zeichenanzahl des Feldes sind identisch mit dem einzeiligen Eingabefeld. (siehe oben Fehlerfälle / Validierung Einzeiliges Eingabefeld).
Wenn keine maximale Zeichenzahl definiert wird:
Die Standardanzahl erlaubter Zeichen beträgt in der Regel 2000. Da dies abhängig von der technischen Umgebung ist, kann die Anzahl aber auch variieren. Falls die eingegebene Zeichenanzahl das Zeichenlimit überschreitet, wird bei Verlassen des Feldes ein Validierungsfehler an Formularfeldern ausgelöst (siehe Formular: Validierungsfehlern an Formularfeldern). Die Fehlermeldung lautet „Maximale Zeichenanzahl überschritten: [Eingegebene Zeichen im Feld]/[technisch maximal mögliche Zeichen]”.
Das Standardverhalten für Fehlermeldungen findet Anwendung (siehe Formular: Ablauf Front-/Backend-Validierung).
Im Read-Only-Zustand passt sich die Feldhöhe dem eingegebenen Inhalt an, so dass zum einen der komplette Text lesbar ist, zum anderen keine optischen Lücken in Formularen entstehen, wenn wenig Text eingegeben wurde.
Wenn bei Feldern die Eingabe aktuell nicht möglich ist wird der Disabled Status verwendet.
Read-Only Felder kommen zum Einsatz, wenn nur Informationen dargestellt werden, diese aber nicht veränderbar sind.
Das Ausrufezeichen-Symbol, bei fehlerhafter Eingabe, muss als Layoutgrafik deklariert werden. Gleichzeitig ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
Das Ausrufezeichen bei fehlerhafter Eingabe in mehrzeiligen Eingabefeldern muss als Layoutgrafik deklariert werden. Gleichzeitig ertönt ein akustisches Signal: Fehlermeldung (siehe akustische Signale).
Screenreaderausgabe einer Telefonnummer
Der Screenreader muss im Formatbeispiel die Nummer inklusive Lehrzeichen ausgeben.