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

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