====== Тег {{select}} ======
===== Описание =====

Расширенная форма html тега <select>. Является потомком [[lmb_macro_form_element_tag]]. Список опций из тегов <option> генерируется тегом **%%{{select}}%%** на лету во время исполнения шаблона. При этом можно задать список опций в шаблоне явно, а можно задать его при помощи переменной (или комбинировать). 

**%%{{select}}%%** самостоятельно помещает нужные опции как выбранные. Для указания выбранных элементов можно использовать атрибут **value**, или же **%%{{select}}%%** может взять значение соответствующего поля из контейнера данных в родительском [[form_tag|теге {{form}}]]. Если используется <select> с возможностью выбора нескольких элементов (multiple="true"), то контейнер данных формы для поля <select> должен содержать массив значений. см. пример ниже.

см. также [[select_options_export_tag|тег {{select_options_export}}]], который используется для заполнения переменной для списка опций на этапе выполнения шаблона.

===== Синтаксис =====

<code xml>
{{select id='some_id' name='some_name' [multiple] [options="$options_var"] [value="$#selected_value"] [value_field="some_field"]}}
  {{option}}..{{/option}}...
{{/select}}
</code>
===== Содержимое =====

Обычно список [[option_tag|тегов {[option}}]] или вообще ничего, если список задается при помощи атрибута **options**.
===== Атрибуты =====

  * **options** - имя переменная, которая содержит массив опций вида array(array(option_key ⇒ option_text), array(option_key ⇒ option_text)...)
  * **value** - выбранный элемент или массив (объект с %%ArrayAccess%%), где есть поле, указанное при помощи **value_field**
  * **value_field** - название поля в массиве или объекте, который возвращается при попытке тегом получить свое знаение (по **value** атрибуту или из родительского тега **%%{{form}}%%**). Cм. пример ниже. По-умолчанию имеет значение //id// 
  * **multiple** - указывает на возможность указания нескольких выбранных опций
  * Наследованные атрибуты [[.:lmb_macro_form_element_tag#атрибуты| Атрибуты lmbMacroFormElementTag]]

===== Как {{select}} определяет выбранный элемент =====
==== При выборе одной опции (single) ====

Этап 1:
  * Если есть атрибут **value**, то берется его значение.
  * Иначе берется значение из контейнера данных родительского тега **%%{{form}}%%** по runtime_id тега (используйте совпадающие атрибуты id и name для таких случаев).
  * Если оба вышеуказанных варианта не дали значение, используется значение по-умолчанию, которое может быть определено при помощи дочернего  [[option_tag|тега {{option}}]]

Этап 2:
  * Если значение скалярное, то оно и будет использовано
  * Если значение - массив или объект с интерфейсом %%ArrayAccess%%, когда будет из этого массива пробовать взять поле с именем, которое определяется атрибутом **value_field** (по-умолчанию, просто id)
==== При выборе нескольких опции (multiple) ====

Этап 1: 
 Такой же как и для single

Этап 2:
  * Если значение - скаляр - используется значение по-умолчанию
  * Если значение объект, но он не поддерживает интерфейс Iterator, то используется значение по-умолчанию
  * Потом осущесвляется проход по полученному значению.
    * Если элемент массива или итератора - скаляр, то он кладется в конечный массив
    * Если элемент массива или итератор - массив или объект с %%ArrayAccess%%, то из него берется поле в соответствие со значением атрибута **value_field**

===== Пример использования =====
==== Single select ====

<code php>
<? $options = array('ff0000' => 'red', '00ff00' => 'green');
   $selected_value_object = new lmbObject(array('my_color' => '00ff00', 'id' => 'ff0000')); ?>
{{select id="my_select" options="$options" value="$selected_value_object" value_field="my_color"/}}
</code>

Получим:

<code xml>
<select id="my_select" name="my_select">
 <option value="ff0000">red</option>
 <option value="00ff00" selected="true">green</option>
</select>
</code>




==== Multiple select ====

<code php>

<? $options = array('ff0000' => 'red', '00ff00' => 'green', '0000ff' => 'blue');
   $selected_value = array('00ff00', '0000ff'); ?>

{{select id="my_select" name="my_select[]" multiple="true" options="$options" value="$selected_value"/}}
</code>

Получим:
<code xml>
<select id="my_select" name="my_select[]" multiple="true">
<option value="ff0000">red</option>
<option value="00ff00" selected="true">green</option>
<option value="0000ff" selected="true">blue</option>
</select>
</code>