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  which is for looping over numerically-indexed arrays only. The syntax for {foreach} is much easier than , 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 .

• {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:  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 . Accessing a {foreach} property with nameundefined does not throw an error, but leads to unpredictable results instead.
•   注意：name属性仅在需要访问{foreach}属性时有效，与{section}不同。访问未定义name的{foreach}属性不会抛出一个错误，但将导致不可预知的结果。

• {foreach} properties are , , , , , .

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

             
              {foreach from=$myArray item=foo}    
              
{$foo}
{/foreach}
             

             
    
              
1000
    
              
1001
    
              
1002
             

             
              {foreach from=$myArray key=k item=v}   
              
{$k}: {$v}
{/foreach}
             

             
    
              
9: Tennis
    
              
3: Swimming
    
              
8: Coding
             

             
              {foreach from=$items key=myId item=i}  
              
{$i.no}: {$i.label}
              {/foreach}
             

             
  
              
2456: Salad
                
              
4889: Cream
             

{foreach name=outer item=contact from=$contacts}  
             
  {foreach key=key item=item from=$contact}    {$key}: {$item}
  {/foreach}{/foreach}

             
  phone: 1
  fax: 2
  cell: 3
             
  phone: 555-4444
  fax: 555-3333
  cell: 760-1234

{foreach key=cid item=con from=$results}    {$con.name} - {$con.nick}
{foreachelse}    No items were found in the search{/foreach}