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