Просмотр файла manual-ru/language.function.foreach.html

Конкурс дизайнеров на 15000 рублей
Милый пушистый сайт !!!!
Размер файла: 20.46Kb 
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>{foreach},{foreachelse}</title>
  5. <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
  6. <link rel="home" href="index.html" title="Руководство по Smarty">
  7. <link rel="up" href="language.builtin.functions.html" title="Chapter 7. Встроенные функции">
  8. <link rel="prev" href="language.function.config.load.html" title="{config_load}">
  9. <link rel="next" href="language.function.if.html" title="{if},{elseif},{else}">
  10. </head>
  11. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12. <div class="navheader">
  13. <table width="100%" summary="Navigation header">
  14. <tr><th colspan="3" align="center">{foreach},{foreachelse}</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="language.function.config.load.html">Prev</a> </td>
  18. <th width="60%" align="center">Chapter 7. Встроенные функции</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="language.function.if.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="sect1" title="{foreach},{foreachelse}">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="language.function.foreach"></a>{foreach},{foreachelse}</h2></div></div></div>
  28. <p>
  29.   <code class="varname">{foreach}</code> используется для работы как с
  30.   <span class="bold"><strong>ассоциативным</strong></span>,
  31.   так и с числовыми массивами, в отличие от функции
  32.   <a class="link" href="language.function.section.html" title="{section},{sectionelse}"><code class="varname">{section}</code></a>,
  33.   которая предназначена для работы
  34.   <span class="bold"><strong>исключительно с числовыми массивами</strong></span>.
  35.   
  36.   Синтаксис функции <code class="varname">{foreach}</code> намного проще, чем
  37.   <a class="link" href="language.function.section.html" title="{section},{sectionelse}"><code class="varname">{section}</code></a>,
  38.   но она может работать <span class="bold"><strong>только с одним массивом</strong></span>
  39.   одновременно. Каждый тэг <code class="varname">{foreach}</code> должен иметь
  40.   закрывающую пару <code class="varname">{/foreach}</code>.
  41.  </p>
  42. <div class="informaltable"><table border="1">
  43. <colgroup>
  44. <col align="center">
  45. <col align="center">
  46. <col align="center">
  47. <col align="center">
  48. <col>
  49. </colgroup>
  50. <thead><tr>
  51. <th align="center">Имя атрибута</th>
  52. <th align="center">Тип</th>
  53. <th align="center">Обязателен</th>
  54. <th align="center">По умолчанию</th>
  55. <th>Описание</th>
  56. </tr></thead>
  57. <tbody>
  58. <tr>
  59. <td align="center">from</td>
  60. <td align="center">array</td>
  61. <td align="center">Да</td>
  62. <td align="center"><span class="emphasis"><em>n/a</em></span></td>
  63. <td>Массив, по которому надо пройтись</td>
  64. </tr>
  65. <tr>
  66. <td align="center">item</td>
  67. <td align="center">string</td>
  68. <td align="center">Да</td>
  69. <td align="center"><span class="emphasis"><em>n/a</em></span></td>
  70. <td>Имя переменной, которая будет значением текущего елемента</td>
  71. </tr>
  72. <tr>
  73. <td align="center">key</td>
  74. <td align="center">string</td>
  75. <td align="center">Нет</td>
  76. <td align="center"><span class="emphasis"><em>n/a</em></span></td>
  77. <td>Имя переменной, которая будет ключом текущего елемента</td>
  78. </tr>
  79. <tr>
  80. <td align="center">name</td>
  81. <td align="center">string</td>
  82. <td align="center">Нет</td>
  83. <td align="center"><span class="emphasis"><em>n/a</em></span></td>
  84. <td>Название цикла foreach для доступа к его свойствам</td>
  85. </tr>
  86. </tbody>
  87. </table></div>
  88. <div class="itemizedlist"><ul class="itemizedlist" type="disc">
  89. <li class="listitem"><p>
  90.     Атрибуты <em class="parameter"><code>from</code></em> и <em class="parameter"><code>item</code></em>
  91.     являются обязательными.
  92.    </p></li>
  93. <li class="listitem"><p>
  94.     Параметр <em class="parameter"><code>name</code></em> цикла <code class="varname">{foreach}</code>
  95.     может состоять из букв, цифр и знака подчеркивания, как и
  96.    <a class="ulink" href="http://php.net/language.variables" target="_top">переменные PHP</a>.
  97.    </p></li>
  98. <li class="listitem"><p>
  99.     Циклы <code class="varname">{foreach}</code> могут быть вложенными при условии, что
  100.     их имена будут уникальными.
  101.    </p></li>
  102. <li class="listitem"><p>
  103.     Атрибут <em class="parameter"><code>from</code></em>, обычно являющийся массивом,
  104.     определяет количество проходов цикла <code class="varname">{foreach}</code>.
  105.    </p></li>
  106. <li class="listitem"><p>
  107.     Блок <code class="varname">{foreachelse}</code> выполняется в том случае, если 
  108.     в параметре <em class="parameter"><code>from</code></em> нет значений.
  109.    </p></li>
  110. <li class="listitem">
  111. <p>
  112.     У циклов <code class="varname">{foreach}</code> также есть собственные переменные,
  113.     которые обрабатывают свойства.
  114.     Доступ к ним можно получить таким образом:
  115.     <a class="link" href="language.variables.smarty.html#language.variables.smarty.loops" title="{$smarty.section}, {$smarty.foreach}">
  116.     <em class="parameter"><code>{$smarty.foreach.name.property}</code></em></a>, где
  117.     <span class="quote">“<span class="quote">name</span>”</span> - атрибут <em class="parameter"><code>name</code></em> функции
  118.     <code class="varname">{foreach}</code>.
  119.    </p>
  120. <div class="note" title="Обратите внимание" style="margin-left: 0.5in; margin-right: 0.5in;">
  121. <h3 class="title">Обратите внимание</h3>
  122. <p>
  123.      Атрибут <em class="parameter"><code>name</code></em> необходим только в том случае,
  124.      когда у вас есть необходимость обращаться к свойствам
  125.      <code class="varname">{foreach}</code>, в отличие от функции
  126.      <a class="link" href="language.function.section.html" title="{section},{sectionelse}"><code class="varname">{section}</code></a>.
  127.      Обращение к свойствам <code class="varname">{foreach}</code> с неопределенным
  128.      <em class="parameter"><code>name</code></em> не вызывает ошибки, но ведёт к непредсказуемым
  129.      результатам.
  130.     </p>
  131. </div>
  132. </li>
  133. <li class="listitem"><p>
  134.     <code class="varname">{foreach}</code> имеет следующие свойства:
  135.     <a class="link" href="language.function.foreach.html#foreach.property.index" title=".index"><em class="parameter"><code>index</code></em></a>,
  136.     <a class="link" href="language.function.foreach.html#foreach.property.iteration" title=".iteration"><em class="parameter"><code>iteration</code></em></a>,
  137.     <a class="link" href="language.function.foreach.html#foreach.property.first" title=".first"><em class="parameter"><code>first</code></em></a>,
  138.     <a class="link" href="language.function.foreach.html#foreach.property.last" title=".last"><em class="parameter"><code>last</code></em></a>,
  139.     <a class="link" href="language.function.foreach.html#foreach.property.show" title=".show"><em class="parameter"><code>show</code></em></a> и
  140.     <a class="link" href="language.function.foreach.html#foreach.property.total" title=".total"><em class="parameter"><code>total</code></em></a>.
  141.    </p></li>
  142. </ul></div>
  143. <div class="example">
  144. <a name="id2668883"></a><p class="title"><b>Example 7.5. Атрибут <em class="parameter"><code>item</code></em></b></p>
  145. <div class="example-contents">
  146. <pre class="programlisting">
  147.  
  148. &lt;?php
  149. $arr = array(1000, 1001, 1002);
  150. $smarty-&gt;assign('myArray', $arr);
  151. ?&gt;
  152.  
  153.   </pre>
  154. <p>
  155.     Шаблон для отображения <em class="parameter"><code>$myArray</code></em> в виде
  156.     ненумерованного списка
  157.    </p>
  158. <pre class="programlisting">
  159.  
  160. &lt;ul&gt;
  161. {foreach from=$myArray item=foo}
  162.     &lt;li&gt;{$foo}&lt;/li&gt;
  163. {/foreach}
  164. &lt;/ul&gt;
  165.  
  166.   </pre>
  167. <p>
  168.    Результат выполнения данного примера:
  169.   </p>
  170. <pre class="screen">
  171.  
  172. &lt;ul&gt;
  173.     &lt;li&gt;1000&lt;/li&gt;
  174.     &lt;li&gt;1001&lt;/li&gt;
  175.     &lt;li&gt;1002&lt;/li&gt;
  176. &lt;/ul&gt;
  177.  
  178.   </pre>
  179. </div>
  180. </div>
  181. <br class="example-break"><div class="example">
  182. <a name="id2668941"></a><p class="title"><b>Example 7.6. Пример работы атрибутов <em class="parameter"><code>item</code></em> и <em class="parameter"><code>key</code></em></b></p>
  183. <div class="example-contents">
  184. <pre class="programlisting">
  185.  
  186. &lt;?php
  187. $arr = array(9 =&gt; 'Tennis', 3 =&gt; 'Swimming', 8 =&gt; 'Coding');
  188. $smarty-&gt;assign('myArray', $arr);
  189. ?&gt;
  190.  
  191.   </pre>
  192. <p>
  193.     Шаблон для отображения <em class="parameter"><code>$myArray</code></em> в виде пар ключ/значение,
  194.     как <a class="ulink" href="http://php.net/foreach" target="_top"><code class="varname">foreach</code></a>
  195.     в PHP.</p>
  196. <pre class="programlisting">
  197.  
  198. &lt;ul&gt;
  199. {foreach from=$myArray key=k item=v}
  200.    &lt;li&gt;{$k}: {$v}&lt;/li&gt;
  201. {/foreach}
  202. &lt;/ul&gt;
  203.  
  204.   </pre>
  205. <p>
  206.    Результат выполнения данного примера:
  207.   </p>
  208. <pre class="screen">
  209.  
  210. &lt;ul&gt;
  211.     &lt;li&gt;9: Tennis&lt;/li&gt;
  212.     &lt;li&gt;3: Swimming&lt;/li&gt;
  213.     &lt;li&gt;8: Coding&lt;/li&gt;
  214. &lt;/ul&gt;
  215.  
  216.   </pre>
  217. </div>
  218. </div>
  219. <br class="example-break"><div class="example">
  220. <a name="id2669014"></a><p class="title"><b>Example 7.7. {foreach} с ассоциативным атрибутом <em class="parameter"><code>item</code></em></b></p>
  221. <div class="example-contents">
  222. <pre class="programlisting">
  223.  
  224. &lt;?php
  225. $items_list = array(23 =&gt; array('no' =&gt; 2456, 'label' =&gt; 'Salad'),
  226.                     96 =&gt; array('no' =&gt; 4889, 'label' =&gt; 'Cream')
  227.                     );
  228. $smarty-&gt;assign('items', $items_list);
  229. ?&gt;
  230.  
  231.   </pre>
  232. <p>
  233.     Шаблон для отображения элементов <em class="parameter"><code>$items</code></em>, в котором
  234.     <em class="parameter"><code>$myId</code></em> используется в URL'е
  235.    </p>
  236. <pre class="programlisting">
  237.  
  238. &lt;ul&gt;
  239. {foreach from=$items key=myId item=i}
  240.   &lt;li&gt;&lt;a href="item.php?id={$myId}"&gt;{$i.no}: {$i.label}&lt;/li&gt;
  241. {/foreach}
  242. &lt;/ul&gt;
  243.  
  244.   </pre>
  245. <p>
  246.    Результат выполнения данного примера:
  247.   </p>
  248. <pre class="screen">
  249.  
  250. &lt;ul&gt;
  251.   &lt;li&gt;&lt;a href="item.php?id=23"&gt;2456: Salad&lt;/li&gt;
  252.   &lt;li&gt;&lt;a href="item.php?id=96"&gt;4889: Cream&lt;/li&gt;
  253. &lt;/ul&gt;
  254.  
  255.   </pre>
  256. </div>
  257. </div>
  258. <br class="example-break"><div class="example">
  259. <a name="id2669082"></a><p class="title"><b>Example 7.8. {foreach} со вложенными <em class="parameter"><code>item</code></em> и <em class="parameter"><code>key</code></em></b></p>
  260. <div class="example-contents">
  261. <p>В Smarty передан такой массив, ключ которого содержит ключ для каждого перебираемого значения.</p>
  262. <pre class="programlisting">
  263.  
  264. &lt;?php
  265.  $smarty-&gt;assign('contacts', array(
  266.                              array('phone' =&gt; '1',
  267.                                    'fax' =&gt; '2',
  268.                                    'cell' =&gt; '3'),
  269.                              array('phone' =&gt; '555-4444',
  270.                                    'fax' =&gt; '555-3333',
  271.                                    'cell' =&gt; '760-1234')
  272.                              ));
  273. ?&gt;
  274.  
  275.   </pre>
  276. <p>Шаблон для отображения <em class="parameter"><code>$contact</code></em>.</p>
  277. <pre class="programlisting">
  278.  
  279. {foreach name=outer item=contact from=$contacts}
  280.   &lt;hr /&gt;
  281.   {foreach key=key item=item from=$contact}
  282.     {$key}: {$item}&lt;br /&gt;
  283.   {/foreach}
  284. {/foreach}
  285.  
  286.   </pre>
  287. <p>
  288.    Результат выполнения данного примера:
  289.   </p>
  290. <pre class="screen">
  291.  
  292. &lt;hr /&gt;
  293.   phone: 1&lt;br /&gt;
  294.   fax: 2&lt;br /&gt;
  295.   cell: 3&lt;br /&gt;
  296. &lt;hr /&gt;
  297.   phone: 555-4444&lt;br /&gt;
  298.   fax: 555-3333&lt;br /&gt;
  299.   cell: 760-1234&lt;br /&gt;
  300.  
  301.   </pre>
  302. </div>
  303. </div>
  304. <br class="example-break"><div class="example">
  305. <a name="id2669163"></a><p class="title"><b>Example 7.9. Пример использования {foreachelse} при работе с базой данных</b></p>
  306. <div class="example-contents">
  307. <p>
  308.    Пример работы с базой данных (при помощи PEAR или ADODB) в скрипте поиска,
  309.    результаты которого передаются в Smarty.
  310.   </p>
  311. <pre class="programlisting">
  312.  
  313. &lt;?php
  314.   $search_condition = "WHERE name LIKE '$foo%' ";
  315.   $sql = 'SELECT contact_id, name, nick FROM contacts '.$search_condition.' ORDER BY name';
  316.   $smarty-&gt;assign('results', $db-&gt;getAssoc($sql) );
  317. ?&gt;
  318.  
  319.   </pre>
  320. <p>
  321.    Шаблон отобразит сообщение <span class="quote">“<span class="quote">Ничего не найдено</span>”</span> при помощи
  322.    <code class="varname">{foreachelse}</code> в случае, если поиск не дал результатов.
  323.   </p>
  324. <pre class="programlisting">
  325.  
  326. {foreach key=cid item=con from=$results}
  327.     &lt;a href="contact.php?contact_id={$cid}"&gt;{$con.name} - {$con.nick}&lt;/a&gt;&lt;br /&gt;
  328. {foreachelse}
  329.     Ничего не найдено
  330. {/foreach}
  331.  
  332.   </pre>
  333. </div>
  334. </div>
  335. <br class="example-break"><div class="sect2" title=".index">
  336. <div class="titlepage"><div><div><h3 class="title">
  337. <a name="foreach.property.index"></a>.index</h3></div></div></div>
  338. <p>
  339.    <em class="parameter"><code>index</code></em> contains the current array index, starting with zero.
  340.   </p>
  341. <div class="example">
  342. <a name="id2669249"></a><p class="title"><b>Example 7.10. <em class="parameter"><code>index</code></em> example</b></p>
  343. <div class="example-contents"><pre class="programlisting">
  344.  
  345. {* The header block is output every five rows *}
  346. &lt;table&gt;
  347. {foreach from=$items key=myId item=i name=foo}
  348.   {if $smarty.foreach.foo.index % 5 == 0}
  349.      &lt;tr&gt;&lt;th&gt;Title&lt;/th&gt;&lt;/tr&gt;
  350.   {/if}
  351.   &lt;tr&gt;&lt;td&gt;{$i.label}&lt;/td&gt;&lt;/tr&gt;
  352. {/foreach}
  353. &lt;/table&gt;
  354.  
  355.   </pre></div>
  356. </div>
  357. <br class="example-break">
  358. </div>
  359. <div class="sect2" title=".iteration">
  360. <div class="titlepage"><div><div><h3 class="title">
  361. <a name="foreach.property.iteration"></a>.iteration</h3></div></div></div>
  362. <p>
  363.    <em class="parameter"><code>iteration</code></em> содержит значение текущей итерации цикла
  364.    и всегда начинается с единицы, в отличие от
  365.    <a class="link" href="language.function.foreach.html#foreach.property.index" title=".index"><em class="parameter"><code>index</code></em></a>.
  366.    Это значение увеличивается на единицу с каждой следующей итерацией.
  367.   </p>
  368. <div class="example">
  369. <a name="id2669315"></a><p class="title"><b>Example 7.11. Примеры работы с <em class="parameter"><code>iteration</code></em> и <em class="parameter"><code>index</code></em></b></p>
  370. <div class="example-contents"><pre class="programlisting">
  371.  
  372. {* этот шаблон выведет 0|1, 1|2, 2|3, ... и т.д. *}
  373. {foreach from=$myArray item=i name=foo}
  374.     {$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
  375. {/foreach}
  376.  
  377.   </pre></div>
  378. </div>
  379. <br class="example-break">
  380. </div>
  381. <div class="sect2" title=".first">
  382. <div class="titlepage"><div><div><h3 class="title">
  383. <a name="foreach.property.first"></a>.first</h3></div></div></div>
  384. <p>
  385.    Свойство <em class="parameter"><code>first</code></em> равно <code class="constant">TRUE</code>, если текущая итерация
  386.    <code class="varname">{foreach}</code> - первая.
  387.   </p>
  388. <div class="example">
  389. <a name="id2669377"></a><p class="title"><b>Example 7.12. Пример использования свойства <em class="parameter"><code>first</code></em></b></p>
  390. <div class="example-contents"><pre class="programlisting">
  391.  
  392. {* отображаем "НОВОЕ" напротив первого элемента, иначе id *}
  393. &lt;table&gt;
  394. {foreach from=$items key=myId item=i name=foo}
  395. &lt;tr&gt;
  396.   &lt;td&gt;{if $smarty.foreach.foo.first}НОВОЕ{else}{$myId}{/if}&lt;/td&gt;
  397.   &lt;td&gt;{$i.label}&lt;/td&gt;
  398. &lt;/tr&gt;
  399. {/foreach}
  400. &lt;/table&gt;
  401.  
  402.   </pre></div>
  403. </div>
  404. <br class="example-break">
  405. </div>
  406. <div class="sect2" title=".last">
  407. <div class="titlepage"><div><div><h3 class="title">
  408. <a name="foreach.property.last"></a>.last</h3></div></div></div>
  409. <p>
  410.    Свойство <em class="parameter"><code>last</code></em> равно <code class="constant">TRUE</code>, если текущая итерация
  411.    <code class="varname">{foreach}</code> - последняя.
  412.   </p>
  413. <div class="example">
  414. <a name="id2669436"></a><p class="title"><b>Example 7.13. Пример использования свойства <em class="parameter"><code>last</code></em></b></p>
  415. <div class="example-contents"><pre class="programlisting">
  416.  
  417. {* Добавляем горизонтальную полосу (&lt;hr /&gt;) в конце списка *}
  418. {foreach from=$items key=part_id item=prod name=products}
  419.   &lt;a href="#{$part_id}"&gt;{$prod}&lt;/a&gt;{if $smarty.foreach.products.last}&lt;hr /&gt;{else},{/if}
  420. {foreachelse}
  421.   ... content ...
  422. {/foreach}
  423.  
  424.   </pre></div>
  425. </div>
  426. <br class="example-break">
  427. </div>
  428. <div class="sect2" title=".show">
  429. <div class="titlepage"><div><div><h3 class="title">
  430. <a name="foreach.property.show"></a>.show</h3></div></div></div>
  431. <p>
  432.    <em class="parameter"><code>show</code></em> используется как параметр для <code class="varname">{foreach}</code>.
  433.    <em class="parameter"><code>show</code></em> - это булевое значение.
  434.    Если оно равно <code class="constant">FALSE</code>, результат работы <code class="varname">{foreach}</code> не будет отображен.
  435.    Если присутствует директива <code class="varname">{foreachelse}</code>, её содержимое
  436.    будет отображено.
  437.   </p>
  438. </div>
  439. <div class="sect2" title=".total">
  440. <div class="titlepage"><div><div><h3 class="title">
  441. <a name="foreach.property.total"></a>.total</h3></div></div></div>
  442. <p>
  443.    <em class="parameter"><code>total</code></em> содержит общее количество итераций,
  444.    которое пройдет данный цикл <code class="varname">{foreach}</code>.
  445.    Его можно использовать во время или после выполнения <code class="varname">{foreach}</code>.
  446.   </p>
  447. <div class="example">
  448. <a name="id2669551"></a><p class="title"><b>Example 7.14. Пример использования свойства <em class="parameter"><code>total</code></em></b></p>
  449. <div class="example-contents"><pre class="programlisting">
  450.  
  451. {* отображаем количество отображенных строк в конце *}
  452. {foreach from=$items key=part_id item=prod name=foo}
  453. {$prod.name}&lt;hr/&gt;
  454. {if $smarty.foreach.foo.last}
  455.   &lt;div id="total"&gt;{$smarty.foreach.foo.total} предметов&lt;/div&gt;
  456. {/if}
  457. {foreachelse}
  458.  ... что-то другое ...
  459. {/foreach}
  460.  
  461.   </pre></div>
  462. </div>
  463. <br class="example-break"><p>
  464.    См. также
  465.    <a class="link" href="language.function.section.html" title="{section},{sectionelse}"><code class="varname">{section}</code></a>
  466.    и
  467.    <a class="link" href="language.variables.smarty.html#language.variables.smarty.loops" title="{$smarty.section}, {$smarty.foreach}"><em class="parameter"><code>$smarty.foreach</code></em></a>.
  468.   </p>
  469. </div>
  470. </div>
  471. <div class="navfooter">
  472. <hr>
  473. <table width="100%" summary="Navigation footer">
  474. <tr>
  475. <td width="40%" align="left">
  476. <a accesskey="p" href="language.function.config.load.html">Prev</a> </td>
  477. <td width="20%" align="center"><a accesskey="u" href="language.builtin.functions.html">Up</a></td>
  478. <td width="40%" align="right"> <a accesskey="n" href="language.function.if.html">Next</a>
  479. </td>
  480. </tr>
  481. <tr>
  482. <td width="40%" align="left" valign="top">{config_load} </td>
  483. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  484. <td width="40%" align="right" valign="top"> {if},{elseif},{else}</td>
  485. </tr>
  486. </table>
  487. </div>
  488. </body>
  489. </html>