TextField

Affiche un champ de texte sur une ligne pour saisir une chaîne.

Clé	Type	Description	Obligatoire	Valeur par défaut	Version minimale requise
alignment	string	Alignement du texte	-	`Left`	-
keyboard	string	Type de clavier	-	`Default`	-
placeholder	string	Espace réservé du champ	Localisable	`""`	-
isSecure	boolean	Masquer les caractères par des points	-	`false`	-
clearButtonMode	string	Afficher le bouton d’effacement	-	`Never`	-
maxLength	integer	Longueur maximale du texte	-	`INT_MAX`	-
validationRegex	string	Expression régulière servant à valider la saisie	-	`nil`	1.2-10
prompt	string	Titre de la boîte de dialogue	Localisable	`nil`	1.2-10
message	string	Message de la boîte de dialogue	Localisable	`nil`	1.2-10
okTitle	string	Titre du bouton de confirmation	Localisable	`"好"`	1.2-10
cancelTitle	string	Titre du bouton d’annulation	Localisable	`"取消"`	1.2-10

Ce composant ne prend pas en charge icon. Si title est défini, il est recommandé de définir alignment sur « Right ».

Lors de la modification ou de l’ajout d’une chaîne, celle-ci ne peut pas être enregistrée si elle ne correspond pas à l’expression régulière validationRegex.

Si prompt ou message n’est pas vide, toucher TextField affiche une boîte de dialogue demandant la saisie.

alignment	Description
Left	À gauche
Center	Centré
Right	À droite
Natural	Naturel
Justified	Justifié

keyboard	Description
Default	Claviers standard et tiers
Alphabet	ASCII standard
ASCIICapable	ASCII standard
NumbersAndPunctuation	Chiffres et ponctuation
URL	Adresse web
NumberPad	Pavé numérique
PhonePad	Pavé téléphonique
NamePhonePad	Nom et téléphone
EmailAddress	Adresse e-mail
DecimalPad	Chiffres avec séparateur décimal

clearButtonMode	Description
Never	Jamais
Always	Toujours
WhileEditing	Pendant la modification
UnlessEditing	Sauf pendant la modification

Type de retour	Description
string	Valeur du champ de texte

Thème

Clé de thème	Type	Description
textColor	Color	Couleur du texte
caretColor	Color	Couleur du curseur
placeholderColor	Color	Couleur de l’espace réservé

Exemple

{
    default = "";
    label = "用户名";
    cell = "TextField";
    key = "username";
    keyboard = "Default";  -- Clavier par défaut
    alignment = "Right";  -- Aligné à droite
    placeholder = "输入用户名";  -- Espace réservé
    maxLength = 21;  -- Longueur maximale
    validationRegex = "^[0-9a-zA-Z]+$";  -- Validation par expression régulière
};
{
    isSecure = true;  -- Saisie de mot de passe masquée par des points
    default = "";
    label = "密码";
    cell = "TextField";
    key = "password";
    keyboard = "NumberPad";  -- Pavé numérique
    alignment = "Right";  -- Aligné à droite
    placeholder = "输入密码";  -- Espace réservé
    prompt = "请输入密码";  -- Titre de la boîte de dialogue
    message = "请在提示框中输入 6 位数字密码";  -- Message de la boîte de dialogue
    validationRegex = "^[0-9]{6}$";  -- Validation par expression régulière
    okTitle = "保存";  -- Titre du bouton de validation
    cancelTitle = "取消";  -- Titre du bouton d’annulation
};

Thème

Exemple​

Exemple