Pular para o conteúdo principal

TextField Campo de texto de uma linha

Este componente exibe um campo de texto na interface para inserir strings.

ChaveTipoDescriçãoObrigatórioValor padrãoVersão mínima
alignmentStringAlinhamento-Left-
keyboardStringTipo de teclado-Default-
placeholderStringTexto de placeholder do campoLocalizável""-
isSecureBooleanoSe os caracteres devem ser exibidos como pontos-false-
clearButtonModeStringSe o pequeno botão de limpeza deve ser exibido-Never-
maxLengthInteiroComprimento máximo do texto-INT_MAX-
validationRegexStringExpressão regular usada para validar entradas de string-nil1.2-10
promptStringTítulo da caixa de diálogoLocalizávelnil1.2-10
messageStringMensagem da caixa de diálogoLocalizávelnil1.2-10
okTitleStringTítulo do botão de confirmação da caixa de diálogoLocalizável"好"1.2-10
cancelTitleStringTítulo do botão de cancelamento da caixa de diálogoLocalizável"取消"1.2-10

Este componente não oferece suporte a icon. Se a propriedade title for definida, recomenda-se definir alignment como "Right".

Ao modificar ou adicionar uma entrada de string, ela não poderá ser salva se não passar pela validação da validationRegex, uma expressão regular.

Quando prompt ou message não estiver vazio, tocar em TextField abrirá uma caixa de diálogo que solicitará a entrada de um valor.

alignmentDescrição
LeftAlinhar à esquerda
CenterCentralizado
RightAlinhar à direita
NaturalAlinhamento natural
JustifiedJustificado
keyboardDescrição
DefaultTeclado padrão e de terceiros
AlphabetASCII padrão
ASCIICapableASCII padrão
NumbersAndPunctuationNúmeros e pontuação
URLEndereço da web
NumberPadNúmeros
PhonePadNúmero de telefone
NamePhonePadNome e número de telefone
EmailAddressE-mail
DecimalPadNúmeros com casas decimais
clearButtonModeDescrição
NeverNunca exibir
AlwaysSempre exibir
WhileEditingExibir somente durante a edição
UnlessEditingExibir somente fora da edição
Tipo retornadoDescrição
StringConteúdo do campo de texto

Tema

Chave do temaTipoDescrição
textColorCorCor do texto
caretColorCorCor do cursor
placeholderColorCorCor do placeholder

Exemplo

{
default = "";
label = "用户名";
cell = "TextField";
key = "username";
keyboard = "Default"; -- teclado padrão
alignment = "Right"; -- alinhar à direita
placeholder = "Digite o nome de usuário"; -- placeholder
maxLength = 21; -- comprimento máximo
validationRegex = "^[0-9a-zA-Z]+$"; -- validação por expressão regular
};
{
isSecure = true; -- exibir a senha como pontos
default = "";
label = "密码";
cell = "TextField";
key = "password";
keyboard = "NumberPad"; -- teclado numérico
alignment = "Right"; -- alinhar à direita
placeholder = "Digite a senha"; -- placeholder
prompt = "请输入密码"; -- título da caixa de diálogo
message = "请在提示框中输入 6 位数字密码"; -- mensagem da caixa de diálogo
validationRegex = "^[0-9]{6}$"; -- validação por expressão regular
okTitle = "保存"; -- título do botão de envio
cancelTitle = "取消"; -- título do botão de cancelamento
};

XUI-TextField.png

XUI-TextField-Prompt.png