smarty --foreach详解[转载]
时间:2010-06-06 来源:hkebao
第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}成对出现。
Attribute Name属性名称 | Type类型 | Required必要 | Default默认值 | Description描述 |
---|---|---|---|---|
from | array数组 | Yes必要 | n/a |
The array you are looping through 循环访问的数组 |
item | string字符串 | Yes必要 | n/a |
The name of the variable that is the current element 当前元素的变量名 |
key | string字符串 | No可选 | n/a |
The name of the variable that is the current key 当前键名的变量名 |
name | string字符 | No可选 | n/a |
The name of the foreach loop for accessing foreach properties 用于访问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.
Example 7-5. The item attribute
例 7-5. item属性
Template to output $myArray in an un-ordered list
用模板以无序列表输出$myArray
The above example will output:
上例将输出:
|
Example 7-6. Demonstrates the item and key attributes
例 7-6. 演示item和key属性
Template to output $myArray as key/val pair, like PHP's foreach.
用模板按键名/键值对的形式输出$myArray, 类似于PHP的foreach。
The above example will output:
上例将输出:
|
Example 7-7. {foreach} with associative item attribute
例 7-7. {foreach}的item属性是关联数组
Template to output $items with $myId in the url
模板中,url通过$myId输出$items
The above example will output:
上例将输出:
|
Example 7-8. {foreach} with nested item and key
例 7-8. {foreach}使用嵌套的item和key Assign an array to Smarty, the key contains the key for each looped value.
向Smarty设置一个数组,对于每个键名对应的每个循环值都包括键。
The template to output $contact.
用于输出$contact的模板。
The above example will output:
上例将输出:
|
Example 7-9. Database example with {foreachelse}
例 7-9. 使用{foreachelse}的数据库示例 A database (eg PEAR or ADODB) example of a search script, the query results assigned to Smarty
一个数据库(例如PEAR或ADODB)的搜索脚本示例,
The template which display "None found" if no results with {foreachelse}.
借助{foreachelse}标记在没有结果时模板输出"None found"字样。
|
.index
index contains the current array index, starting with zero.
.index包含当前数组索引,从零开始。
Example 7-10. index example
例 7-10. index示例
|
.iteration
iteration contains the current loop iteration and always starts at one, unlike index. It is incremented by one on each iteration.
iteration包含当前循环次数,与index不同,从1开始,每次循环增长1。
Example 7-11. iteration and index example
例 7-11. iteration和index示例
|
.first
first is TRUE if the current {foreach} iteration is the initial one.
first在当前{foreach}循环处于初始位置时值为TRUE。
Example 7-12. first property example
例 7-12. first属性示例
|
.last
last is set to TRUE if the current {foreach} iteration is the final one.
last在当前{foreach}循环处于最终位置是值为TRUE。
Example 7-13. last property example
例 7-13. last属性示例
|
.show
show is used as a parameter to {foreach}. show is a boolean value. If FALSE, the {foreach} will not be displayed. If there is a {foreachelse} present, that will be alternately displayed.
show是{foreach}的参数. show是一个布尔值。如果值为FALSE,{foreach}将不被显示。如果有对应的{foreachelse},将被显示。
.total
total contains the number of iterations that this {foreach} will loop. This can be used inside or after the {foreach}.
total包括{foreach}将循环的次数,既可以在{foreach}中使用,也可以在之后使用。
Example 7-14. total property example
例 7-14. total属性示例
|