Masken

Masken werden mithilfe der IMask Bibliothek auf Textfelder angewendet.

Um eine Maske zu setzen verwendet man die Mask() Methode;

Elements.Person.Add.Property("TelephoneNumber", MetaType.Text)
        .Mask("+41 00-000-00-00");

Diese Maske kann für Telefonnummern verwendet werden, wichtig ist noch, dass so nur der unmaskierte Wert auf der Datenbank landet; +41 78-123-12-12 → 781231212 Im Client wird das jedoch überall wieder Formatiert dargestellt.

Für die Maskierung gibt es folgende Definitionen;

0 → Eine Ziffer von 0-9.
a → grosse und kleine Buchstaben.
* → Alle möglichen Zeichen.
A → Hexadezimale Zeichen (0-9,A-F,a-f). (CommonUI Spezifisch)

Alle anderen Zeichen werden als Fixiert erkannt.
Falls ein Zeichen einer Definition als fixiertes Zeichen interpretiert werden soll, kann man es mithilfe \\ fixieren. z.B.: \\0

[] → Optionaler Teil definieren. z.B.: 000.000[.000]
{} → In unmaskiertem Wert einbinden. z.B.: {00.00.00} (Somit werden die Punkte auch in der Datenbank gespeichert.)

Weitere Dokumentation dazu kann auf der IMask Seite gefunden werden; https://imask.js.org/guide.html#masked-pattern

Bezüglich dem Verhalten ist der Überschreibungsmodus auf ersetzen gestellt, ausserdem werden Platzhalter immer angezeigt.