Smarty手册
上一篇	第七章内建函数	下一篇

{foreach},{foreachelse}

{foreach}用来遍历一个单一关联数组，不象{section}那样是遍历数据数组。{foreach}的语法要比{section}简单的多，但是其缺点是只能用于单一关联数组。每个{foreach}标记必需用{/foreach}标记闭合。

属性名	类型	必需？	缺省	描述
from	array	Yes	n/a	要遍历的数组
item	string	Yes	n/a	当前元素的变量名
key	string	No	n/a	当前键值的变量名
name	string	No	n/a	当前foreach循环的名，用来访问foreach属性

必需参数为from和item。
{foreach}循环的name可以是任意值，由字母、数字、下划线构成，就像PHP变量一样。
{foreach}循环可以嵌套，而各嵌套的{foreach}名称必须相互唯一。
from属性通常是一个值的数组，确定了{foreach}循环的次数。
{foreachelse}在from变量中没有值时执行。
{foreach}循环有自己的变量来处理属性。可以这样来存取：{$smarty.foreach.name.property}，其中"name"就是name 属性的值。
注意：name属性只有在你需要存取{foreach}属性时才是必要的，这和{section}不同。存取的{foreach}属性，如果其name未定义，不会抛出异常，但是结果是不可预料的。
{foreach}属性为index，iteration，first，last，show，total。

例子 7-5. item属性


<?php
$arr = array(1000, 1001, 1002);
$smarty->assign('myArray', $arr);
?>

将$myArray作为未排序列表输出的模板：

<ul>
{foreach from=$myArray item=foo}
    <li>{$foo}</li>
{/foreach}
</ul>

上例将输出：

<ul>
    <li>1000</li>
    <li>1001</li>
    <li>1002</li>
</ul>

例子7-6. 演示item和key属性


<?php
$arr = array(9 => 'Tennis', 3 => 'Swimming', 8 => 'Coding');
$smarty->assign('myArray', $arr);
?>

输出$myArray为键/值对的模板，如同PHP的foreach。

<ul>
{foreach from=$myArray key=k item=v}
   <li>{$k}: {$v}</li>
{/foreach}
</ul>

上例将输出：

<ul>
    <li>9: Tennis</li>
    <li>3: Swimming</li>
    <li>8: Coding</li>
</ul>

例子7-7. {foreach}带有关联的item属性


<?php
$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
                    96 => array('no' => 4889, 'label' => 'Cream')
                    );
$smarty->assign('items', $items_list);
?>

输出$items（带有$myId ）到URI的模板：

<ul>
{foreach from=$items key=myId item=i}
  <li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
{/foreach}
</ul>

上例的输出为：

<ul>
  <li><a href="item.php?id=23">2456: Salad</li>
  <li><a href="item.php?id=96">4889: Cream</li>
</ul>

例子7-8. {foreach}带有嵌套的item和key

复制一个数组给Smarty，其键值包含每个循环值的键：


<?php
 $smarty->assign('contacts', array(
                             array('phone' => '1',
                                   'fax' => '2',
                                   'cell' => '3'),
                             array('phone' => '555-4444',
                                   'fax' => '555-3333',
                                   'cell' => '760-1234')
                             ));
?>

输出$contact的模板：

{foreach name=outer item=contact from=$contacts}
  <hr />
  {foreach key=key item=item from=$contact}
    {$key}: {$item}<br />
  {/foreach}
{/foreach}

上例将输出：

<hr />
  phone: 1<br />
  fax: 2<br />
  cell: 3<br />
<hr />
  phone: 555-4444<br />
  fax: 555-3333<br />
  cell: 760-1234<br />

例子7-9. 使用{foreachelse}的数据库例子

一个数据库（PEAR或ADODB）的搜索脚本的例子，查询结果赋值给Smarty：


<?php
  $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) );
?>

如果没有找到结果，那么模板将通过{foreachelse}输出"None found"：

{foreach key=cid item=con from=$results}
    <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
{foreachelse}
    No items were found in the search
{/foreach}

.index

index包含了当前数组的索引，从0开始。

例子7-10. index例子


{* 标题块每五行输出一次*}

<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>

.iteration

iteration包含当前的循环次数，总是从1开始，这是和index不同的地方。每次遍历都递增1。

例子7-11. iteration和index


{* 将输出0|1, 1|2, 2|3, ... etc *}

{foreach from=$myArray item=i name=foo}
{$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
{/foreach}

.first

first为TRUE，如果当前的{foreach}遍历是第一个。

例子7-12. first属性


{* 第一个项目显示LATEST，其它只是显示ID *}

<table>
{foreach from=$items key=myId item=i name=foo}
<tr>
  <td>{if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if}</td>
  <td>{$i.label}</td>
</tr>
{/foreach}
</table>

.last

last为TRUE，如果当前的{foreach}遍历是最后一个。

例子7-13. last属性


{* 在列表的最后加水平分割 *}

{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}

.show

show是{foreach}的一个参数。show是个布尔值。如果为FALSE，{foreach}将不会显示。而如果这时有{foreachelse}的存在，将改而显示它的内容。

.total

total包含了该{foreach}可以循环的次数。可以用在{foreach}之内或之外。

例子 7-14. total属性


{* 在最后显示返回的行数 *}

{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} items</div>
{/if}
{foreachelse}
 ... something else ...
{/foreach}

参见{section}和$smarty.foreach。

上一篇	主页	下一篇
{config_load}	返回	{if},{elseif},{else}