Фремворк Limb

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

====== Тег {{input}} ======

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

Расширенная форма html-тега <input>. Является потомком [[lmb_macro_form_element_tag]].
===== Синтаксис =====

<code xml>
 {{input id='id' type='text|checkbox|hidden...' [...любые html-параметры]/}}
</code>
===== Атрибуты =====
  * **type** - тип поля (text, hidden, image, button, password, submit, reset, file, checkbox, radio)
  * Наследованные атрибуты [[.:lmb_macro_form_element_tag#атрибуты| Атрибуты lmbMacroFormElementTag]]

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

Нет.

===== Widget (runtime компонент) =====

В откомпилированном виде каждому **%%{{input}}%%** тегу соответствует объект определенного класса или так называемый runtime компонент. То, какой компонент будет выбран, зависит от атрибута **type**.

* lmbMacroInputWidget - рендерит для <input> тега в любом случае атрибут **value**.
  * lmbMacroCheckableInputWidget - трактует value как значение, с которым нужно знавнить так называемое **checked_value**. Набор правил, по которым checkbox или radio становится checked см. ниже.

===== Как работают checkbox-ы и radio =====

Если для обычных input-ов атрибут value определяет значение поля, то для type='checkbox' и type='radio' атрибут **value** имеет другое значение: **value** используется как значение, с которым нужно сравнить некое **checked_value**.

Этот **checked_value** определяется следующим образом:
  * Сначала проверяется наличие атрибута **checked_value**
  * Если этого атрибута нет, тогда берется значение в соответствие с runtime_id из контейнера данных родительского тега **%%{{form}}%%** (runtime_id равно id или name)

Потом на основе **value** и **checked_value** вычисляется, нужно ли выводить (рендерить) для тега <input> атрибут checked. Атрибут **checked** выводится если:
^ checked_value ^ value ^ пример ^
| массив | есть в массиве  | %%{{input type="checkbox" checked_value="$#obj->getTypesArray()" value="foo"}}%% |
| скаляр | равен checked_value | %%{{input type="checkbox" checked_value="foo" value="foo"}}%% |
| скаляр | отсутствует  | %%{{input type="checkbox" checked_value="foo"}}%% |
| 0 или false | 0 | %%{{input type="checkbox" checked_value="0" value="0"}}%% |
или если он указан явно.

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

==== text, hidden ====

<code xml>
  <label for='name'>Имя и фамилия:</label>
  {{input type="text" name="name" id="name" title="Имя и фамилия"/}}
</code>

==== checkbox ====

<code xml>
<? $bar = 1; ?>
{{input type="checkbox" id="test" name="my_input" value="1" checked_value="{$bar}" /}}
</code>

Получим:

==== radio ====
<code xml>
  Выберите тип пользователя:
  <label for='type_user'>{{input type="radio" name="member_type" id="type_user" value='1' title='Фотограф' checked='true'/}}Фотограф</label>
  <label for='type_model'>{{input type="radio" name="member_type" id="type_model" value='2' title='Модель'/}}Модель</label>
</code>

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

   __    __ __   __  ___   ___    ____
  / /   / // /  /  |/  /  / _ \  /  _/
 / /__ / _  /  / /|_/ /  / ___/ _/ /  
/____//_//_/  /_/  /_/  /_/    /___/

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

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

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

Фремворк Limb

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

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

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