Saltar al contenido principal

TextField Campo de texto de una línea

Este componente muestra un campo de texto en la interfaz para introducir una cadena.

ClaveTipoDescripciónObligatorioValor predeterminadoVersión mínima requerida
alignmentcadenaAlineación-Left-
keyboardcadenaTipo de teclado-Default-
placeholdercadenaMarcador de posición del campo de textolocalizable""-
isSecurebooleanoSi los caracteres se muestran como puntos-false-
clearButtonModecadenaSi se muestra el pequeño botón de borrado-Never-
maxLengthenteroLongitud máxima del texto-INT_MAX-
validationRegexcadenaExpresión regular para validar las entradas de cadena-nil1.2-10
promptcadenaTítulo del cuadro de diálogolocalizablenil1.2-10
messagecadenaMensaje del cuadro de diálogolocalizablenil1.2-10
okTitlecadenaTítulo del botón de confirmación del cuadro de diálogolocalizable"好"1.2-10
cancelTitlecadenaTítulo del botón de cancelación del cuadro de diálogolocalizable"取消"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.

alignmentDescripción
LeftAlineado a la izquierda
CenterCentrado
RightAlineado a la derecha
NaturalAlineación natural
JustifiedJustificado
keyboardDescripción
DefaultTeclado estándar y de terceros
AlphabetASCII estándar
ASCIICapableASCII estándar
NumbersAndPunctuationNúmeros y puntuación
URLDirección web
NumberPadNúmeros
PhonePadNúmero de teléfono
NamePhonePadNombre y número de teléfono
EmailAddressCorreo electrónico
DecimalPadNúmeros con decimales
clearButtonModeDescripción
NeverNunca se muestra
AlwaysSiempre se muestra
WhileEditingSolo se muestra al editar
UnlessEditingSolo se muestra cuando no se edita
Tipo de retornoDescripción
cadenaContenido del campo de texto

Tema

Clave del temaTipoDescripción
textColorcolorColor del texto
caretColorcolorColor del cursor
placeholderColorcolorColor 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
};

XUI-TextField.png

XUI-TextField-Prompt.png