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

SelectBoxFromArray

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

string
SelectBoxFromArray(
	string name,
	array values,
	string selected = "",
	string default = "",
	string add_to_tag = "class=\"typeselect\"",
	bool submit_form = false,
	string form_name = "form1"
);

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

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

ПараметрОписание
name Имя тэга:
<select name="name" ... >
values Элементы списка. Массив имеющий следующую структуру:
array(
	"REFERENCE" => 
		array(
			"Заголовок элемента 1", 
			"Заголовок элемента 2",
			...
		),
	"REFERENCE_ID" => 
		array(
			"Значение элемента 1",
			"Значение элемента 2",
			...
		)
)
selected Выбранный элемент. Значение данного параметра будет искаться в массиве передаваемом в ключе "REFERENCE_ID" массива values, в случае совпадения элемент будет "выбран" (selected).
Необязательный параметр. По умолчанию - "".
default Заголовок элемента списка выбираемого по умолчанию. Значение этого элемента - "NOT_REF".
Необязательный параметр. По умолчанию - "" (не добавлять подобный элемент).
add_to_tag Произвольный HTML который будет добавлен в тэг:
<select add_to_tag ... >
Необязательный параметр. По умолчанию - "class=\"typeselect\"".
submit_form Если в данном параметре указать "true", то в момент выбора какого либо значения из выпадающего списка, произойдет submit формы, имя которой указано в параметре form_name.
Необязательный параметр. По умолчанию - "false" (не submit'ить форму).
form_name Если параметр submit_form = true, то здесь вам необходимо указать имя формы в которой будет расположен тэг <select>.
Необязательный параметр. По умолчанию - "form1".

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

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

<form name="form2" action="" method="GET">
<?
$arr = array(
	"REFERENCE" => // массив заголовков элементов
		array("Вариант 1", "Вариант 2", "Вариант 3"),
	"REFERENCE_ID" => // массив значений элементов
		array(1, 2, 3)
); 
echo SelectBoxFromArray("CHOICE", $arr, $CHOICE, "", "", true, "form2")
?>
</form>


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