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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.