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