====== Тег {{select_options_export}} ======

===== Описание =====

Позволяет преобразовывать различные источники данных (итераторы или обычные массивы) в форму, понятную [[select_tag|тегу {{select}}]] для формирования списка тегов <option>. 

Этот тег используется в случае, например, если список опций нужно построить на основе записей из таблицы базы данных. Результат работы этого тега - это просто переменная, указанная при помощи атрибута **to**, которая будет содержать массив вида array(array(option_key => option_text), array(option_key => option_text)...). Этот массив будет построен на основе источника, который указывается при помощи атрибута **from**. То, какие поля будут использоваться в качестве option_key и option_text указывается при помощи атрибутов **key_field** и **text_field**.


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

<code xml>
{{select_options_export to='$options_var' from="$source_var" key_field='key_field' text_field='text_field'/}}
</code>

===== Область применения =====

Обычно (не обязательно) внутри [[form_tag|тега {{form}}]] и совместо с [[select_tag|тегом {{select}}]].

===== Атрибуты =====

  * **to** – имя переменной, куда тег положит сформированный массив опций.
  * **from** – имя переменной - источника первоначальных данных, из которых нужно сформировать массив опций.
  * **key_field** - название поля, значение которого будет использоваться как идентификатор опции.
  * **text_field** - название поля, значение которого будет использоваться как название опции.

===== Содержимое =====

Нет.

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

<code php>
<?
 $teams = array(array('id' => '1', 'title' => 'Spartak'),
                array('id' => '2', 'title' => 'Dinamo'),
                array('id' => '3', 'title' => 'Zenit'));
?>

{{select_options_export from="$teams" to="$teams_as_options" key_field="id" text_field="title"/}}

{{select id='team_id' name='team_id' options="$teams_as_options"}}
 {{option prepend="true" value='0'}}Выберите команду{{/option}}
{{/select}}
</code>