Smarty - Manua手册 - Chapter 7. Built-in Functions第7章 内建函数 - {foreach},{foreachelse}用于像访问序数数组一样访问关联数组

{foreach},{foreachelse}

{foreach} is used to loop over an associative array as well a numerically-indexed array, unlike {section} which is for looping over numerically-indexed arrays only. The syntax for {foreach} is much easier than {section}, but as a tradeoff it can only be used for a single array. Every {foreach} tag must be paired with a closing {/foreach} tag.

{foreach} 用于像循环访问一个数字索引数组一样循环访问一个关联数组，与仅能访问数字索引数组的{section}不同，{foreach}的语法比 {section}的语法简单得多，但是作为一个折衷方案也仅能用于单个数组。每个{foreach}标记必须与关闭标记{/foreach}成对出现。

• Required attributes are from and item.

• from和item是必要属性
  

• The name of the {foreach} loop can be anything you like, made up of letters, numbers and underscores, like PHP variables.

• {foreach}循环的name可以是任何字母，数组，下划线的组合，参考PHP变量。
  

• {foreach} loops can be nested, and the nested {foreach} names must be unique from each other.

• {foreach}循环可以嵌套，嵌套的{foreach}的名称应当互不相同。
  

• The from attribute, usually an array of values, determines the number of times {foreach} will loop.

• from属性通常是值数组，被用于判断{foreach}的循环次数。
  

• {foreachelse} is executed when there are no values in the from variable.

• 在from变量中没有值时，将执行{foreachelse}。
  

• {foreach} loops also have their own variables that handle properties. These are accessed with: {$smarty.foreach.name.property} with "name" being the name attribute.

• {foreach}循环也有自身属性的变量，可以通过{$smarty.foreach.name.property}访问，其中"name"是name属性。
  

  Note: The name attribute is only required when you want to access a {foreach} property, unlike {section}. Accessing a {foreach} property with name undefined does not throw an error, but leads to unpredictable results instead.

•   注意：name属性仅在需要访问{foreach}属性时有效，与{section}不同。访问未定义name的{foreach}属性不会抛出一个错误，但将导致不可预知的结果。
  

• {foreach} properties are index, iteration, first, last, show, total.

• {foreach}属性有index, iteration, first, last, show, total.
  

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

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

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

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

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

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

.total

total contains the number of iterations that this {foreach} will loop. This can be used inside or after the {foreach}.

total包括{foreach}将循环的次数，既可以在{foreach}中使用，也可以在之后使用。

See also {section} and $smarty.foreach.