MaskedTextField

Die MaskedTextField-Komponente bietet ein konfigurierbares Texteingabefeld, das Formatierungsregeln und Validierung durchsetzt. Es eignet sich gut für Anwendungen, die strukturierte Eingaben erfordern, wie z.B. Finanz-, E-Commerce- und Gesundheitssysteme.

Diese Komponente kann mit oder ohne Parameter instanziiert werden. Sie können einen Anfangswert, ein Label, einen Platzhaltertext und einen Listener definieren, falls sich der Wert ändert.

MaskedTextField field = new MaskedTextField("Kontonummer");
field.setMask("ZZZZ-0000")
  .setHelperText("Maske: ZZZZ-0000 - zum Beispiel: SAVE-2025")

Maskenregeln

Das MaskedTextField formatiert die Texteingabe mithilfe einer Maske - einer Zeichenkette, die definiert, welche Zeichen an jeder Position erlaubt sind. Dies sorgt für eine konsistente, strukturierte Eingabe für Dinge wie Telefonnummern, Postleitzahlen und ID-Formate.

Masken programmgesteuert anwenden

Um Zeichenfolgen mit der gleichen Maskensyntax außerhalb eines Feldes zu formatieren, beispielsweise beim Rendern von Daten in einer Tabelle, verwenden Sie die MaskDecorator Hilfsklasse.

Unterstützte Maskenzeichen

Zeichen	Beschreibung
`X`	Jedes druckbare Zeichen
`a`	Jedes alphabetische Zeichen (Groß- oder Kleinbuchstaben)
`A`	Jedes alphabetische Zeichen; Kleinbuchstaben werden in Großbuchstaben umgewandelt
`0`	Jede Ziffer (0–9)
`z`	Jede Ziffer oder Buchstabe (Groß- oder Kleinbuchstaben)
`Z`	Jede Ziffer oder Buchstabe; Kleinbuchstaben werden in Großbuchstaben umgewandelt

Alle anderen Zeichen in der Maske werden als Literale behandelt und müssen genau eingegeben werden. Zum Beispiel erfordert eine Maske wie XX@XX, dass der Benutzer ein @ in der Mitte eingibt.

Ungültige Zeichen werden stillschweigend ignoriert.
Kurze Eingaben werden mit Leerzeichen aufgefüllt.
Lange Eingaben werden abgeschnitten, um zur Maske zu passen.

Beispiele

field.setMask("(000) 000-0000");     // Beispiel: (123) 456-7890
field.setMask("A00 000");            // Beispiel: A1B 2C3 (kanadische Postleitzahl)
field.setMask("ZZZZ-0000");          // Beispiel: ABCD-1234
field.setMask("0000-0000-0000-0000");// Beispiel: 1234-5678-9012-3456

Volle Eingabe erlaubt

Wenn die Maske nur X enthält, verhält sich das Feld wie ein Standard-TextField, das jede druckbare Eingabe erlaubt. Dies ist nützlich, wenn Sie die Möglichkeit zur Formatierung ohne strenge Zeichenregeln reservieren möchten.

Code anzeigen

MaskedTextFieldView.java

Validierungsmuster

Während Masken die Struktur der Eingabe definieren, können Sie sie mit Validierungsmustern kombinieren, um spezifischere Eingaberegeln durchzusetzen. Dies fügt eine zusätzliche Schicht der clientseitigen Validierung mithilfe von regulären Ausdrücken hinzu.

Verwenden Sie die Methode setPattern(), um einen benutzerdefinierten regulären Ausdruck anzuwenden:

field.setPattern("[A-Za-z0-9]{10}"); // Erzwingt einen 10-stelligen alphanumerischen Code

Dies stellt sicher, dass die Eingabe nicht nur der Maske entspricht, sondern auch einer definierten Struktur, wie z.B. Länge oder erlaubte Zeichen, entspricht.

Dies ist besonders nützlich, wenn:

Die Maske zu viel Flexibilität zulässt.
Sie eine exakte Länge oder ein spezifisches Format (z.B. hex, Base64, UUID) durchsetzen möchten.

Format regulärer Ausdrücke

Das Muster muss ein gültiger JavaScript-regulärer Ausdruck sein, wie er vom RegExp-Typ verwendet wird. Weitere Informationen finden Sie in der Dokumentation zum HTML-Musterattribut.

Wiederherstellen des Wertes

Das MaskedTextField verfügt über eine Wiederherstellungsfunktion, die den Wert des Feldes auf einen vordefinierten oder ursprünglichen Zustand zurücksetzt. Dies kann nützlich sein, um Benutzereingaben rückgängig zu machen oder auf eine Standardsituation zurückzukehren.

field.setRestoreValue("ABC123");
field.restoreValue();

Wege zur Wiederherstellung des Wertes

Programmgesteuert, durch den Aufruf von restoreValue()
Über die Tastatur, durch Drücken von ESC (dies ist der Standard-Wiederherstellungsschlüssel, es sei denn, er wird durch einen Ereignislistener überschrieben)

Sie können den Wert, auf den wiederhergestellt werden soll, mit setRestoreValue() festlegen. Wenn kein Wiederherstellungswert festgelegt ist, kehrt das Feld zum Anfangswert zum Zeitpunkt seiner Erstellung zurück.

Code anzeigen

MaskedTextFieldRestoreView.java