Многострочное поле
Назначение
Многострочное поле - это компонента, которая используетсядля ввода и отображения нескольких строк текста. В таком текстовом поле допустимо делать переносы строк.
В зависимости от настройки свойств, включенных по умолчанию в состав компоненты, компонента Многострочное полеможет использовать для:
- Для сохранения введенной информации в базу данных и отображения значения из базы данных (в данном случае, функция компоненты Поле многострочного ввода. Сохранение значения должно быть включена).
- Для отображения текста, который был введен пользователем приложения или является константой, определённой в логике приложения (в данном случае, функция компоненты Поле многострочного ввода. Сохранение значения должна быть выключена или удалена через настройки функции по кнопке).
Компонента Многострочное поле находится в разделе Компоненты - Поля - Многострочное поле.
Свойства
Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Подсказка | позволяет создать подсказку, расположенную внутри элемента | пример возможного значения: Введите название организации |
| Надпись | позволяет задать наименование поля, которое будет отображаться на странице | пример возможного значения: Наименование организации |
| Значение | позволяет задать значение поля по умолчанию | пример возможного значения: ООО “Форт” |
| Максимальная длина | задаёт максимальное количество вводимых символов в поле | пример возможного значения: 10 |
| Минимальная длина (Min length) | задаёт минимальное количество вводимых символов в поле | |
| allowMoreSymbols | при true позволяет пользователю ввести больше символов, чем значение максимальной длины, но при этом поле станет невалидным и будет отображено сообщение об ошибке maxLengthErrorMsg (см. документацию) | логическое значение (true, false) |
| Оперировать немаскированным значением | позволяет регулировать возможность ввода текста в соответствии с маской, даже если маска задана (значение маски указывается в расширенных настройках в поле “маска, ограничивающая ввод”) |
|
| Маска | позволяет задать маску, в соответствии с которой пользователь будет осуществлять ввод текста | выставление маски не может обеспечить выполнение требования обязательности ввода, маска только внешне отфильтровывает и форматирует последовательность вводимых пользователем символов заранее заданным образом (например, ввод тел. номера “+ 7 (917) - 101 - 02 - 03” вместо “8917010203” или не допустит такого ввода “89170102АЯ”). Для блокирования сохранения записи с пустым значением поля и обеспечения контроля обязательности ввода используйте свойство “Обязательность” |
| Регистр | позволяет задать вид регистра вводимого текста |
|
| Тип | позволяет задать тип вводимого текста |
|
| Регулярное выражение или Pattern | позволяет задать проверку вводимого текста с помощью регулярных выражений поля, для которых не выполняются условия заданных регулярных выражений, при сохранении записи подсвечиваются красным оттенком и операция отменяется. | |
| patterErrorMsg, maxLengthErrorMsg, minLengthErrorMsg | позволяют задать пользовательское сообщение о соответствующих ошибках валидации | строка |
Примеры масок:
- A (буква, латинская, регистр не имеет значения) в маске - позволит ввести в поле одну любую букву любого алфавита
- Б (буква, русская, в верхнем регистре) в маске - позволит ввести в поле одну любую букву русского алфавита
- 9 (цифра) в маске - позволит ввести в поле одну любую цифру
- * (символ) в маске - позволит ввести в поле одну любую цифру или букву
- R (буква, латинская, в верхнем регистре) в маске - позволит ввести в поле одну римскую цифру
- ? (символ) в маске - позволит ввести или опустить при вводе в поле один необязательный символ (букву, цифру) ,например 999?9; под эту маску подходит как 123, так и 1234
Например, необходимо задать форматирование ввода маской для значения Й456QЬ. В данном случае маска будет выглядеть следующим образом: А999АА, где А - латинская буква.
Некоторые типовые регулярные выражения:
- \d [0-9] - одна цифра от 0 до 9
- \D [^0-9] - любой символ кроме цифры
- \s - пробел
- [A-Z] - только заглавная латинская буква
- [A-Za-z] - только латинская буква в любом регистре
- [А-Яа-яЁё] - только русская буква в любом регистре
- [A-Za-zА-Яа-яЁё] - любая буква русского и латинского алфавита
- [0-9]{3} - три цифры
- [A-Za-z]{6,} - не менее шести латинских букв
- [0-9]{,3} - не более трёх цифр
- [0-9]{5,10} - от пяти до десяти цифр
- ^[a-zA-Z]+$ - любое слово на латинице
- ^[А-Яа-яЁё\s]+$ - любое слово на русском включая пробелы
- ^[ 0-9]+$ - любое число
Например, чтобы ограничить возможность ввода и сохранения текста латиницей, можно использовать регулярное выражение ^[А-Яа-яЁё\s]+$
Свойство Поле многострочного ввода. Сохранение значения

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

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