Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== Тег {{form}} ======

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

Теги группы **%%{{form}}%%** удобны, если вам необходимо работать с активной формой, то есть проверять поля формы, выводить ошибки валидации, сохранять значения в полях после отправки формы и повторной ее отображении - MACRO содержит широкий набор средств, превращающий эти теги <form>, <input> и т.д. в полноценные активный компоненты.

см. раздел [[limb3:ru:packages:macro:form_tags|"Теги форм с активными компонентами"]], который подробно объясняет этот момент.
===== Синтаксис =====

<code xml>
{{form id='id' [..любые атрибуты html-тега <form>] [from='$some_var']}}
  ...some form controls...
{{/form}}
</code>

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

В любом месте MACRO шаблона.
===== Атрибуты =====

* **id** – идентификатор формы.
  * **from** - указывает на переменную, которая будет использоваться в качестве контейнера данных для формы

Плюс любые атрибуты html-тега <form>.

:!: Если вы не указали явно параметр **name**, то оно будет сгенерировано со значением параметра **id**.

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

Любое.

===== Передача данных и ошибок валидации в форму через спец. переменные шаблона =====

На этапе выполнения шаблона тегу **%%{{form}}%%** соответствует так называемый runtime компонент. Этот компонент может автоматически использовать в качестве контейнера данных и списка ошибок валидации переменные шаблона, названные особым образом:
  * form_[form_runtime_id]_datasource 
  * form_[form_runtime_id]_error_list

Приведем небольшой пример:

<code xml>
<? $this->form_my_form_datasource = array('value' => 1111); ?>
<? $this->form_my_form_error_list = array(array('message' => 'Some error')); ?>

{{form name="my_form"}}
 <? $ds = $this->form_my_form->getDatasource();
  echo $ds["value"]; ?>
  <br/>
 <? $error_list = $this->form_my_form->getErrorList();
  echo $error_list[0]["message"]; ?>
{{/form}}
</code>

На выходе получим:

<form name="my_form">1111<br/>Some error</form>

Именно эти переменные ставит класс lmbMacroView, который можно найти в пакете VIEW.

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

см. также пример для [[lmb_macro_form_element_tag|lmbMacroFormElementTag]].

<code xml>
{{form id='search_form' name='search_form' action='/search' method='get' }}
  <tr>
    <td >
     Search
    </td>
    <td>
     {{input type="text" id="query" name="query" class='input' size='40'/}}
    </td>
  </tr>
  <tr>
    <td colspan='2'>
     <input type="submit" value='Search'/>
    </td>
  </tr>
  <input type="hidden" name="action" value='create'/>
{{/form}}
</code>

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

  _      __  _      __   _  __   ___   _____
 | | /| / / | | /| / /  | |/_/  / _ \ / ___/
 | |/ |/ /  | |/ |/ /  _>  <   / , _// (_ / 
 |__/|__/   |__/|__/  /_/|_|  /_/|_| \___/

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы