Документация для разработчиков
Темная тема

SelectBoxM

Описание и параметры

string
SelectBoxM(
	string name,
	CDBResult values,
	array selected,
	string top_element = "",
	bool select_top_element = false,
	int size = 5,
	string add_to_tag = "class=\"typeselect\""
);

Возвращает HTML код тега <select multiple> (выпадающий список с множественными вариантами выбора ответа) на основании данных из объекта класса CDBResult.

Параметры функции

ПараметрОписание
name Имя тэга:
<select name="name" ... >
values Элементы списка. Объект типа CDBResult, содержащий набор записей, каждая из которых должна иметь по два: "REFERENCE_ID" (значение элемента списка) и "REFERENCE" (заголовок элемента списка).
selected Выбранные элементы. Массив, элементы которого будут сравниваться с полями "REFERENCE_ID" набора записей передаваемого в параметре values, в случае совпадения элемент будет "выбран" (selected).
top_element Заголовок специального элемента который всегда помещается первым в списке и он может быть всегда выбран (контролируется параметром select_top_element). Значение этого элемента - "NOT_REF".
Необязательный параметр. По умолчанию - "" (не добавлять подобный элемент).
select_top_element Если значение "true", то элемент top_element будет всегда выбран (selected).
Необязательный параметр. По умолчанию - "false" (не выбирать).
size Поле size тэга select:
<select size="size" ... >
В данном параметре передается количество видимых строк в списке множественного выбора. Параметр необязательный. Значение по умолчанию - 5.
add_to_tag Произвольный HTML который будет добавлен в тэг:
<select add_to_tag ... >
Необязательный параметр. По умолчанию - "class=\"typeselect\"".

Смотрите также

Пример использования

<?
// сформируем выборку из таблицы групп
$strSql = "
	SELECT
		G.ID as REFERENCE_ID,
		G.NAME as REFERENCE
	FROM
		b_group G
	WHERE
		G.ID<>2 -- группа everybody которой все принадлежат по умолчанию
";
$rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__);

// выведем список групп с множественным выбором
echo SelectBoxM("arrGROUP[]", $rs, $arrGROUP, "< группа everybody >", true, 20, 
"class =\"inputselect\"");
?>


© «Битрикс», 2001-2023, «1С-Битрикс», 2023