SelectBoxMFromArray
Описание и параметры
string SelectBoxMFromArray( string name, array values, array selected, string top_element = "", bool select_top_element = false, int size = 5, string add_to_tag = "class=\"typeselect\"" );
Возвращает HTML код тега <select multiple> (выпадающий список с множественными вариантами выбора ответа) на основании данных из массива.
Параметры функции
Параметр | Описание |
---|---|
name | Имя тэга: <select name="name" ... > |
values | Элементы списка. Массив имеющий следующую структуру:array( "REFERENCE" => array( "Заголовок элемента 1", "Заголовок элемента 2", ... ), "REFERENCE_ID" => array( "Значение элемента 1", "Значение элемента 2", ... ) ) |
selected | Выбранные элементы. Массив, значения которого будут искаться в массиве передаваемом в ключе "REFERENCE_ID" массива values, в случае совпадения элемент будет "выбран" (selected). Необязательный параметр. По умолчанию - "". |
top_element | Заголовок специального элемента который всегда помещается первым в списке и он может быть всегда выбран (контролируется параметром select_top_element). Значение этого элемента - "NOT_REF". Необязательный параметр. По умолчанию - "" (не добавлять подобный элемент). |
select_top_element | Если значение "true", то элемент top_element будет всегда выбран (selected).
Необязательный параметр. По умолчанию - "false" (не выбирать). |
size | Поле size тэга select: <select size="size" ... > В данном параметре передается количество видимых строк в списке множественного выбора. Параметр необязательный. Значение по умолчанию - 5. |
add_to_tag | Произвольный HTML который будет добавлен в тэг: <select add_to_tag ... > Необязательный параметр. По умолчанию - "class=\"typeselect\"". |
Смотрите также
Пример использования
<? $arr = array( "REFERENCE" => // массив заголовков элементов array("Вариант 1", "Вариант 2", "Вариант 3"), "REFERENCE_ID" => // массив значений элементов array(1, 2, 3) ); echo SelectBoxMFromArray("arrSEL[]", $arr, $arrSEL, "", false, 4, "class =\"inputselect\""); ?>
© «Битрикс», 2001-2024, «1С-Битрикс», 2024