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

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