TextField – einzeiliges Textfeld

Diese Komponente zeigt ein Textfeld zur Eingabe einer Zeichenfolge an.

Schlüssel	Typ	Beschreibung	Erforderlich	Standardwert	Minimale Version
alignment	Zeichenfolge	Ausrichtung	-	`Left`	-
keyboard	Zeichenfolge	Tastaturtyp	-	`Default`	-
placeholder	Zeichenfolge	Platzhalter des Textfelds	Lokalisierbar	`""`	-
isSecure	Boolescher Wert	Ob Zeichen als Punkte angezeigt werden	-	`false`	-
clearButtonMode	Zeichenfolge	Ob das kleine schwarze Lösch-X angezeigt wird	-	`Never`	-
maxLength	Ganzzahl	Maximale Textlänge	-	`INT_MAX`	-
validationRegex	Zeichenfolge	Regulärer Ausdruck zur Validierung des Zeichenfolgeneintrags	-	`nil`	1.2-10
prompt	Zeichenfolge	Titel des Hinweisdialogs	Lokalisierbar	`nil`	1.2-10
message	Zeichenfolge	Text des Hinweisdialogs	Lokalisierbar	`nil`	1.2-10
okTitle	Zeichenfolge	Titel der Bestätigungsschaltfläche des Hinweisdialogs	Lokalisierbar	`"好"`	1.2-10
cancelTitle	Zeichenfolge	Titel der Abbrechen-Schaltfläche des Hinweisdialogs	Lokalisierbar	`"取消"`	1.2-10

Diese Komponente unterstützt icon nicht. Wenn die Eigenschaft title festgelegt wird, sollte alignment auf "Right" gesetzt werden.

Beim Ändern oder Hinzufügen eines Zeichenfolgeneintrags kann der aktuelle Eintrag nicht gespeichert werden, wenn die Zeichenfolge die Validierung durch den regulären Ausdruck validationRegex nicht besteht.

Wenn prompt oder message nicht leer ist, öffnet ein Tippen auf TextField einen Hinweisdialog und fordert zur Eingabe eines Werts auf.

alignment	Beschreibung
Left	Linksbündig
Center	Zentriert
Right	Rechtsbündig
Natural	Natürliche Ausrichtung
Justified	Blocksatz

keyboard	Beschreibung
Default	Standard- und Drittanbietertastatur
Alphabet	Standard-ASCII-Tastatur
ASCIICapable	Standard-ASCII-Tastatur
NumbersAndPunctuation	Zahlen und Satzzeichen
URL	Webadresse
NumberPad	Zahlen
PhonePad	Telefonnummer
NamePhonePad	Name und Telefonnummer
EmailAddress	E-Mail-Adresse
DecimalPad	Zahlen mit Dezimalpunkt

clearButtonMode	Beschreibung
Never	Nie anzeigen
Always	Immer anzeigen
WhileEditing	Nur beim Bearbeiten anzeigen
UnlessEditing	Nur außerhalb des Bearbeitens anzeigen

Rückgabetyp	Beschreibung
Zeichenfolge	Inhalt des Textfelds

Theme

Theme-Schlüssel	Typ	Beschreibung
textColor	Farbe	Textfarbe
caretColor	Farbe	Cursorfarbe
placeholderColor	Farbe	Farbe des Platzhalters

Beispiel

{
    default = "";
    label = "用户名";
    cell = "TextField";
    key = "username";
    keyboard = "Default";  -- Standardtastatur
    alignment = "Right";  -- Rechtsbündig
    placeholder = "输入用户名";  -- Platzhalter
    maxLength = 21;  -- Maximale Länge
    validationRegex = "^[0-9a-zA-Z]+$";  -- Reguläre Validierung
};
{
    isSecure = true;  -- Passworteingabe als Punkte anzeigen
    default = "";
    label = "密码";
    cell = "TextField";
    key = "password";
    keyboard = "NumberPad";  -- Ziffernblock
    alignment = "Right";  -- Rechtsbündig
    placeholder = "输入密码";  -- Platzhalter
    prompt = "请输入密码";  -- Dialogtitel
    message = "请在提示框中输入 6 位数字密码";  -- Dialogtext
    validationRegex = "^[0-9]{6}$";  -- Reguläre Validierung
    okTitle = "保存";  -- Titel der Bestätigungsschaltfläche
    cancelTitle = "取消";  -- Titel der Abbrechen-Schaltfläche
};

Theme

Beispiel​

Beispiel