Строка

Элемент управления Строка предназначен для ввода и отображения строковых данных карточки. В отличие от ЭУ "Текст" может содержать только одну строку.

Вариант отображения ЭУ зависит от свойства Режим редактирования:

  • Редактирование. Данный вариант может быть использован только в разметке режима редактирования карточки.

    Элемент управления "Строка" в режиме редактирования
    Рисунок 1. Элемент управления "Строка" в режиме редактирования

  • По месту. Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.

    Изменение текста осуществляется при нажатии на ссылку в ЭУ.

    Элемент управления "Строка" в режиме редактирования по месту
    Рисунок 2. Элемент управления "Строка" в режиме редактирования по месту

  • Без редактирования. ЭУ в данном режиме отображает текстовое значение, соответствующее состоянию булевых данных в связанном поле карточки.

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Внешний вид

Заполнитель

Текст, отображаемый в элементе управления, если значение не выбрано.

Локализуемый

Отображать метку без значения

Определяет вариант отображения метки.

  • Для режима просмотра:

    • Когда флаг установлен, текст метки отображается всегда.

    • Когда флаг не установлен, текст метки отображается, только если задано значение ЭУ.

  • Для режима редактирования:

    • Когда флаг установлен, текст метки отображается всегда.

    • Когда флаг не установлен, текст метки отображается только если поле содержит значение или редактируется. Для полей в режиме редактирования рекомендуется указывать Заполнитель.

Подсказка

Содержимое всплывающей подсказки.

Локализуемый

Текст метки

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

Локализуемый

Данные

Расширенный источник данных

Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.

Источник данных

Секция карточки, содержащая данные элемента управления.

Поле данных

Текстовое поле карточки с данными элемента управления.

Операция редактирования

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

Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).

Поведение

Видимость

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

Адаптивный

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

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

Значение элемента управления, присваиваемое при создании новой карточки.

Обрезать пробелы

Определяет необходимость удаления пробелов в начале и в конце строки.

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

Обязательное

Определяет требование к заполнению значения ЭУ до сохранения карточки:

  • Когда флаг установлен, значение ЭУ должно быть присвоено, иначе карточка не будет сохранена. При этом ЭУ помечается предупреждающим сообщением.

  • Когда флаг не установлен, присваивать значение необязательно.

Операция редактирования для видимости

Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость:

  • Когда флаг Видимость установлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования.

  • Когда флаг Видимость установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда.

  • Когда флаг Видимость НЕ установлен, ЭУ всегда скрыт.

Маска ввода

Свойство предназначено для написания регулярных выражений (regexp) для задания масок с использованием синтаксиса языка Perl. Свойство доступно только для режимов редактирования Редактирование и По месту. Значение можно задавать в редакторе, нажав кнопку Три точки.

Структура окна редактора метки ввода:
Поле "Регулярное выражение"

В поле указывается значение маски ввода.

Поле "Маска"

В поле указывается маска ввода.

Область для проверки

Область предназначена для ввода проверочных значений.

В окне редактора пользователь может ввести только регулярное выражение, только маску или и то и другое сразу. Для масок существует два ограничения: "или" (например, +7 или 8 в номере телефона) и бесконечное количество символов.

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

Пример указания и проверки маски ввода для номера телефона
Рисунок 3. Пример указания и проверки маски ввода для номера телефона
Примеры указания регулярных выражений и масок ввода:

  • Для телефона:

    • Регулярное выражение: ((8|+7)[- ]?)?((?\d{3})?[- ]?)?[\d- ]{7,9}

    • Формат маски ввода: \+7(000)000-00-00 или 8(000)000-00-00, где 0 — цифра от 0 до 9

  • Для СНИЛС:

    • Регулярное выражение: ^\d{3}-\d{3}-\d{3} \d{2}$

    • Формат маски ввода: 000-000-000 00, где 0 — цифра от 0 до 9

  • Для адреса электронной почты:

    • Регулярное выражение: ([a-zA-Z0-9.-]+@[a-zA-Z0-9.-]+.[a-zA-Z0-9_-]+)

    • Маску ввода задать нельзя, т.к. количество символов не ограничено.

  • Для ИНН физического лица:

    • Регулярное выражение: : (?!00)\d{12}$. Не может начинаться с двух нулей, т.к. нет субъекта РФ с кодом 00.

    • Формат маски ввода: 000000000000, 12 циф.

Отключен

Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.

Адаптивный

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

Режим редактирования

Определяет вариант отображения элемента управления и возможность изменения его значения:

  • По месту. Значение изменяется нажатием на элемент управления.

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

  • Редактирование. Значение изменяется непосредственно в элементе управления.

    Данный вариант может быть выбран в разметке режима редактирования и просмотра.

    Если элемент с режимом Редактирование добавлен в разметку просмотра, необходимо самостоятельно обеспечить сохранение его значения. Например, с использованием скриптов карточек.

  • Без редактирования. Значение изменить нельзя.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

События

Перед закрытием окна редактирования

Вызывается перед закрытием окна редактирования в режиме редактирования По месту.

Перед открытием окна редактирования

Вызывается перед открытием окна редактирования в режиме редактирования По месту.

После закрытия окна редактирования

Вызывается после закрытия окна редактирования в режиме редактирования По месту.

После открытия окна редактирования

Вызывается после открытия окна редактирования в режиме редактирования По месту.

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

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

При получении фокуса

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

При потере фокуса

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

После смены данных

Вызывается после изменения содержимого элемента управления.

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.