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

SelectBox

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

string
SelectBox(
	string name,
	CDBResult values,
	string default = "",
	string selected = "",
	string add_to_tag = "class=\"typeselect\""
);

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

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

ПараметрОписание
name Имя тэга:
<select name="name" ... >
values Элементы списка. Объект типа CDBResult, содержащий набор записей, каждая из которых должна иметь по два: "REFERENCE_ID" (значение элемента списка) и "REFERENCE" (заголовок элемента списка).
default Заголовок элемента списка выбираемого по умолчанию. Значение этого элемента - "NOT_REF".
Необязательный параметр. По умолчанию - "" (не добавлять подобный элемент).
selected Выбранный элемент. Значение данного параметра будет сравниваться с полями "REFERENCE_ID" набора записей передаваемого в параметре values, в случае совпадения элемент будет "выбран" (selected).
Необязательный параметр. По умолчанию - "".
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
";
$rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__);

// выведем выпадающий список групп
echo SelectBox("GROUP", $rs, "< выберите группу >", $GROUP, "class =\"inputselect\"");
?>


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