mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-07 03:44:26 +02:00
Sync with EN.
This commit is contained in:
laggy.luke
@@ -1,42 +1,83 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
|
||||
<!-- EN-Revision: 2627 Maintainer: freespace Status: ready -->
|
||||
<sect1 id="language.function.capture">
|
||||
<title>capture</title>
|
||||
<title>{capture}</title>
|
||||
<para>
|
||||
{capture} используется для того, чтобы собрать результат обработки
|
||||
части шаблона между тэгами
|
||||
в какую-то переменную, вместо того, чтобы вывести результат браузеру.
|
||||
Любое содержимое между {capture name='foo'} и {/capture} сохраняется в
|
||||
переменную, указанную в атрибуте name.
|
||||
<varname>{capture}</varname> используется для того, чтобы собрать результат
|
||||
обработки части шаблона между тэгами в какую-то переменную, вместо того,
|
||||
чтобы отобразить результат.
|
||||
Любое содержимое между <varname>{capture name='foo'}</varname> и
|
||||
<varname>{/capture}</varname> сохраняется в переменную, указанную в атрибуте
|
||||
<parameter>name</parameter>.
|
||||
</para>
|
||||
<para>
|
||||
Захваченные данные могут в дальнейшем использоваться в
|
||||
шаблоне при помощи специальной переменной <link
|
||||
linkend="language.variables.smarty.capture">$smarty.capture.foo</link>,
|
||||
где "foo" - значение, переданное атрибуту name. Если атрибут name не указан,
|
||||
то используется "default".
|
||||
linkend="language.variables.smarty.capture"><parameter>$smarty.capture.foo</parameter></link>,
|
||||
где <quote>foo</quote> - значение, переданное атрибуту <parameter>name</parameter>.
|
||||
Если атрибут <parameter>name</parameter> не указан,
|
||||
то используется <quote>default</quote>, т.е. <parameter>$smarty.capture.default</parameter>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Команда capture поддерживает вложенность.
|
||||
Функция <varname>{capture}</varname> поддерживает вложенность.
|
||||
</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>
|
||||
Будте осторожны, сохраняя вывод команды <link
|
||||
linkend="language.function.insert">{insert}</link>.
|
||||
Если вы используете <link linkend="caching">кэширование</link>
|
||||
Будте осторожны, сохраняя результат команды <link
|
||||
linkend="language.function.insert"><varname>{insert}</varname></link>.
|
||||
Если вы используете
|
||||
<link linkend="caching"><parameter>кэширование</parameter></link>
|
||||
и в области кэширования встречаются команды
|
||||
<command>insert</command>, то не сохраняйте данный вывод.
|
||||
<link linkend="language.function.insert"><varname>{insert}</varname></link>,
|
||||
то не сохраняйте данный вывод.
|
||||
</para>
|
||||
</caution>
|
||||
</note>
|
||||
|
||||
<para>
|
||||
<example>
|
||||
<title>Сохранение вывода шаблона</title>
|
||||
<title>Сохранение вывода шаблона в указанный атрибут</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* мы не хотим выводить слой div, если содержимое не отображается *}
|
||||
{* мы не хотим отображать тэг div, если его содержимое не отображается *}
|
||||
{capture name=banner}
|
||||
{include file='get_banner.tpl'}
|
||||
{/capture}
|
||||
@@ -48,30 +89,31 @@
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>сохранение содержимого в переменную</title>
|
||||
<title>Сохранение содержимого в переменную</title>
|
||||
<para>
|
||||
Этот пример также демонстрирует функцию
|
||||
<link linkend="language.function.popup">{popup}</link>
|
||||
<link linkend="language.function.popup"><varname>{popup}</varname></link>
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{capture name=some_content assign=popText}
|
||||
The server is {$smarty.server.SERVER_NAME|upper} at {$smarty.server.SERVER_ADDR}<br />
|
||||
Your ip is {$smarty.server.REMOTE_ADDR}.
|
||||
Имя сервера: {$smarty.server.SERVER_NAME|upper}<br />
|
||||
Адрес сервера: {$smarty.server.SERVER_ADDR}<br />
|
||||
Ваш IP: {$smarty.server.REMOTE_ADDR}.
|
||||
{/capture}
|
||||
|
||||
<a href="#" {popup caption='Server Info' text=$popText}>help</a>
|
||||
<a href="#" {popup caption='Информация о Сервере' text=$popText}>help</a>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</para>
|
||||
<para>
|
||||
См. также
|
||||
<link linkend="language.variables.smarty.capture">$smarty.capture</link>,
|
||||
<link linkend="language.function.eval">{eval}</link>,
|
||||
<link linkend="language.function.fetch">{fetch}</link>,
|
||||
<link linkend="api.fetch">fetch()</link>
|
||||
и <link linkend="language.function.assign">{assign}</link>.
|
||||
<link linkend="language.variables.smarty.capture"><parameter>$smarty.capture</parameter></link>,
|
||||
<link linkend="language.function.eval"><varname>{eval}</varname></link>,
|
||||
<link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
|
||||
<link linkend="api.fetch"><varname>fetch()</varname></link>
|
||||
и <link linkend="language.function.assign"><varname>{assign}</varname></link>.
|
||||
</para>
|
||||
</sect1>
|
||||
<!-- Keep this comment at the end of the file
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
|
||||
<!-- EN-Revision: 2715 Maintainer: freespace Status: ready -->
|
||||
<sect1 id="language.function.config.load">
|
||||
<title>{config_load}</title>
|
||||
<para>
|
||||
{config_load} используется для загрузки конфигурационных переменных
|
||||
(<link linkend="language.config.variables">#variable#</link>) из
|
||||
<varname>{config_load}</varname> используется для загрузки
|
||||
конфигурационных переменных
|
||||
(<link linkend="language.config.variables"><parameter>#variables#</parameter></link>) из
|
||||
<link linkend="config.files">конфигурационных файлов</link> в шаблон.
|
||||
</para>
|
||||
<informaltable frame="all">
|
||||
@@ -72,7 +73,9 @@
|
||||
</informaltable>
|
||||
<example>
|
||||
<title>{config_load}</title>
|
||||
<para>example.conf</para>
|
||||
<para>
|
||||
Файл <filename>example.conf</filename>.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
#это комментарий конфигурационного файла
|
||||
@@ -114,13 +117,15 @@ pageTitle = "Customer Info"
|
||||
<link linkend="config.files">Конфигурационные файлы</link>
|
||||
могут также содержать секции. Вы можете загружать
|
||||
переменные из определенной секции, указав атрибут
|
||||
<emphasis>'section'</emphasis>.
|
||||
<parameter>section</parameter>. Имейте в виду, что глобальные
|
||||
конфигурационные переменные всегда загружаются вместе с секционными
|
||||
переменными, которые могут переопределять их.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
<emphasis>Секции файлов конфигурации</emphasis> и встроенная
|
||||
функция
|
||||
<link linkend="language.function.section"><emphasis>{section}</emphasis></link>
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>
|
||||
не имеют ничего общего, кроме схожего названия.
|
||||
</para>
|
||||
</note>
|
||||
@@ -149,17 +154,17 @@ pageTitle = "Customer Info"
|
||||
</example>
|
||||
|
||||
<para>
|
||||
См. <link linkend="variable.config.overwrite">$config_overwrite</link>
|
||||
См. <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>
|
||||
для массивов конфигурационных переменных.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
См. также <link linkend="config.files">Конфигурационные файлы</link>,
|
||||
<link linkend="language.config.variables">Конфигурационные переменные</link>,
|
||||
<link linkend="variable.config.dir">$config_dir</link>,
|
||||
<link linkend="api.get.config.vars">get_config_vars()</link>
|
||||
<link linkend="variable.config.dir"><parameter>$config_dir</parameter></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>
|
||||
</sect1>
|
||||
<!-- Keep this comment at the end of the file
|
||||
|
||||
@@ -1,28 +1,21 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
|
||||
<!-- EN-Revision: 2767 Maintainer: freespace Status: ready -->
|
||||
<sect1 id="language.function.foreach">
|
||||
<title>{foreach},{foreachelse}</title>
|
||||
<para>
|
||||
Циклы <emphasis>{foreach}</emphasis> являются альтернативой
|
||||
циклам <link
|
||||
linkend="language.function.section"><emphasis>{section}</emphasis></link>.
|
||||
<emphasis>{foreach}</emphasis> используется для прохода по
|
||||
<emphasis role="bold">единственному ассоциативному массиву</emphasis>.
|
||||
Синтаксис
|
||||
<emphasis>{foreach}</emphasis> намного проще синтаксиса
|
||||
<emphasis>{section}</emphasis>, но с другой стороны
|
||||
<emphasis role="bold">его можно использовать только для одного массива</emphasis>.
|
||||
Каждый тэг <emphasis>{foreach}</emphasis> должен иметь пару
|
||||
<emphasis>{/foreach}</emphasis>. Обязательными параметрами являются
|
||||
<emphasis>from</emphasis> и <emphasis>item</emphasis>.
|
||||
Имя цикла {foreach} может быть любым, состоящим из букв, цифр и знаков
|
||||
подчеркивания. Циклы <emphasis>{foreach}</emphasis> могут быть вложенными
|
||||
и имена вложенных {foreach} должны быть уникакльными между собой.
|
||||
Параметр <emphasis>from</emphasis> (обычно - массив значений)
|
||||
определяет количество итераций цикла <emphasis>{foreach}</emphasis>.
|
||||
<emphasis>{foreachelse}</emphasis> выполняется в том случае, если
|
||||
параметр <emphasis>from</emphasis> не содержит значений.
|
||||
<varname>{foreach}</varname> используется для работы как с
|
||||
<emphasis role="bold">ассоциативным</emphasis>,
|
||||
так и с числовыми массивами, в отличие от функции
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>,
|
||||
которая предназначена для работы
|
||||
<emphasis role="bold">исключительно с числовыми массивами</emphasis>.
|
||||
|
||||
Синтаксис функции <varname>{foreach}</varname> намного проще, чем
|
||||
<link linkend="language.function.section"><varname>{section}</varname></link>,
|
||||
но она может работать <emphasis role="bold">только с одним массивом</emphasis>
|
||||
одновременно. Каждый тэг <varname>{foreach}</varname> должен иметь
|
||||
закрывающую пару <varname>{/foreach}</varname>.
|
||||
</para>
|
||||
|
||||
<informaltable frame="all">
|
||||
@@ -54,45 +47,121 @@
|
||||
<entry>string</entry>
|
||||
<entry>Да</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Имя переменной, которая будет выступать в
|
||||
качестве значения текущего елемента</entry>
|
||||
<entry>Имя переменной, которая будет значением текущего елемента</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>key</entry>
|
||||
<entry>string</entry>
|
||||
<entry>Нет</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Имя переменной, которая будет выступать в
|
||||
качестве ключа текущего елемента</entry>
|
||||
<entry>Имя переменной, которая будет ключом текущего елемента</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>name</entry>
|
||||
<entry>string</entry>
|
||||
<entry>Нет</entry>
|
||||
<entry><emphasis>n/a</emphasis></entry>
|
||||
<entry>Название цикла foreach для доступа к его
|
||||
свойствам</entry>
|
||||
<entry>Название цикла foreach для доступа к его свойствам</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</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>
|
||||
<title>{foreach} - предмет</title>
|
||||
<title>Атрибут <parameter>item</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$arr = array( 1001,1002,1003);
|
||||
$smarty->assign('custid', $arr);
|
||||
$arr = array(1000, 1001, 1002);
|
||||
$smarty->assign('myArray', $arr);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Шаблон для отображения <parameter>$myArray</parameter> в виде
|
||||
ненумерованного списка
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{* этот пример напечатает все переменные массива $custid *}
|
||||
{foreach from=$custid item=curr_id}
|
||||
id: {$curr_id}<br />
|
||||
<ul>
|
||||
{foreach from=$myArray item=foo}
|
||||
<li>{$foo}</li>
|
||||
{/foreach}
|
||||
</ul>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
@@ -100,39 +169,115 @@ $smarty->assign('custid', $arr);
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
id: 1000<br />
|
||||
id: 1001<br />
|
||||
id: 1002<br />
|
||||
<ul>
|
||||
<li>1000</li>
|
||||
<li>1001</li>
|
||||
<li>1002</li>
|
||||
</ul>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Пример работы атрибутов <parameter>item</parameter> и <parameter>key</parameter></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$arr = array(9 => 'Tennis', 3 => 'Swimming', 8 => 'Coding');
|
||||
$smarty->assign('myArray', $arr);
|
||||
?>
|
||||
]]>
|
||||
</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} - предмет и ключ</title>
|
||||
<title>{foreach} с ассоциативным атрибутом <parameter>item</parameter></title>
|
||||
<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')
|
||||
));
|
||||
$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>
|
||||
<![CDATA[
|
||||
{foreach name=outer item=contact from=$contacts}
|
||||
<hr />
|
||||
{foreach key=key item=item from=$contact}
|
||||
{$key}: {$item}<br>
|
||||
{$key}: {$item}<br />
|
||||
{/foreach}
|
||||
<hr />
|
||||
{foreach key=key item=item from=$contact}
|
||||
{$key}: {$item}<br />
|
||||
{/foreach}
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
@@ -142,93 +287,178 @@ $smarty->assign('contacts', array(
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<hr />
|
||||
phone: 1<br />
|
||||
fax: 2<br />
|
||||
cell: 3<br />
|
||||
phone: 1<br />
|
||||
fax: 2<br />
|
||||
cell: 3<br />
|
||||
<hr />
|
||||
phone: 555-4444<br />
|
||||
fax: 555-3333<br />
|
||||
cell: 760-1234<br />
|
||||
phone: 555-4444<br />
|
||||
fax: 555-3333<br />
|
||||
cell: 760-1234<br />
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>{foreach} - базы данных (к примеру, PEAR или ADODB)</title>
|
||||
<programlisting role="php">
|
||||
<title>Пример использования {foreachelse} при работе с базой данных</title>
|
||||
<para>
|
||||
Пример работы с базой данных (при помощи PEAR или ADODB) в скрипте поиска,
|
||||
результаты которого передаются в Smarty.
|
||||
</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$sql = 'select contact_id, name, nick from contacts order by contact';
|
||||
$smarty->assign("contacts", $db->getAssoc($sql));
|
||||
$search_condition = "WHERE name LIKE '$foo%' ";
|
||||
$sql = 'SELECT contact_id, name, nick FROM contacts '.$search_condition.' ORDER BY name';
|
||||
$smarty->assign('results', $db->getAssoc($sql) );
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Шаблон отобразит сообщение <quote>Ничего не найдено</quote> при помощи
|
||||
<varname>{foreachelse}</varname> в случае, если поиск не дал результатов.
|
||||
</para>
|
||||
<programlisting>
|
||||
<![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 />
|
||||
{foreachelse}
|
||||
Ничего не найдено
|
||||
{/foreach}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Циклы {foreach} также имеют собственные переменные, которые содержат свойства
|
||||
{foreach}.
|
||||
Они обозначаются так:
|
||||
<link linkend="language.variables.smarty.loops">{$smarty.foreach.foreachname.varname}</link>
|
||||
{$smarty.foreach.foreachname.varname}, где foreachname - это название цикла
|
||||
(значение атрибута <emphasis>name</emphasis>).
|
||||
</para>
|
||||
<sect2 id="foreach.property.index">
|
||||
<title>.index</title>
|
||||
<para>
|
||||
<parameter>index</parameter> contains the current array index, starting with zero.
|
||||
</para>
|
||||
<example>
|
||||
<title><parameter>index</parameter> example</title>
|
||||
|
||||
<para>
|
||||
См. <link linkend="section.property.index">{section}</link>
|
||||
для примеров следующих свойств, так как они идентичны.
|
||||
</para>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
{* The header block is output every five rows *}
|
||||
<table>
|
||||
{foreach from=$items key=myId item=i name=foo}
|
||||
{if $smarty.foreach.foo.index % 5 == 0}
|
||||
<tr><th>Title</th></tr>
|
||||
{/if}
|
||||
<tr><td>{$i.label}</td></tr>
|
||||
{/foreach}
|
||||
</table>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="foreach.property.iteration">
|
||||
<title>iteration</title>
|
||||
<para>
|
||||
iteration используется для отображения текущего номера итерации цикла.
|
||||
Итерации всегда начинаются с 1 и увеличиваются на одну при каждом
|
||||
прохождении цикла.
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2 id="foreach.property.iteration">
|
||||
<title>.iteration</title>
|
||||
<para>
|
||||
<parameter>iteration</parameter> содержит значение текущей итерации цикла
|
||||
и всегда начинается с единицы, в отличие от
|
||||
<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.first">
|
||||
<title>first</title>
|
||||
<para>
|
||||
<emphasis>first</emphasis> устанавливается в true, если текущая итерация первая.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<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 id="foreach.property.total">
|
||||
<title>total</title>
|
||||
<para>
|
||||
<emphasis>total</emphasis> хранит количество итераций цикла.
|
||||
Может быть использовано как в цикле, так и вне его.
|
||||
</para>
|
||||
<sect2 id="foreach.property.first">
|
||||
<title>.first</title>
|
||||
<para>
|
||||
Свойство <parameter>first</parameter> равно &true;, если текущая итерация
|
||||
<varname>{foreach}</varname> - первая.
|
||||
</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>
|
||||
См. также <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>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
Reference in New Issue
Block a user