Dieses Kommando erweitert das normale HTML input, so dass damit einfache Eingabefelder verschiedener Art erzeugt werden können.
Parameter:
(zusätzlich zu den HTML Standard Parametern)
- Feld: Hier wird das DLE Feld angegeben werden, das den Wert enthalten soll. Dabei ist die Darstellung und Funktionsweise des Feldes abhängig vom Datentyp des Feldes. Bei Datum und Datum/Zeit Feldern wird automatisch eine Kalenderauswahl hinzugefügt. Bei Numerischen Feldern wird die Eingabe auf gültige numerische Werte überprüft und die Eingabe landesspezifisch angepasst. Bei Feldern, die mit einer Nachschlagetabelle (Lookup) versehen sind, wird eine entsprechende Auswahlmöglichkeit hinzugefügt.
- Maskierung: Hier kann für ein Nummer-, Datums- oder Datum/Zeit-Feld eine Maskierung angegeben werden. Dadurch werden Werte bzw. auch Eingaben in diesem Format maskiert. Möglich sind z.B. Nummernformattierungen wie #,##0.00 oder 0.00# sowie Datumsformattierungen wie dd-MM-yyyy oder d.M.yy usw.
- Keyboard Shortcuts für Datumsfeld:
- Bild hoch/runter ... vorheriger/nächster Monat
- Strg+Bild hoch/runter ... vorheriges/nächstes Jahr
- Strg +links/rechts ... vorheriger/nächster Tag
- Strg +Hoch/runter ... vorherige/nächste Woche
- Enter ... Ausgewähltes Datum übernehmen
- Strg +Ende ... Schließen und Datum löschen
- ESC ... Schließen ohne Wertübernahme
- Erweiterte Funktionen für Datumsfelder:
- +1d ... aktuelles Datum + 1 Tag
- +2w ... aktuelles Datum + 2 Wochen
- +4j ... aktuelles Datum + 4 Jahre
- +1d +1m ... aktuelles Datum + 1 Tag sowie 1 Monat
- Vorschlag: Optional kann das Eingabefeld mit einer Voreingabe versehen werden.
- Musseingabe: Mögliche Werte sind Muss, Kann oder Anzeigen. Bei Muss wird die Eingabe als Pflichtfeld definiert, eine leere Eingabe ist nicht möglich. Bei Kann ist die Eingabe optional und bei Anzeige kann die Eingabe nicht geändert werden.
- Max Zeichen: Die Länge in Anzahl Zeichen (annähernd) des Eingabefeldes.
- Where-Bedingung: Bei Nachschlagetabellen kann hier eine zusätzliche Where-Bedingung zur Selektion der Werte angegeben werden.
- Passwort-Feld: Bei Ja wird die Eingabe als Passworteingabe behandelt, d.h. die Eingabe ist im Formular nicht im Klartext sichtbar.
- Zeilen: Bei mehr als einer Eingabezeile wird aus dem Eingabefeld eine mehrzeilige Eingabe erstellt (Textarea). Die Anzahl der Zeilen bestimmt die Höhe des Eingabefeldes, werden mehr Zeilen eingegeben, wird eine Scrollbar erstellt.
Weitere Funktionen
Für Lookupfelder kann mittels dem HTML Attribut "data-dle-lookup-min" eine minimale Input Länge angegeben werden. data-dle-lookup-min="2 bewirkt, dass erst nach dem 2. Zeichen gesucht wird.
Neu ab DLE Version 1.6.32
Ab DLE Version 1.6.32 können für Datum/Datum-Zeit Felder auch spezifische Parameter übergeben werden ,welche den Parametern von jQuery UI entsprechen:
Das zusätzliche HTML Attribut "dle-picker-options" ist hierfür zuständig:
Bsp: dle-picker-options="{minDate: new Date()}"
(Es kann kein älteres Datum ausgewählt werden als das heutige)
Referenz: https://api.jqueryui.com/datepicker/
Es kann für Zeitfelder auch eine Feldmaskierung erstellt werden - somit bewirkt man, dass die Zeitangaben immer in einem korrekten Format gemacht werden.
Hierzu muss einfach die CSS-Klasse "dle-input-time" beim Eingabefeld ergänzt werden.
Auch hier können benutzerspezifische Parameter gesetzt werden mittels dem zusätzlichen HTML Parameter "dle-time-options"
Bsp: dle-time-options="{show24Hours: false}"
(Es wird das amerikanische Zeitformat mit AM/PM anzeige aktiviert)
Referenz: http://keith-wood.name/timeentry.html