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

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-2020, «1С-Битрикс», 2020
Наверх