Флажок

Элемент управления Флажок предназначен для просмотра и изменения булевых данных (да/нет) карточки.

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

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

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

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

    В карточке выглядит аналогично режиму редактирования.

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

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

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

    Элемент управления "Флажок" в режиме чтения с выбранной иконкой

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Внешний вид

Подсказка

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

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

Рисунок для значения "да"

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

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

Окно выбора файла изображения для рисунка значения
Рисунок 3. Окно выбора файла изображения для рисунка значения

Поддерживаются изображения следующих форматов: .jpeg, .png, .bmp, .gif (без анимации), .tiff, .ico, .jxr. Рекомендуемый размер изображения: 28 пикселей в высоту.

Рисунок для значения "нет"

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

Выбор рисунка осуществляется аналогично выбору рисунка для значения да.

Скрыть поле для

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

  • Значение не указано. Если значение отсутствует.

  • Да. Если в значении true.

  • Нет. Если в значении false.

  • Не скрывать. Отображение элемента управления не зависит от значения).

Текст для значения "да"

Текст, отображаемый в режиме Без редактирования, если Флажок установлен.

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

Текст для значения "нет"

Текст, отображаемый в режиме редактирования Без редактирования, если флаг не установлен.

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

Текст метки

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

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

Данные

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

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

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

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

Поле данных

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

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

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

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

Поведение

Видимость

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

Адаптивный

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

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

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

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

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

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

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

Отключен

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

Адаптивный

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

Значение ЭУ, устанавливаемое по умолчанию при создании карточки.

  • Когда флаг установлен в свойстве, он установлен также в ЭУ.

  • Когда флаг не установлен в свойстве, в ЭУ он по умолчанию снят.

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

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

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

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

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

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

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

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

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

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

События

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

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

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

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

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

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

При щелчке

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