smarty中section和foreach的属性
section的属性
section的产生是为解决foreach的不足的,与foreach一样,它用于设计模板内的循环块,它较为复杂,可极大程序上满足程序需要,所以在程序中习惯使用它而不使用foreach,基本原因为:
{section name = name loop = $varName[, start = $start, step = $step, max = $max, show = true]}
name: section的名称,不用加$
$loop: 要循环的变量,在程序中要使用assign对这个变量进行操作。
$start: 开始循环的下标,循环下标默认由0开始
$step: 每次循环时下标的增数
$max: 最大循环下标
$show: boolean类型,决定是否对这个块进行显示,默认为true
这里有个名词需要说明:
循环下标:实际它的英文名称为index,是索引的意思,这里我将它译成”下标”,主要是为了好理解。它表示在显示这个循环块时当前的循环索引,默认从 0开始,受$start的影响,如果将$start设为5,它也将从5开始计数,在模板设计部分我们使用过它,这是当前 {section}的一个属性,调用方式为Smarty.section.sectionName.index,这里的sectionName指的是函数 原型中的name属性。 {section}块具有的属性值,分别为:
- index: 上边我们介绍的”循环下标”,默认为0
- index_prev: 当前下标的前一个值,默认为-1
- index_next: 当前下标的下一个值,默认为1
- first: 是否为第一下循环
- last: 是否为最后一个循环
- iteration: 循环次数
- rownum: 当前的行号,iteration的另一个别名
- loop: 最后一个循环号,可用在section块后统计section的循环次数
- total: 循环次数,可用在section块后统计循环次数
- show: 在函数的声明中有它,用于判断section是否显示
foreach的属性
{foreach} 用于像循环访问一个数字索引数组一样循环访问一个关联数组,与仅能访问数字索引数组的{section}不同,{foreach}的语法比 {section}的语法简单得多,但是作为一个折衷方案也仅能用于单个数组。每个{foreach}标记必须与关闭标记{/foreach}成对出现。
属性
1、from 类型:array数组 必要性:Yes必要 默认值:n/a 描述:循环访问的数组
2、item 类型:string字符串 必要性:Yes必要 默认值:n/a 描述:当前元素的变量名
3、key 类型:string字符串 必要性:No可选 默认值:n/a 描述:当前键名的变量名
4、name 类型:string字符串 必要性:No可选 默认值:n/a 描述:用于访问foreach属性的foreach循环的名称
from和item是必要属性
- {foreach}循环的name可以是任何字母,数组,下划线的组合,参考PHP变量。
- {foreach}循环可以嵌套,嵌套的{foreach}的名称应当互不相同。
- from属性通常是值数组,被用于判断{foreach}的循环次数。
- 在from变量中没有值时,将执行{foreachelse}。
{foreach}循环也有自身属性的变量,可以通过{$smarty.foreach.name.property}访问,其中”name”是name属性。注意:name属性仅在需要访问{foreach}属性时有效,与{section}不同。访问未定义name的{foreach}属性不会抛出一个错误,但将导致不可预知的结果。
{foreach}属性有index, iteration, first, last, show, total.
{$smarty.foreach.name.index} //下标
{$smarty.foreach.name.iteration} //下标+1
{$smarty.foreach.name.total} //总数