Многострочное поле

Назначение

Многострочное поле - это компонента, которая используетсядля ввода и отображения нескольких строк текста. В таком текстовом поле допустимо делать переносы строк.

В зависимости от настройки свойств, включенных по умолчанию в состав компоненты, компонента Многострочное полеможет использовать для:

Компонента Многострочное поле находится в разделе Компоненты - Поля - Многострочное поле.

Свойства

Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.

Наименование свойства Назначение свойства Принимаемые значения
Подсказка позволяет создать подсказку, расположенную внутри элемента пример возможного значения: Введите название организации
Надпись позволяет задать наименование поля, которое будет отображаться на странице пример возможного значения: Наименование организации
Значение позволяет задать значение поля по умолчанию пример возможного значения: ООО “Форт”
Максимальная длина задаёт максимальное количество вводимых символов в поле пример возможного значения: 10
Минимальная длина (Min length) задаёт минимальное количество вводимых символов в поле
allowMoreSymbols при true позволяет пользователю ввести больше символов, чем значение максимальной длины, но при этом поле станет невалидным и будет отображено сообщение об ошибке maxLengthErrorMsg (см. документацию) логическое значение (true, false)
Оперировать немаскированным значением позволяет регулировать возможность ввода текста в соответствии с маской, даже если маска задана (значение маски указывается в расширенных настройках в поле “маска, ограничивающая ввод”)
  • значение не определено - по умолчанию
  • активно - сохранять без форматирования маской
  • пустое - сохранять с форматированием маской
Маска позволяет задать маску, в соответствии с которой пользователь будет осуществлять ввод текста выставление маски не может обеспечить выполнение требования обязательности ввода, маска только внешне отфильтровывает и форматирует последовательность вводимых пользователем символов заранее заданным образом (например, ввод тел. номера “+ 7 (917) - 101 - 02 - 03” вместо “8917010203” или не допустит такого ввода “89170102АЯ”). Для блокирования сохранения записи с пустым значением поля и обеспечения контроля обязательности ввода используйте свойство “Обязательность”
Регистр позволяет задать вид регистра вводимого текста
  • в верхнем регистре - заглавные (прописные) буквы
  • в нижнем регистре - строчные (маленькие) буквы
  • первая буква каждого слова заглавная
  • только первая буква текста заглавная, остальные строчные
  • первая буква текста заглавная
Тип позволяет задать тип вводимого текста
  • обычный текст
  • пароль (заполнитель - звездочки)
  • электронная почта
  • URL
Регулярное выражение или Pattern позволяет задать проверку вводимого текста с помощью регулярных выражений поля, для которых не выполняются условия заданных регулярных выражений, при сохранении записи подсвечиваются красным оттенком и операция отменяется.
patterErrorMsg, maxLengthErrorMsg, minLengthErrorMsg позволяют задать пользовательское сообщение о соответствующих ошибках валидации строка

Примеры масок:

Например, необходимо задать форматирование ввода маской для значения Й456QЬ. В данном случае маска будет выглядеть следующим образом: А999АА, где А - латинская буква.

Некоторые типовые регулярные выражения:

Например, чтобы ограничить возможность ввода и сохранения текста латиницей, можно использовать регулярное выражение ^[А-Яа-яЁё\s]+$

Свойство Поле многострочного ввода. Сохранение значения

В случае, если значение в многострочное поле необходимо сохранить или подгрузить из базы данных, указывается поле таблицы базы данных, куда будет сохраняться и откуда будет подгружаться введенное значение.Для выбора доступны только колонки имеющий строковый тип в базе данных. В случае, если значение многострочного поля не требуется сохранять или подгружать из базы данных, то данное свойство удаляется (или отключается). Данный вариант может быть необходим, когда многострочное поле используется дляотображения текста, который был введен пользователем приложения или является константой, определённой в логике приложения.

Заполнить значением по умолчанию

Заполнить значением по умолчанию

Заполнить значением из переменной процесса

Заполнить значением из переменной процесса

Сохранить значение в переменную процесса любого типа

Сохранить значение в переменную процесса любого типа

Определить права текущего пользователя

Определить права текущего пользователя

Определить роли текущего пользователя

Определить роли текущего пользователя

Склеить несколько значений

Склеить несколько значений

Методические рекомендации по применению

Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:

Часто задаваемые вопросы

Вопрос Ответ
Чем отличается компонента Поле многострочного вводаот компоненты Текст? Компонента Поле многострочного ввода используются для отображения многострочного текста на странице, где предусмотрены переносы строк.
Все ли свойства компоненты обязательны для заполнения? Нет.Свойства компоненты определяются в зависимости от решаемой задачи.
Возникнет ли ошибка при запуске приложения, если оставить незаполненным свойство Поле многострочного ввода. Сохранение значения? Да. В случае, если функция “Поле многострочного ввода. Сохранения значения” включена у элемента и не заполнены ее параметры, то при валидации проекта возникнет ошибка. Если по условию задачи данное поле не должно подгружаться и сохраняться в базу данных, данную функцию в компоненте необходимо либо отключить либо удалить.
Если удалить базовые функции, которые включены в компоненту по умолчанию, например, “Заполнить значением по умолчанию” можно ли будет вновь их добавить? Да. Если удалить какую-то базовую функцию компоненты, то по кнопке “Добавить функцию” она будет доступна для выбора.
Можно ли ограничить перенос строки по нажатию на клавишу Enter в Многострочном поле? Чаще всего подобногорода задачи решаются использованием Маски в свойствах элемента. Для того, чтобы ограничить перенос строки по нажатию на клавишу Enter в Многострочном поле необходимо в Расширенных настройках в свойстве Маска указать значение[^\r\n]* и перевести значение флага regexMask =true