main.user.selector

Описание

Компонент main.user.selector представляет собой готовый к встраиванию в форму контрол для выбора сущностей различных типов.

В физической структуре его можно найти в папке /bitrix/components/bitrix/main.user.selector.

Параметры

Параметр	Описание
ID	Уникальный ID селектора (тип значения - строка).
API_VERSION	Версия API селектора (тип значения - число: по умолчанию - 2, поддерживается также 3 - с сохранением выбранной сущности в "Последних" сразу после ее выбора).
LIST	Массив кодов сущностей, подставляемых в качестве уже выбранных. Например: `[ 'U1', 'SG2', 'DR3' ]`.
INPUT_NAME	Имя поля формы, в котором будет передано выбранное значение (значения). Для того, чтобы использовать множественный выбор, применяйте значение вида `FIELD[ ]`.
USE_SYMBOLIC_ID	Принимает значение true или false. Использовать символьный код сущности вместо числового. По умолчанию - false, но если вы планируете выбирать сущности разных типов - используйте true.
BUTTON_SELECT_CAPTION	Языковое сообщение для элемента управления, открывающего селектор, если не выбран ни один элемент (по умолчанию - "выбрать").
BUTTON_SELECT_CAPTION_MORE	Языковое сообщение для элемента управления, открывающего селектор, если выбран хотя бы один элемент (по умолчанию - "выбрать").
OPEN_DIALOG_WHEN_INIT	Открывать ли попап селектора сразу после инициализации контрола (а не по клику на него). Принимает значение true или false. По умолчанию false.
UNDELETABLE	Массив кодов сущностей, которые должны отображаться в селекторе без возможности удаления.
LAZYLOAD	Откладывать ли загрузку данных в селектор (при пустом значении параметра LIST) до открытия селектора. Принимает значения Y/N. По умолчанию - N, т.е. загружать данные сразу.
SELECTOR_OPTIONS	Набор опций для передачи в контрол-попап выбора.

Пример вызова

// давать ли возможность выбора сущности "Всем сотрудникам" (с кодом UA)
<?
$APPLICATION->IncludeComponent(
'bitrix:main.user.selector',
' ',
[
	"ID" => "mail_client_config_queue",
	"API_VERSION" => 3,
	"LIST" => array_keys($crmQueueSelected),
	"INPUT_NAME" => "fields[crm_queue][]",
	"USE_SYMBOLIC_ID" => true,
	"BUTTON_SELECT_CAPTION" => Loc::getMessage("MAIL_CLIENT_CONFIG_CRM_QUEUE_ADD"),
	"SELECTOR_OPTIONS" => 
	[
		"departmentSelectDisable" => "Y",
		'context' => 'MAIL_CLIENT_CONFIG_QUEUE',
		'contextCode' => 'U',
		'enableAll' => 'N',
		'userSearchArea' => 'I'
	]
]
);
?>