Überblick

Das Telefonnummern-Eingabefeld ermöglicht die Eingabe von Telefonnummern mit intuitiver Länderauswahl, automatischer Formatierung und länderbasierter Validierung. Das Eingabefeld lässt sich flexibel konfigurieren (Default-Land, Whitelist, International-Option, Read-only, mehrsprachige Fehlermeldungen / Placeholders) und ist in der Micro-App im Terminal und in der Driver-PWA einsetzbar.

Bestehende Micro-Apps funktionieren ohne Anpassungen weiter. Um neue Funktionen wie Länder-Vorauswahl, Whitelist, International-Option zu nutzen, muss die Phone-Element-Konfiguration aktualisiert werden.

Wesentliche Vorteile

• Schnellere Eingabe durch Flaggen-Dropdown mit Suche nach Name, ISO-Code und internationeler Vorwahlnummer (z. B. +49)
• Korrekte Formatierung im internationalen Modus und strenge Validierung pro Land
• Mehrsprachige Labels, Placeholder und Fehlermeldungen möglich
• Konfigurierbare Voreinstellungen und Ländereinschränkungen
• Stabileres Verhalten bei virtuellen Tastaturen

Funktionsumfang

Länderauswahl

• Dropdownliste mit SVG-Landesflaggen und Ländercodes (z. B. +49) verfügbar
• Suche nach Ländername, ISO-Kürzel oder Vorwahl (z. B. +49) möglich

• Automatische Voreinstellung des Landes anhand der App-Sprache, z. B. de → Deutschland
• Eine manuelle Änderung des Landes ist jederzeit möglich
• Optional kann die Auswahl auf bestimmte Länder beschränkt werden

Eingabe & Validierung

• Es gibt ein Kombiniertes Feld für Länderauswahl und Nummer (kein separates Feld)

• Automatische Formatierung im internationalen Format (z. B. +49 XXXX XXXXX)
• Tolerante Eingabe
  • Leerzeichen und Bindestriche werden intern normalisiert und führen zu keinen Fehlern
• Verbesserungen für virtuelle Tastaturen
  • Die Eingabe wird nicht mehr durch ein + blockiert
• Die eingegebene Telefonnummer wird in Echtzeit anhand der länderspezifischen Regeln (Länge, Startziffern, Struktur) geprüft
  • Ungültige Nummern werden sofort mit einer Fehlermeldung angezeigt
  • Optional können eigene mehrsprachige Fehlermeldungen ausgegeben werden
• Der Nutzer kann das Land jederzeit ändern, optional ist auch eine „International“-Option verfügbar
  • Die Komponente erkennt anhand der eingegebenen Vorwahl automatisch das korrekte Land, sobald weiter Daten eingegeben werden

📘

Nationale Eingabemasken mit sichtbarer Ländervorwahl sind nicht umgesetzt worden. Die internationale Formatierung deckt dieses ab.

📘

Ein Wechsel des Landes setzt die Telefonnummer zurück.

📘

Bei der Sprachauswahl „en" wird die US-Flagge angezeigt, nicht die UK-Flagge. Dies entspricht dem Standardverhalten der Library.