Перейти к основному содержимому

TextField — однострочное текстовое поле

Этот компонент отображает в интерфейсе текстовое поле для ввода строки.

КлючТипОписаниеОбязателенЗначение по умолчаниюМинимальная версия
alignmentстрокаВыравнивание-Left-
keyboardстрокаТип клавиатуры-Default-
placeholderстрокаЗаполнитель текстового полялокализуемый""-
isSecureлогическое значениеОтображать ли символы в виде маленьких точек-false-
clearButtonModeстрокаПоказывать ли чёрный крестик очистки-Never-
maxLengthцелое числоМаксимальная длина текста-INT_MAX-
validationRegexстрокаРегулярное выражение для проверки введённой строки-nil1.2-10
promptстрокаЗаголовок диалогового окналокализуемыйnil1.2-10
messageстрокаТекст диалогового окналокализуемыйnil1.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 = "取消"; -- Заголовок кнопки отмены
};

XUI-TextField.png

XUI-TextField-Prompt.png