TextField — однострочное текстовое поле
Этот компонент отображает в интерфейсе текстовое поле для ввода строки.
| Ключ | Тип | Описание | Обязателен | Значение по умолчанию | Минимальная версия |
|---|---|---|---|---|---|
| alignment | строка | Выравнивание | - | Left | - |
| keyboard | строка | Тип клавиатуры | - | Default | - |
| placeholder | строка | Заполнитель текстового поля | локализуемый | "" | - |
| isSecure | логическое значение | Отображать ли символы в виде маленьких точек | - | false | - |
| clearButtonMode | строка | Показывать ли чёрный крестик очистки | - | Never | - |
| maxLength | целое число | Максимальная длина текста | - | INT_MAX | - |
| validationRegex | строка | Регулярное выражение для проверки введённой строки | - | nil | 1.2-10 |
| prompt | строка | Заголовок диалогового окна | локализуемый | nil | 1.2-10 |
| message | строка | Текст диалогового окна | локализуемый | nil | 1.2-10 |
| okTitle | строка | Заголовок кнопки подтверждения в диалоговом окне | локализуемый | "好" | 1.2-10 |
| cancelTitle | строка | Заголовок кнопки отмены в диалоговом окне | локализуемый | "取消" | 1.2-10 |
Этот компонент не поддерживает icon. Если задано свойство title, рекомендуется установить для свойства alignment значение "Right".
При изменении или добавлении строкового значения текущая запись не может быть сохранена, если строка не проходит проверку регулярным выражением validationRegex.
Если prompt или message не пусты, при однократном нажатии на TextField появляется диалоговое окно, в котором предлагается ввести значение.
| alignment | Описание |
|---|---|
| Left | По левому краю |
| Center | По центру |
| Right | По правому краю |
| Natural | Естественное выравнивание |
| Justified | По ширине |
| keyboard | Описание |
|---|---|
| Default | Стандартная и сторонняя клавиатура |
| Alphabet | Стандартная ASCII-клавиатура |
| ASCIICapable | Стандартная ASCII-клавиатура |
| NumbersAndPunctuation | Цифры и знаки пунктуации |
| URL | Веб-адрес |
| NumberPad | Цифры |
| PhonePad | Номер телефона |
| NamePhonePad | Имя и номер телефона |
| EmailAddress | Адрес электронной почты |
| DecimalPad | Цифры с десятичным разделителем |
| clearButtonMode | Описание |
|---|---|
| Never | Никогда не показывать |
| Always | Показывать всегда |
| WhileEditing | Показывать только при редактировании |
| UnlessEditing | Показывать только вне режима редактирования |
| Тип возвращаемого значения | Описание |
|---|---|
| строка | Содержимое текстового поля |
Тема
| Ключ темы | Тип | Описание |
|---|---|---|
| textColor | цвет | Цвет текста |
| caretColor | цвет | Цвет курсора |
| placeholderColor | цвет | Цвет заполнителя |
Пример
{
default = "";
label = "用户名";
cell = "TextField";
key = "username";
keyboard = "Default"; -- Клавиатура по умолчанию
alignment = "Right"; -- Выравнивание по правому краю
placeholder = "输入用户名"; -- Заполнитель
maxLength = 21; -- Максимальная длина
validationRegex = "^[0-9a-zA-Z]+$"; -- Проверка регулярным выражением
};
{
isSecure = true; -- Ввод пароля отображается в виде маленьких точек
default = "";
label = "密码";
cell = "TextField";
key = "password";
keyboard = "NumberPad"; -- Цифровая клавиатура
alignment = "Right"; -- Выравнивание по правому краю
placeholder = "输入密码"; -- Заполнитель
prompt = "请输入密码"; -- Заголовок диалогового окна
message = "请在提示框中输入 6 位数字密码"; -- Текст диалогового окна
validationRegex = "^[0-9]{6}$"; -- Проверка регулярным выражением
okTitle = "保存"; -- Заголовок кнопки отправки
cancelTitle = "取消"; -- Заголовок кнопки отмены
};

