Текстовое поле

Текстовое поле - это компонент, который позволяет редактировать отдельную строку текста.

Общие переменные (свойства)

[?]

Общие переменные: Имя, Видимый, Свойства расширения, Ширина сетки, Высота сетки, Выход за пределы контента, Стиль контейнера, Пользовательские классы, Стиль, Прелоадер, Привязки.

Текст

Текст, содержащийся в текстовом поле.

Имя переменной:

text

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

text

String

Текст

Заполнитель

Сообщение, которое отображается в текстовом поле, когда никакой другой текст не введен.

Имя переменной:

placeholder

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

placeholder

String

Заполнитель

Маска ввода

Позволяет указать маску ввода с помощью символов 9, a, и *.

  • '9' задает ввод для одной цифры

  • 'a' задает ввод для одной буквы

  • '*' задает ввод для одной цифры и одной буквы.

Маска ввода может содержать другие статичные символы. Например, маска для телефонного номера может быть определена как:

+9 (999) 999-9999

И будет представлена пользователю как:

+_ () -

Пользователь может ввести любую цифру в заполнителях, обозначенных подчеркиванием.

В случае когда один из заполнителей должен использоваться как статичный индикатор, специальный символ может быть экранирован с помощью символа \. Например, если текстовое поле предназначено для ввода серийного номера, который всегда начинается с комбинации 9a8-, маска ввода может быть задана как:

\9\a\*-9999999

Что будет представлено пользователю как:

9a*-_

Данная маска позволит пользователю ввести любой семизначный номер после символов 9a*.

Имя переменной:

inputMask

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

inputMask

String

Маска ввода

Иконка слева

Изображение, отображаемое слева от поля ввода.

Имя переменной:

leftIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Определяет использовать ли данные из поля imageData или из поля imageURL.

  • 0 - Данные изображения

  • 1 - Ссылка на изображение

imageData

Data Block

Данные изображения.

imageUrl

String

Ссылка на изображение.

Иконка справа

Изображение, отображаемое справа от текста, внутри поля ввода.

Имя переменной:

rightIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

imageType

Integer

Определяет использовать ли данные из поля imageData или из поля imageURL.

  • 0 - Данные изображения

  • 1 - Ссылка на изображение

imageData

Data Block

Данные изображения.

imageUrl

String

Ссылка на изображение.

Использовать событие keyup

Если включено, компонент будет создавать событие keyUp, содержащее текущие входные данные, каждый раз, когда пользователь отпускает клавишу клавиатуры.

Имя переменной:

useKeyUp

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

useKeyUp

Boolean

Использовать событие keyUp

Задержка после события keyup

Определяет задержку между отпусканием клавиши клавиатуры и созданием события keyUp. Если в это время будет нажата любая другая клавиша, событие не возникнет, и отсчет времени задержки начнется заново.  

Имя переменной:

keyUpDelay

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

keyUpDelay

Integer

Задержка после события keyUp

Максимальная длина

Максимальное число символов, которое можно ввести в текстовое поле

Имя переменной:

maxLength

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

maxLength

Integer

Максимальная длина

Неактивный

Этот флаг показывает, активен ли компонент. Неактивные компоненты не отвечают на ввод пользователя и недоступны для выбора.

Имя переменной:

disabled

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

disabled

Boolean

Неактивный

Тип ввода

Определяет тип ввода. Данное свойство имеет несколько возможных значений:

  • Search - добавляет иконку Поиск в поле ввода. Вводимый текст будет отображаться как обычно.

  • Text - вводимый текст будет отображаться как обычно.

  • Password - вводимый текст будет скрыт за звездочками.

Имя переменной:

inputType

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

inputType

String

Тип ввода

Использовать иконку "очистить"

Если включено, добавляет кнопку Очистить, которая появляется только если введен какой-либо текст.

Имя переменной:

addClearIcon

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

addClearIcon

Boolean

Использовать иконку Очистить

Стиль контейнера картинки

Стиль CSS для применения к изображению контейнера.

Имя переменной:

iconsStyle

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

iconsStyle

Boolean

Стиль контейнера картинки

Валидаторы

Это свойство позволяет определить валидаторы для поля ввода.

Имя переменной:

validators

Записи:

0...не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

validatorType

String

Type. Тип валидатора. Это свойство имеет несколько возможных значений:

  • Non-null Validator - вводимые данные не могут быть Null, т.е. нужно ввести хотя бы один символ;

  • Limits Validator - вводимые данные должны находиться в рамках, указанных в поле options. Например, значение "0, 100" (без кавычек) ограничивает ввод любых значений меньше 0  и больше 100;

  • Regex Validator - вводимые данные должны соответствовать регулярному выражению, указанному в поле options.

options

String

Options. Дополнительные опции для выбранного типа валидатора.

message

String

Message. Сообщение, показывающее, соответствует ли введенный символ текущему валидатору.

Действительный по умолчанию

Определяет состояние компонента по умолчанию. Если отключено, компонент будет отображаться с недействительным состоянием ввода по умолчанию.

Имя переменной:

componentValid

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

componentValid

Boolean

Действительный по умолчанию

Общие события

[?]

Общие события: Изменение входного значения