Mit dem Widget 'DojoTextField' wird ein Textfeld definiert, das eine einzelne Textzeile enthält. Dieses Widget basiert auf der Definition für 'Dojo dijit.form.ValidationTextBox'.
Die unterstützten Eigenschaften sind nachfolgend aufgeführt:
- constraints
- Ein Wörterverzeichnis, das als Argument beim Aufrufen von Funktionen verwendet wird,
mit denen die Benutzereingabe validiert wird. Diese Funktionen werden durch die Eigenschaft validators referenziert
und als Validatorfunktionen bezeichnet.
Der Inhalt des Wörterverzeichnisses entspricht den jeweiligen Geschäftsanforderungen. Beispiel für eine Zuweisung:
constraints = new Dictionary{timeFormat = "hh:mm:ss"}
In diesem Fall
gibt eine Validatorfunktion möglicherweise eine Fehlernachricht zurück, falls die Benutzereingabe
nicht so formatiert ist, dass die Stunden, Minuten und Sekunden mit Doppelpunkten als Trennzeichen angegeben sind.
- inputRequired
- Ein boolescher Wert, der angibt, ob eine Eingabe erforderlich ist. Die Fehlernachricht ist in diesem Fall der Wert der Eigenschaft inputRequiredMessage.
Diese Validierung wird vor allen anderen Validierungen durchgeführt,
ist jedoch nur aktiv, wenn das Feld den Fokus erhält, nachdem es den Fokus zuvor verloren hat.
- inputRequiredMessage
- Eine Zeichenfolge, die angezeigt wird, wenn die Eigenschaft InputRequired
den Wert 'true' aufweist, das Textfeld keinen Inhalt aufweist und das Feld
den Fokus erhält, nachdem es den Fokus zuvor verloren hat. Die Nachricht wird in einem bereitgestellten Ausgabefeld angezeigt.
Wenn die Eigenschaft inputRequiredMessage nicht vorhanden ist,
besteht die Fehlernachricht aus der folgenden Zeichenfolge (je nach Ländereinstellung):
"Dieser Wert ist erforderlich.".
Anmerkung: Zum Festlegen der im Rich UI-Editor verwendeten Ländereinstellungen lesen Sie die Anweisungen
für die Registerkarte 'Sprachen' in 'Benutzervorgaben für Rich UI-Darstellung definieren'.
Informationen zum Festlegen der Laufzeitländereinstellung bei der Implementierung
finden Sie in 'Rich UI-Implementierungseinträge im EGL-Implementierungsdeskriptor hinzufügen'.
- maxLength
- Die maximale Anzahl von Zeichen, die in das Feld eingegeben werden können.
- placeholder
- Eine Zeichenfolge, die im Dojo-Textfeld angezeigt wird,
die jedoch entfernt wird, sobald der Benutzer in das Feld klickt. Die Zeichenfolge wird im Feld erneut angezeigt, sobald es leer ist und der Benutzer es nicht bearbeitet.
- promptMessage
- Eine Zeichenfolge, die den Benutzer zu einer Eingabe auffordert. Wenn das Textfeld den Fokus erhält, wird die Zeichenfolge neben dem Feld
in einem bereitgestellten Ausgabefeld so lange angezeigt, bis der Benutzer Inhalt hinzufügt oder ändert. Mit der Eigenschaft tooltipPosition können Sie die Zeichenfolgeposition
zusätzlich definieren.
- readOnly
- Ein boolescher Wert, der angibt, ob das Textfeld vor Benutzereingaben geschützt ist.
- selectOnClick
- Ein boolescher Wert, der angibt, welche Aktion ausgeführt wird, wenn der Benutzer
von außerhalb des Textfelds in das Textfeld klickt:
- False (Standardwert)
- Der Inhalt des Textfelds wird nicht ausgewählt. Der Aktualisierungscursor wird an der Klickposition angezeigt.
- True
- Der Inhalt des Textfelds wird ausgewählt. Jeder nachfolgende Mausklick zeigt den Aktualisierungscursor an der Klickposition an
und der Inhalt des Textfelds wird nicht mehr ausgewählt.
- text
- Der Zeichenfolgeinhalt des Dojo-Textfelds.
- textCase
- Eine Zeichenfolgekonstante, die angibt, wie die Groß-/Kleinschreibung der Eingabe gehandhabt wird,
wenn der Benutzer das Eingeben des Texts beendet hat und zu einem anderen Feld navigiert.
Einer der folgenden Werte:
- CASE_NONE (Standardwert)
- Die vom Benutzer eingegebene Zeichenfolge wird unverändert übernommen.
- UPPER_CASE
- Die vom Benutzer eingegebene Zeichenfolge wird in Großbuchstaben umgesetzt.
- LOWER_CASE
- Die vom Benutzer eingegebene Zeichenfolge wird in Kleinbuchstaben umgesetzt.
- PROPER_CASE
- Der erste Buchstabe in jedem Wort wird in Großschreibung umgesetzt, einer Überschrift entsprechend.
- tooltipPosition
- Ein Array mit Zeichenfolgekonstanten, die eine Folge von Nachrichtenpositionen
in absteigender Reihenfolge der Präferenz angeben.
Der EGL-Laufzeitcode versucht die Verarbeitung nacheinander mit jeder der Konstanten im Array. Die Nachricht wird einer der Konstanten im Array entsprechend angezeigt, es sei denn,
der Platz im Fenster oder Schiebebereich ist nicht ausreichend. Wenn nicht genügend Platz verfügbar ist, versucht der Handler die Anzeige mit der
durch die nächste Konstante im Array angegebenen Richtung.
Die gültigen Konstanten sind nachfolgend aufgeführt:
- TOOLTIP_AFTER
- Die Nachricht wird rechts vom Textfeld angezeigt.
- TOOLTIP_BEFORE
- Die Nachricht wird links vom Textfeld angezeigt.
- TOOLTIP_ABOVE
- Die Nachricht wird oberhalb des Textfelds angezeigt.
- BELOW
- Die Nachricht wird unterhalb des Textfelds angezeigt.
Wenn aus Platzgründen keiner der Werte verwendet werden kann,
wird die Nachricht auf dem Feld angezeigt.
Wenn Sie keine Werte angeben, wird für tooltipPosition
der Wert [DojoLib.AFTER, DojoLib.BEFORE] verwendet.
- trim
- Ein boolescher Wert, der angibt, ob führende und abschließende Leerzeichen entfernt werden,
wenn der Benutzer das Eingeben des Texts beendet hat und zu einem anderen Feld navigiert.
- validators
- Ein Array mit Validatorfunktionen, die in der Reihenfolge der Array-Elemente
als Reaktion auf jede Tastatureingabe des Benutzers aufgerufen werden. Wenn die Benutzereingabe die Validierung in einer bestimmten Funktion bestanden hat,
gibt diese Funktion den Erfolg durch Rückgabe eines Nullwerts oder Leerwerts an;
nur in diesem Fall wird die nächste Funktion im Array aufgerufen. Wenn die Benutzereingabe die Validierung nicht bestanden hat, gibt die Funktion das Fehlschlagen
durch Rückgabe einer Zeichenfolge an, die nicht null oder leer ist.
Die Folge der Validatorfunktionen wird bei jeder Tastatureingabe aufgerufen.
Wenn das Dojo-Textfeld durch einen Controller referenziert wird,
können Sie - unabhängig von den hier beschriebenen Funktionen - controllerspezifische Validatorfunktionen codieren. Die controllerspezifischen Funkionen werden nur aufgerufen, wenn die feldspezifische Validierung erfolgreich
ist, und nur, nachdem das Widget den Fokus verliert.
Details zu Controllern finden Sie in 'Rich UI - Validierung und Formatierung'.
Jede der feldspezifischen Validatorfunktionen entspricht dem folgenden 'Delegate'-Abschnitt:
Delegate Validator(input String in, constraints dictionary in)
returns(string?) end
- input
- Die gesamte Benutzereingabe, einschließlich der Zeichen einer früheren Tastatureingabe
im selben Dojo-Textfeld.
- constraints
- Ein Wörterverzeichnis, das Informationen zur Erstellung eines regulären Ausdrucks
oder zur Steuerung der Verarbeitung innerhalb der Validatorfunktionen bereitstellt.
So kann das Wörterverzeichnis beispielsweise die Sicherheitsstufe des Benutzers angeben.
- string?
- Ein Nullwert oder ein Leerwert (falls kein Fehler auftrat) oder eine Zeichenfolge,
die nicht null oder leer ist (falls ein Fehler auftrat).
Sie können von Ihrer Validatorfunktion aus eine oder mehrere der
Funktionen aufrufen, die in der DojoLib-Bibliothek zur Verfügung stehen.
Die folgenden Funktionen sind für die EGL-Dojo-Widgettypen spezifisch,
die die Validierung auf Ansichtsebene unterstützen. Eine Liste finden Sie in
'Rich UI - Validierung und Formatierung'.
- getValidState
- Ausschließlich zur internen Verwendung.
- showErrorIndicator
- Akzeptiert einen booleschen Wert, der den Fehlerindikator im Widget aktiviert oder inaktiviert. Der Funktionsprototyp lautet wie folgt:
function showErrorIndicator(aboolean boolean in);
- showErrorMessage
- Akzeptiert eine Fehlernachricht zur Anzeige in der Fehlernachricht-QuickInfo neben dem Widget. Die QuickInfo wird angezeigt, wenn das Widget den Fokus erhält,
und ausgeblendet, wenn das Widget den Fokus verliert. Der Funktionsprototyp lautet wie folgt:
function showErrorMessage(msg string in);
Weitere unterstützte Eigenschaften und Funktionen sind in
'Widgeteigenschaften und -funktionen' sowie in 'Widgetstile' beschrieben.