Фремворк Limb

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

====== Теги форм с активными компонентами или без ======

===== Роль атрибута runat =====

Любой тег в WACT шаблоне при желании может иметь активный компонент фазы выполнения. Для этого существует специальный атрибут **runat**, который должен иметь значение "server", чтобы активизировать создание активного компонента. Для специальных WACT-тегов, таких как <core:datasource>, <list:list> этот атрибут автоматически ставится в значение server. А для обычных HTML-тегов, типа <a>, <img> и т.д. значение этого тега по-умолчанию равно **client**, что значит этот тег не имеет активного компонента.

Теги форм - особый случай: иногда они требуют активного компонента, а иногда нет, например:

<form id="MyFormB" runat="server">
    
</form>
</code>

===== Активные компоненты для тегов элементов форм =====

Так как формы играют очень важную форму в любом приложении, WACT содержит готовую реализацию этих тегов в качестве компонентов.

Для форм введен дополнительный механизм именования тегов, который дополнительно использует атрибут "name" (обычно используется для идентификации тегов <input>).

Для идентификации компонентов формы используются несколько видоизмененные правила. Итак, для того, чтобы получить какой-либо компоненты формы, например, при помощи метода **WactTemplate :: getChild()**, нужно использовать:

* Значение атрибута ID, если он установлен.
  * Значение атрибута name, если атрибут id не установлен.
  * Если атрибуты ID и name не указаны, то WACT сгенерирует идентификатор случайным образом, поэтому идентификатор "угадать" будет сложно.

Например:

<input type="text" id="Input1" name="foo">

<input type="text" name="bar">

<input type="text">
</form>
</code>

===== Наследование значения атрибута runat="server" =====

Если форма содержит несколько элементов и является тегом с активным компонентом, тогда все элементы формы будут также иметь активные компоненты. Это называется наследование значения атрибута runat.

Наследование runat работает для таких тегов форм как:
  * <input>
  * <label>
  * <select>
  * <textarea>

Например:

<label for="email">Email:</label> <input type="text" value="email">
<br>

</form>
</code>

Все элементы этой формы будут иметь активный компонент после компиляции
===== Отмена наследования runat атрибута =====

Обратите внимание, что тег ''<input type="submit">'' в примере также будет иметь активный компонент, что совсем не обязательно, а иногда даже ошибочно.

Есть два способа "отключить" наследование значения атрибута runat="server".

Наследование может быть отключено совсем при помощи атрибута ''children_reuse_runat="false"'' тега <form>, например, так:

<label for="email">Email:</label> <input type="text" value="email"/>
<br>

</form>
</code>

Другой способ, это указать другое значение атрибута runat, то есть **runat="client"** или же поместить его в тег [[.tags:core_tags:core_literal_tag|CoreLiteralTag]], например:

<label for="name">Name:</label> <input type="text" value="name">
<br>
<label for="email">Email:</label> <input type="text" value="email">
<br>

<input type="submit" runat="client">

<core:literal>
<input type="reset">
</core:literal>

</form>
</code>

===== Теги полей формы с runat='server' внутри обычной html-формы =====

При желании можно использовать WACT-теги форм без использования <form runat='server'>. Эта возможность появилась, начиная с версии 0.5

Чаще всего эту возможность используют для тега <select>, который в этом случае позволяет генерить набор <option> тегов средствами WACT, например:

<select:options_source from="{$#items}" use_as_name='name' target='item_select'/>

Здесь мы использовали тег <select:options_source> для формирования массива данных для <options> списка и тег <select runat='server'> для генерации этого списка. До верси 0.5 этой возможности без наличия <form runat='server'> не было и приходилось генерить списки опций при помощи php-кода, что не всегда удобно.

===== Использование атрибута given_value для указания значения элемента формы =====

В вышеприведенном примере мы использовали атрибут **given_value** для указания значения опции, которая выбрана внутри <select> тега.

**given_value** поддерживается для следующих WACT-тегов элементов форм:
  * input
  * select
  * textarea
  * js_checkbox
  * wysiwyg (при установке пакета WYSIWYG)

Естественно, соответствующий тег должен иметь также атрибут runat='server' или наследовать этот признак от формы:

<select id='featured_status' name='featured_status' runat='server' given_value='{$#news.status}'>
  <option value='0'>Новая</option>
  <option value='1'>Утвержденная</option>
  <option value='2'>Архивная</option>
</select>

</form>
</code>

В качестве given_value можно использовать любое [[expressions|выражение]].

P.S. Почему именно given_value - все дело в теге <input type='checkbox' value='some_value'>, где атрибут value используется для других целей, а нам хотелось реализовать нечто общее для всех тегов.

===== Элементы форм с динамическими атрибутами name и id =====

Начиная с версии 0.5 WACT-теги элементов форм могут использовать динамические значения для атрибутов **name** и **id**, например:

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

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

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

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

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

Фремворк Limb

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

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

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