smarty-php/smarty
1
0
Fork 0
mirror of https://github.com/smarty-php/smarty.git synced 2025-08-07 03:44:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

Sync with EN.

Browse Source
This commit is contained in:
laggy.luke
2008-07-26 09:14:39 +00:00
parent 3823c751de
commit 511d135c39
3 changed files with 434 additions and 157 deletions
Download Patch File Download Diff File Expand all files Collapse all files

102
docs/ru/designers/language-builtin-functions/language-function-capture.xml
View File

@@ -1,42 +1,83 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready --> <!-- EN-Revision: 2627 Maintainer: freespace Status: ready -->
<sect1 id="language.function.capture"> <sect1 id="language.function.capture">
<title>capture</title> <title>{capture}</title>
<para> <para>
{capture} используется для того, чтобы собрать результат обработки <varname>{capture}</varname> используется для того, чтобы собрать результат
части шаблона между тэгами обработки части шаблона между тэгами в какую-то переменную, вместо того,
в какую-то переменную, вместо того, чтобы вывести результат браузеру. чтобы отобразить результат.
Любое содержимое между {capture name='foo'} и {/capture} сохраняется в Любое содержимое между <varname>{capture name='foo'}</varname> и
переменную, указанную в атрибуте name. <varname>{/capture}</varname> сохраняется в переменную, указанную в атрибуте
<parameter>name</parameter>.
</para> </para>
<para> <para>
Захваченные данные могут в дальнейшем использоваться в Захваченные данные могут в дальнейшем использоваться в
шаблоне при помощи специальной переменной <link шаблоне при помощи специальной переменной <link
linkend="language.variables.smarty.capture">$smarty.capture.foo</link>, linkend="language.variables.smarty.capture"><parameter>$smarty.capture.foo</parameter></link>,
где "foo" - значение, переданное атрибуту name. Если атрибут name не указан, где <quote>foo</quote> - значение, переданное атрибуту <parameter>name</parameter>.
то используется "default". Если атрибут <parameter>name</parameter> не указан,
то используется <quote>default</quote>, т.е. <parameter>$smarty.capture.default</parameter>.
</para> </para>
<para> <para>
Команда capture поддерживает вложенность. Функция <varname>{capture}</varname> поддерживает вложенность.
</para> </para>
<caution> <informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Имя атрибута</entry>
<entry>Тип</entry>
<entry>Обязателен</entry>
<entry>По умолчанию</entry>
<entry>Описание</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Нет</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Имя блока для сохранения</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Нет</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Имя переменной для сохранения результатов</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<note>
<title>Внимание</title>
<para> <para>
Будте осторожны, сохраняя вывод команды <link Будте осторожны, сохраняя результат команды <link
linkend="language.function.insert">{insert}</link>. linkend="language.function.insert"><varname>{insert}</varname></link>.
Если вы используете <link linkend="caching">кэширование</link> Если вы используете
<link linkend="caching"><parameter>кэширование</parameter></link>
и в области кэширования встречаются команды и в области кэширования встречаются команды
<command>insert</command>, то не сохраняйте данный вывод. <link linkend="language.function.insert"><varname>{insert}</varname></link>,
то не сохраняйте данный вывод.
</para> </para>
</caution> </note>
<para> <para>
<example> <example>
<title>Сохранение вывода шаблона</title> <title>Сохранение вывода шаблона в указанный атрибут</title>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
{* мы не хотим выводить слой div, если содержимое не отображается *} {* мы не хотим отображать тэг div, если его содержимое не отображается *}
{capture name=banner} {capture name=banner}
{include file='get_banner.tpl'} {include file='get_banner.tpl'}
{/capture} {/capture}
@@ -48,30 +89,31 @@
</example> </example>
<example> <example>
<title>сохранение содержимого в переменную</title> <title>Сохранение содержимого в переменную</title>
<para> <para>
Этот пример также демонстрирует функцию Этот пример также демонстрирует функцию
<link linkend="language.function.popup">{popup}</link> <link linkend="language.function.popup"><varname>{popup}</varname></link>
</para> </para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
{capture name=some_content assign=popText} {capture name=some_content assign=popText}
The server is {$smarty.server.SERVER_NAME|upper} at {$smarty.server.SERVER_ADDR}<br /> Имя сервера: {$smarty.server.SERVER_NAME|upper}<br />
Your ip is {$smarty.server.REMOTE_ADDR}. Адрес сервера: {$smarty.server.SERVER_ADDR}<br />
Ваш IP: {$smarty.server.REMOTE_ADDR}.
{/capture} {/capture}
<a href="#" {popup caption='Server Info' text=$popText}>help</a> <a href="#" {popup caption='Информация о Сервере' text=$popText}>help</a>
]]> ]]>
</programlisting> </programlisting>
</example> </example>
</para> </para>
<para> <para>
См. также См. также
<link linkend="language.variables.smarty.capture">$smarty.capture</link>, <link linkend="language.variables.smarty.capture"><parameter>$smarty.capture</parameter></link>,
<link linkend="language.function.eval">{eval}</link>, <link linkend="language.function.eval"><varname>{eval}</varname></link>,
<link linkend="language.function.fetch">{fetch}</link>, <link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
<link linkend="api.fetch">fetch()</link> <link linkend="api.fetch"><varname>fetch()</varname></link>
и <link linkend="language.function.assign">{assign}</link>. и <link linkend="language.function.assign"><varname>{assign}</varname></link>.
</para> </para>
</sect1> </sect1>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file

25
docs/ru/designers/language-builtin-functions/language-function-config-load.xml
View File

@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready --> <!-- EN-Revision: 2715 Maintainer: freespace Status: ready -->
<sect1 id="language.function.config.load"> <sect1 id="language.function.config.load">
<title>{config_load}</title> <title>{config_load}</title>
<para> <para>
{config_load} используется для загрузки конфигурационных переменных <varname>{config_load}</varname> используется для загрузки
(<link linkend="language.config.variables">#variable#</link>) из конфигурационных переменных
(<link linkend="language.config.variables"><parameter>#variables#</parameter></link>) из
<link linkend="config.files">конфигурационных файлов</link> в шаблон. <link linkend="config.files">конфигурационных файлов</link> в шаблон.
</para> </para>
<informaltable frame="all"> <informaltable frame="all">
@@ -72,7 +73,9 @@
</informaltable> </informaltable>
<example> <example>
<title>{config_load}</title> <title>{config_load}</title>
<para>example.conf</para> <para>
Файл <filename>example.conf</filename>.
</para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
#это комментарий конфигурационного файла #это комментарий конфигурационного файла
@@ -114,13 +117,15 @@ pageTitle = "Customer Info"
<link linkend="config.files">Конфигурационные файлы</link> <link linkend="config.files">Конфигурационные файлы</link>
могут также содержать секции. Вы можете загружать могут также содержать секции. Вы можете загружать
переменные из определенной секции, указав атрибут переменные из определенной секции, указав атрибут
<emphasis>'section'</emphasis>. <parameter>section</parameter>. Имейте в виду, что глобальные
конфигурационные переменные всегда загружаются вместе с секционными
переменными, которые могут переопределять их.
</para> </para>
<note> <note>
<para> <para>
<emphasis>Секции файлов конфигурации</emphasis> и встроенная <emphasis>Секции файлов конфигурации</emphasis> и встроенная
функция функция
<link linkend="language.function.section"><emphasis>{section}</emphasis></link> <link linkend="language.function.section"><varname>{section}</varname></link>
не имеют ничего общего, кроме схожего названия. не имеют ничего общего, кроме схожего названия.
</para> </para>
</note> </note>
@@ -149,17 +154,17 @@ pageTitle = "Customer Info"
</example> </example>
<para> <para>
См. <link linkend="variable.config.overwrite">$config_overwrite</link> См. <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>
для массивов конфигурационных переменных. для массивов конфигурационных переменных.
</para> </para>
<para> <para>
См. также <link linkend="config.files">Конфигурационные файлы</link>, См. также <link linkend="config.files">Конфигурационные файлы</link>,
<link linkend="language.config.variables">Конфигурационные переменные</link>, <link linkend="language.config.variables">Конфигурационные переменные</link>,
<link linkend="variable.config.dir">$config_dir</link>, <link linkend="variable.config.dir"><parameter>$config_dir</parameter></link>,
<link linkend="api.get.config.vars">get_config_vars()</link> <link linkend="api.get.config.vars"><varname>get_config_vars()</varname></link>
и и
<link linkend="language.function.config.load">config_load()</link>. <link linkend="api.config.load"><varname>config_load()</varname></link>.
</para> </para>
</sect1> </sect1>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file

464
docs/ru/designers/language-builtin-functions/language-function-foreach.xml
View File

@@ -1,30 +1,23 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready --> <!-- EN-Revision: 2767 Maintainer: freespace Status: ready -->
<sect1 id="language.function.foreach"> <sect1 id="language.function.foreach">
<title>{foreach},{foreachelse}</title> <title>{foreach},{foreachelse}</title>
<para> <para>
Циклы <emphasis>{foreach}</emphasis> являются альтернативой <varname>{foreach}</varname> используется для работы как с
циклам <link <emphasis role="bold">ассоциативным</emphasis>,
linkend="language.function.section"><emphasis>{section}</emphasis></link>. так и с числовыми массивами, в отличие от функции
<emphasis>{foreach}</emphasis> используется для прохода по <link linkend="language.function.section"><varname>{section}</varname></link>,
<emphasis role="bold">единственному ассоциативному массиву</emphasis>. которая предназначена для работы
Синтаксис <emphasis role="bold">исключительно с числовыми массивами</emphasis>.
<emphasis>{foreach}</emphasis> намного проще синтаксиса
<emphasis>{section}</emphasis>, но с другой стороны Синтаксис функции <varname>{foreach}</varname> намного проще, чем
<emphasis role="bold">его можно использовать только для одного массива</emphasis>. <link linkend="language.function.section"><varname>{section}</varname></link>,
Каждый тэг <emphasis>{foreach}</emphasis> должен иметь пару но она может работать <emphasis role="bold">только с одним массивом</emphasis>
<emphasis>{/foreach}</emphasis>. Обязательными параметрами являются одновременно. Каждый тэг <varname>{foreach}</varname> должен иметь
<emphasis>from</emphasis> и <emphasis>item</emphasis>. закрывающую пару <varname>{/foreach}</varname>.
Имя цикла {foreach} может быть любым, состоящим из букв, цифр и знаков
подчеркивания. Циклы <emphasis>{foreach}</emphasis> могут быть вложенными
и имена вложенных {foreach} должны быть уникакльными между собой.
Параметр <emphasis>from</emphasis> (обычно - массив значений)
определяет количество итераций цикла <emphasis>{foreach}</emphasis>.
<emphasis>{foreachelse}</emphasis> выполняется в том случае, если
параметр <emphasis>from</emphasis> не содержит значений.
</para> </para>
<informaltable frame="all"> <informaltable frame="all">
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="param" align="center" /> <colspec colname="param" align="center" />
@@ -54,45 +47,121 @@
<entry>string</entry> <entry>string</entry>
<entry>Да</entry> <entry>Да</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Имя переменной, которая будет выступать в <entry>Имя переменной, которая будет значением текущего елемента</entry>
качестве значения текущего елемента</entry>
</row> </row>
<row> <row>
<entry>key</entry> <entry>key</entry>
<entry>string</entry> <entry>string</entry>
<entry>Нет</entry> <entry>Нет</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Имя переменной, которая будет выступать в <entry>Имя переменной, которая будет ключом текущего елемента</entry>
качестве ключа текущего елемента</entry>
</row> </row>
<row> <row>
<entry>name</entry> <entry>name</entry>
<entry>string</entry> <entry>string</entry>
<entry>Нет</entry> <entry>Нет</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Название цикла foreach для доступа к его <entry>Название цикла foreach для доступа к его свойствам</entry>
свойствам</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<itemizedlist>
<listitem>
<para>
Атрибуты <parameter>from</parameter> и <parameter>item</parameter>
являются обязательными.
</para>
</listitem>
<listitem>
<para>
Параметр <parameter>name</parameter> цикла <varname>{foreach}</varname>
может состоять из букв, цифр и знака подчеркивания, как и
<ulink url="&url.php-manual;language.variables">переменные PHP</ulink>.
</para>
</listitem>
<listitem>
<para>
Циклы <varname>{foreach}</varname> могут быть вложенными при условии, что
их имена будут уникальными.
</para>
</listitem>
<listitem>
<para>
Атрибут <parameter>from</parameter>, обычно являющийся массивом,
определяет количество проходов цикла <varname>{foreach}</varname>.
</para>
</listitem>
<listitem>
<para>
Блок <varname>{foreachelse}</varname> выполняется в том случае, если
в параметре <parameter>from</parameter> нет значений.
</para>
</listitem>
<listitem>
<para>
У циклов <varname>{foreach}</varname> также есть собственные переменные,
которые обрабатывают свойства.
Доступ к ним можно получить таким образом:
<link linkend="language.variables.smarty.loops">
<parameter>{$smarty.foreach.name.property}</parameter></link>, где
<quote>name</quote> - атрибут <parameter>name</parameter> функции
<varname>{foreach}</varname>.
</para>
<note>
<title>Обратите внимание</title>
<para>
Атрибут <parameter>name</parameter> необходим только в том случае,
когда у вас есть необходимость обращаться к свойствам
<varname>{foreach}</varname>, в отличие от функции
<link linkend="language.function.section"><varname>{section}</varname></link>.
Обращение к свойствам <varname>{foreach}</varname> с неопределенным
<parameter>name</parameter> не вызывает ошибки, но ведёт к непредсказуемым
результатам.
</para>
</note>
</listitem>
<listitem>
<para>
<varname>{foreach}</varname> имеет следующие свойства:
<link linkend="foreach.property.index"><parameter>index</parameter></link>,
<link linkend="foreach.property.iteration"><parameter>iteration</parameter></link>,
<link linkend="foreach.property.first"><parameter>first</parameter></link>,
<link linkend="foreach.property.last"><parameter>last</parameter></link>,
<link linkend="foreach.property.show"><parameter>show</parameter></link> и
<link linkend="foreach.property.total"><parameter>total</parameter></link>.
</para>
</listitem>
</itemizedlist>
<example> <example>
<title>{foreach} - предмет</title> <title>Атрибут <parameter>item</parameter></title>
<programlisting role="php"> <programlisting role="php">
<![CDATA[ <![CDATA[
<?php <?php
$arr = array( 1001,1002,1003); $arr = array(1000, 1001, 1002);
$smarty->assign('custid', $arr); $smarty->assign('myArray', $arr);
?> ?>
]]> ]]>
</programlisting> </programlisting>
<para>
Шаблон для отображения <parameter>$myArray</parameter> в виде
ненумерованного списка
</para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
{* этот пример напечатает все переменные массива $custid *} <ul>
{foreach from=$custid item=curr_id} {foreach from=$myArray item=foo}
id: {$curr_id}<br /> <li>{$foo}</li>
{/foreach} {/foreach}
</ul>
]]> ]]>
</programlisting> </programlisting>
<para> <para>
@@ -100,39 +169,115 @@ $smarty->assign('custid', $arr);
</para> </para>
<screen> <screen>
<![CDATA[ <![CDATA[
id: 1000<br /> <ul>
id: 1001<br /> <li>1000</li>
id: 1002<br /> <li>1001</li>
<li>1002</li>
</ul>
]]> ]]>
</screen> </screen>
</example> </example>
<example> <example>
<title>{foreach} - предмет и ключ</title> <title>Пример работы атрибутов <parameter>item</parameter> и <parameter>key</parameter></title>
<programlisting role="php"> <programlisting role="php">
<![CDATA[ <![CDATA[
// Ключ содержит ключ для каждого значения из цикла
// назначение выглядит примерно так:
<?php <?php
$smarty->assign('contacts', array( $arr = array(9 => 'Tennis', 3 => 'Swimming', 8 => 'Coding');
array('phone' => '1', $smarty->assign('myArray', $arr);
'fax' => '2',
'cell' => '3'),
array('phone' => '555-4444',
'fax' => '555-3333',
'cell' => '760-1234')
));
?> ?>
]]> ]]>
</programlisting> </programlisting>
<para>
Шаблон для отображения <parameter>$myArray</parameter> в виде пар ключ/значение,
как <ulink url="&url.php-manual;foreach"><varname>foreach</varname></ulink>
в PHP.</para>
<programlisting>
<![CDATA[
<ul>
{foreach from=$myArray key=k item=v}
<li>{$k}: {$v}</li>
{/foreach}
</ul>
]]>
</programlisting>
<para>
Результат выполнения данного примера:
</para>
<screen>
<![CDATA[
<ul>
<li>9: Tennis</li>
<li>3: Swimming</li>
<li>8: Coding</li>
</ul>
]]>
</screen>
</example>
<example>
<title>{foreach} с ассоциативным атрибутом <parameter>item</parameter></title>
<programlisting role="php">
<![CDATA[
<?php
$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
96 => array('no' => 4889, 'label' => 'Cream')
);
$smarty->assign('items', $items_list);
?>
]]>
</programlisting>
<para>
Шаблон для отображения элементов <parameter>$items</parameter>, в котором
<parameter>$myId</parameter> используется в URL'е
</para>
<programlisting>
<![CDATA[
<ul>
{foreach from=$items key=myId item=i}
<li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
{/foreach}
</ul>
]]>
</programlisting>
<para>
Результат выполнения данного примера:
</para>
<screen>
<![CDATA[
<ul>
<li><a href="item.php?id=23">2456: Salad</li>
<li><a href="item.php?id=96">4889: Cream</li>
</ul>
]]>
</screen>
</example>
<example>
<title>{foreach} со вложенными <parameter>item</parameter> и <parameter>key</parameter></title>
<para>В Smarty передан такой массив, ключ которого содержит ключ для каждого перебираемого значения.</para>
<programlisting role="php">
<![CDATA[
<?php
$smarty->assign('contacts', array(
array('phone' => '1',
'fax' => '2',
'cell' => '3'),
array('phone' => '555-4444',
'fax' => '555-3333',
'cell' => '760-1234')
));
?>
]]>
</programlisting>
<para>Шаблон для отображения <parameter>$contact</parameter>.</para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
{foreach name=outer item=contact from=$contacts} {foreach name=outer item=contact from=$contacts}
<hr /> <hr />
{foreach key=key item=item from=$contact} {foreach key=key item=item from=$contact}
{$key}: {$item}&lt;br&gt; {$key}: {$item}<br />
{$key}: {$item}<br /> {/foreach}
{/foreach}
{/foreach} {/foreach}
]]> ]]>
</programlisting> </programlisting>
@@ -142,93 +287,178 @@ $smarty->assign('contacts', array(
<screen> <screen>
<![CDATA[ <![CDATA[
<hr /> <hr />
phone: 1<br /> phone: 1<br />
fax: 2<br /> fax: 2<br />
cell: 3<br /> cell: 3<br />
<hr /> <hr />
phone: 555-4444<br /> phone: 555-4444<br />
fax: 555-3333<br /> fax: 555-3333<br />
cell: 760-1234<br /> cell: 760-1234<br />
]]> ]]>
</screen> </screen>
</example> </example>
<example> <example>
<title>{foreach} - базы данных (к примеру, PEAR или ADODB)</title> <title>Пример использования {foreachelse} при работе с базой данных</title>
<programlisting role="php"> <para>
Пример работы с базой данных (при помощи PEAR или ADODB) в скрипте поиска,
результаты которого передаются в Smarty.
</para>
<programlisting role="php">
<![CDATA[ <![CDATA[
<?php <?php
$sql = 'select contact_id, name, nick from contacts order by contact'; $search_condition = "WHERE name LIKE '$foo%' ";
$smarty->assign("contacts", $db->getAssoc($sql)); $sql = 'SELECT contact_id, name, nick FROM contacts '.$search_condition.' ORDER BY name';
$smarty->assign('results', $db->getAssoc($sql) );
?> ?>
]]> ]]>
</programlisting> </programlisting>
<para>
Шаблон отобразит сообщение <quote>Ничего не найдено</quote> при помощи
<varname>{foreachelse}</varname> в случае, если поиск не дал результатов.
</para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
{foreach key=cid item=con from=$contacts} {foreach key=cid item=con from=$results}
<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br /> <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
{foreachelse}
Ничего не найдено
{/foreach} {/foreach}
]]> ]]>
</programlisting> </programlisting>
</example> </example>
<para> <sect2 id="foreach.property.index">
Циклы {foreach} также имеют собственные переменные, которые содержат свойства <title>.index</title>
{foreach}. <para>
Они обозначаются так: <parameter>index</parameter> contains the current array index, starting with zero.
<link linkend="language.variables.smarty.loops">{$smarty.foreach.foreachname.varname}</link> </para>
{$smarty.foreach.foreachname.varname}, где foreachname - это название цикла <example>
(значение атрибута <emphasis>name</emphasis>). <title><parameter>index</parameter> example</title>
</para>
<para>
См. <link linkend="section.property.index">{section}</link>
для примеров следующих свойств, так как они идентичны.
</para>
<sect2 id="foreach.property.iteration"> <programlisting role="php">
<title>iteration</title> <![CDATA[
<para> {* The header block is output every five rows *}
iteration используется для отображения текущего номера итерации цикла. <table>
Итерации всегда начинаются с 1 и увеличиваются на одну при каждом {foreach from=$items key=myId item=i name=foo}
прохождении цикла. {if $smarty.foreach.foo.index % 5 == 0}
</para> <tr><th>Title</th></tr>
</sect2> {/if}
<tr><td>{$i.label}</td></tr>
{/foreach}
</table>
]]>
</programlisting>
</example>
</sect2>
<sect2 id="foreach.property.first"> <sect2 id="foreach.property.iteration">
<title>first</title> <title>.iteration</title>
<para> <para>
<emphasis>first</emphasis> устанавливается в true, если текущая итерация первая. <parameter>iteration</parameter> содержит значение текущей итерации цикла
</para> и всегда начинается с единицы, в отличие от
</sect2> <link linkend="foreach.property.index"><parameter>index</parameter></link>.
Это значение увеличивается на единицу с каждой следующей итерацией.
</para>
<example>
<title>Примеры работы с <parameter>iteration</parameter> и <parameter>index</parameter></title>
<programlisting role="php">
<![CDATA[
{* этот шаблон выведет 0|1, 1|2, 2|3, ... и т.д. *}
{foreach from=$myArray item=i name=foo}
{$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
{/foreach}
]]>
</programlisting>
</example>
<sect2 id="foreach.property.last">
<title>last</title>
<para>
<emphasis>last</emphasis> устанавливается в true, если текущая итерация последняя.
</para>
</sect2>
<sect2 id="foreach.property.show">
<title>show</title>
<para>
Атрибут <emphasis>show</emphasis> может принимать логические
значения (истина или ложь). Если ложь, то цикл foreach не будет
отображаться. Если присутствует тэг foreachelse, то он будет
отображен.
</para>
</sect2> </sect2>
<sect2 id="foreach.property.total"> <sect2 id="foreach.property.first">
<title>total</title> <title>.first</title>
<para> <para>
<emphasis>total</emphasis> хранит количество итераций цикла. Свойство <parameter>first</parameter> равно &true;, если текущая итерация
Может быть использовано как в цикле, так и вне его. <varname>{foreach}</varname> - первая.
</para> </para>
<example>
<title>Пример использования свойства <parameter>first</parameter></title>
<programlisting role="php">
<![CDATA[
{* отображаем "НОВОЕ" напротив первого элемента, иначе id *}
<table>
{foreach from=$items key=myId item=i name=foo}
<tr>
<td>{if $smarty.foreach.foo.first}НОВОЕ{else}{$myId}{/if}</td>
<td>{$i.label}</td>
</tr>
{/foreach}
</table>
]]>
</programlisting>
</example>
</sect2>
<sect2 id="foreach.property.last">
<title>.last</title>
<para>
Свойство <parameter>last</parameter> равно &true;, если текущая итерация
<varname>{foreach}</varname> - последняя.
</para>
<example>
<title>Пример использования свойства <parameter>last</parameter></title>
<programlisting role="php">
<![CDATA[
{* Добавляем горизонтальную полосу (<hr />) в конце списка *}
{foreach from=$items key=part_id item=prod name=products}
<a href="#{$part_id}">{$prod}</a>{if $smarty.foreach.products.last}<hr />{else},{/if}
{foreachelse}
... content ...
{/foreach}
]]>
</programlisting>
</example>
</sect2>
<sect2 id="foreach.property.show">
<title>.show</title>
<para>
<parameter>show</parameter> используется как параметр для <varname>{foreach}</varname>.
<parameter>show</parameter> - это булевое значение.
Если оно равно &false;, результат работы <varname>{foreach}</varname> не будет отображен.
Если присутствует директива <varname>{foreachelse}</varname>, её содержимое
будет отображено.
</para>
</sect2>
<sect2 id="foreach.property.total">
<title>.total</title>
<para>
<parameter>total</parameter> содержит общее количество итераций,
которое пройдет данный цикл <varname>{foreach}</varname>.
Его можно использовать во время или после выполнения <varname>{foreach}</varname>.
</para>
<example>
<title>Пример использования свойства <parameter>total</parameter></title>
<programlisting role="php">
<![CDATA[
{* отображаем количество отображенных строк в конце *}
{foreach from=$items key=part_id item=prod name=foo}
{$prod.name}<hr/>
{if $smarty.foreach.foo.last}
<div id="total">{$smarty.foreach.foo.total} предметов</div>
{/if}
{foreachelse}
... что-то другое ...
{/foreach}
]]>
</programlisting>
</example>
<para> <para>
См. также <link linkend="language.function.section">{section}</link> и См. также
<link linkend="language.variables.smarty.loops">$smarty.foreach</link>. <link linkend="language.function.section"><varname>{section}</varname></link>
и
<link linkend="language.variables.smarty.loops"><parameter>$smarty.foreach</parameter></link>.
</para> </para>
</sect2> </sect2>
</sect1> </sect1>