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

SelectBoxMFromArray

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

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

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

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

ПараметрОписание
name Имя тэга:
<select name="name" ... >
values Элементы списка. Массив имеющий следующую структуру:
array(
	"REFERENCE" => 
		array(
			"Заголовок элемента 1", 
			"Заголовок элемента 2",
			...
		),
	"REFERENCE_ID" => 
		array(
			"Значение элемента 1",
			"Значение элемента 2",
			...
		)
)
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\"".

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

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

<?
$arr = array(
	"REFERENCE" => // массив заголовков элементов
		array("Вариант 1", "Вариант 2", "Вариант 3"),
	"REFERENCE_ID" => // массив значений элементов
		array(1, 2, 3)
); 
echo SelectBoxMFromArray("arrSEL[]", $arr, $arrSEL, "", false, 4, 
"class =\"inputselect\"");
?>


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