Группа радиокнопок
Элемент управления Группа радиокнопок
предназначен для выбора и отображения значения из списка значений.
Элемент управления может быть связан с полем карточки следующих типов:
-
int — предоставляется возможность самостоятельно создавать набор элементов, отображаемых в ЭУ.
-
enum, bool — набор значений (для enum) будет загружен из схемы карточки и изменению не подлежит. При типе поля enum в ЭУ загружается весь список значений, при типе поля bool — два значения: True и False.
-
refid — значения будут загружены из поля по ссылке.
Независимо от типа связанного поля, предоставляется возможность локализовать значения элементов списка.
Вариант отображения ЭУ зависит от свойства Режим редактирования
:
-
Редактирование. Данный вариант может быть использован только в разметке режима редактирования карточки.
Рисунок 1. Элемента управления "Группа радиокнопок" в режиме редактирования -
По месту. Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.
Изменение значения осуществляется при нажатии на ссылку в ЭУ.
Рисунок 2. Элемент управления "Группа радиокнопок" в режиме редактирования по месту -
Без редактирования. ЭУ в данном режиме отображает текстовое значение, соответствующее состоянию булевых данных в связанном поле карточки.
Чтобы настроенное при создании или редактировании карточки значение ЭУ корректно отображалось во время просмотра карточки, набор элементов в связанном списке должен быть идентичен в разметке режима редактирования/создания и в разметке режима просмотра. Создать ЭУ с идентичными настройками можно копированием исходного ЭУ. |
Свойства
Внешний вид
Количество колонок
Количество колонок для отображения элементов списка. По умолчанию все элементы отображаются в одной колонке.
Данные
Расширенный источник данных
Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.
Операция редактирования
Выбор операции редактирования значения элемента управления. Если операция недоступна пользователю, изменение значения элемента управления также недоступно. Если операция не выбрана, возможность редактирования значения элемента управления не проверяется.
Если значение Операции редактирования
наследуется от родительского Блока
, название свойства меняется на Операция редактирования (наследовано)
.
Положение метки элемента
Положение текстовой части переключателя (относительно переключателя) в отображаемом элементе списка. Текстовая часть может отображаться справа или слева от переключателя.
Список элементов
Настройка списка элементов, отображаемых в элементе управления.
Список значений задаётся в форме, открываемой при нажатии кнопки :
Возможность создания собственного набора значений доступна только для ЭУ, связанного с полем типа int.
Локализация элементов списка выполняется при нажатии кнопки в строке значения. Настройки локализации сохраняются после нажатия кнопки ОК в окне Локализация элементов.
Поведение
Видимость
Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.
Адаптивный
Дополнительные css классы
Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.
Обязательное
Определяет требование к заполнению значения ЭУ до сохранения карточки:
-
Когда флаг установлен, значение ЭУ должно быть присвоено, иначе карточка не будет сохранена. При этом ЭУ помечается предупреждающим сообщением.
-
Когда флаг не установлен, присваивать значение необязательно.
Операция редактирования для видимости
Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость
:
-
Когда флаг
Видимость
установлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования. -
Когда флаг
Видимость
установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда. -
Когда флаг
Видимость
НЕ установлен, ЭУ всегда скрыт.
Отключен
Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством `Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.
Адаптивный
Переходить по TAB
Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.
Режим редактирования
Определяет вариант отображения элемента управления и возможность изменения его значения:
-
По месту. Значение изменяется нажатием на элемент управления.
Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.
-
Редактирование. Значение изменяется непосредственно в элементе управления.
Данный вариант может быть выбран в разметке режима редактирования и просмотра.
Если элемент с режимом Редактирование добавлен в разметку просмотра, необходимо самостоятельно обеспечить сохранение его значения. Например, с использованием скриптов карточек.
-
Без редактирования. Значение изменить нельзя.
События
Перед закрытием окна редактирования
Вызывается перед закрытием окна редактирования в режиме редактирования По месту.
Перед открытием окна редактирования
Вызывается перед открытием окна редактирования в режиме редактирования По месту.
После закрытия окна редактирования
Вызывается после закрытия окна редактирования в режиме редактирования По месту.