TextField Campo de texto de una línea
Este componente muestra un campo de texto en la interfaz para introducir una cadena.
| Clave | Tipo | Descripción | Obligatorio | Valor predeterminado | Versión mínima requerida |
|---|---|---|---|---|---|
| alignment | cadena | Alineación | - | Left | - |
| keyboard | cadena | Tipo de teclado | - | Default | - |
| placeholder | cadena | Marcador de posición del campo de texto | localizable | "" | - |
| isSecure | booleano | Si los caracteres se muestran como puntos | - | false | - |
| clearButtonMode | cadena | Si se muestra el pequeño botón de borrado | - | Never | - |
| maxLength | entero | Longitud máxima del texto | - | INT_MAX | - |
| validationRegex | cadena | Expresión regular para validar las entradas de cadena | - | nil | 1.2-10 |
| prompt | cadena | Título del cuadro de diálogo | localizable | nil | 1.2-10 |
| message | cadena | Mensaje del cuadro de diálogo | localizable | nil | 1.2-10 |
| okTitle | cadena | Título del botón de confirmación del cuadro de diálogo | localizable | "好" | 1.2-10 |
| cancelTitle | cadena | Título del botón de cancelación del cuadro de diálogo | localizable | "取消" | 1.2-10 |
Este componente no admite icon. Si estableces la propiedad title, se recomienda establecer la propiedad alignment en "Right".
Al modificar o añadir una entrada de cadena, si esta no supera la expresión regular validationRegex, no se puede guardar la entrada actual.
Cuando prompt o message no están vacíos, al pulsar brevemente TextField aparece un cuadro de diálogo que solicita introducir un valor.
| alignment | Descripción |
|---|---|
| Left | Alineado a la izquierda |
| Center | Centrado |
| Right | Alineado a la derecha |
| Natural | Alineación natural |
| Justified | Justificado |
| keyboard | Descripción |
|---|---|
| Default | Teclado estándar y de terceros |
| Alphabet | ASCII estándar |
| ASCIICapable | ASCII estándar |
| NumbersAndPunctuation | Números y puntuación |
| URL | Dirección web |
| NumberPad | Números |
| PhonePad | Número de teléfono |
| NamePhonePad | Nombre y número de teléfono |
| EmailAddress | Correo electrónico |
| DecimalPad | Números con decimales |
| clearButtonMode | Descripción |
|---|---|
| Never | Nunca se muestra |
| Always | Siempre se muestra |
| WhileEditing | Solo se muestra al editar |
| UnlessEditing | Solo se muestra cuando no se edita |
| Tipo de retorno | Descripción |
|---|---|
| cadena | Contenido del campo de texto |
Tema
| Clave del tema | Tipo | Descripción |
|---|---|---|
| textColor | color | Color del texto |
| caretColor | color | Color del cursor |
| placeholderColor | color | Color del marcador de posición |
Ejemplo
{
default = "";
label = "用户名";
cell = "TextField";
key = "username";
keyboard = "Default"; -- Teclado predeterminado
alignment = "Right"; -- Alineado a la derecha
placeholder = "输入用户名"; -- Marcador de posición
maxLength = 21; -- Longitud máxima
validationRegex = "^[0-9a-zA-Z]+$"; -- Validación mediante expresión regular
};
{
isSecure = true; -- Mostrar la entrada de contraseña como puntos
default = "";
label = "密码";
cell = "TextField";
key = "password";
keyboard = "NumberPad"; -- Teclado numérico
alignment = "Right"; -- Alineado a la derecha
placeholder = "输入密码"; -- Marcador de posición
prompt = "请输入密码"; -- Título del cuadro de diálogo
message = "请在提示框中输入 6 位数字密码"; -- Mensaje del cuadro de diálogo
validationRegex = "^[0-9]{6}$"; -- Validación mediante expresión regular
okTitle = "保存"; -- Título del botón de envío
cancelTitle = "取消"; -- Título del botón de cancelación
};

