TextField Campo de texto de uma linha
Este componente exibe um campo de texto na interface para inserir strings.
| Chave | Tipo | Descrição | Obrigatório | Valor padrão | Versão mínima |
|---|---|---|---|---|---|
| alignment | String | Alinhamento | - | Left | - |
| keyboard | String | Tipo de teclado | - | Default | - |
| placeholder | String | Texto de placeholder do campo | Localizável | "" | - |
| isSecure | Booleano | Se os caracteres devem ser exibidos como pontos | - | false | - |
| clearButtonMode | String | Se o pequeno botão de limpeza deve ser exibido | - | Never | - |
| maxLength | Inteiro | Comprimento máximo do texto | - | INT_MAX | - |
| validationRegex | String | Expressão regular usada para validar entradas de string | - | nil | 1.2-10 |
| prompt | String | Título da caixa de diálogo | Localizável | nil | 1.2-10 |
| message | String | Mensagem da caixa de diálogo | Localizável | nil | 1.2-10 |
| okTitle | String | Título do botão de confirmação da caixa de diálogo | Localizável | "好" | 1.2-10 |
| cancelTitle | String | Título do botão de cancelamento da caixa de diálogo | Localizá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.
| alignment | Descrição |
|---|---|
| Left | Alinhar à esquerda |
| Center | Centralizado |
| Right | Alinhar à direita |
| Natural | Alinhamento natural |
| Justified | Justificado |
| keyboard | Descrição |
|---|---|
| Default | Teclado padrão e de terceiros |
| Alphabet | ASCII padrão |
| ASCIICapable | ASCII padrão |
| NumbersAndPunctuation | Números e pontuação |
| URL | Endereço da web |
| NumberPad | Números |
| PhonePad | Número de telefone |
| NamePhonePad | Nome e número de telefone |
| EmailAddress | |
| DecimalPad | Números com casas decimais |
| clearButtonMode | Descrição |
|---|---|
| Never | Nunca exibir |
| Always | Sempre exibir |
| WhileEditing | Exibir somente durante a edição |
| UnlessEditing | Exibir somente fora da edição |
| Tipo retornado | Descrição |
|---|---|
| String | Conteúdo do campo de texto |
Tema
| Chave do tema | Tipo | Descrição |
|---|---|---|
| textColor | Cor | Cor do texto |
| caretColor | Cor | Cor do cursor |
| placeholderColor | Cor | Cor 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
};

