Skip to main content

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}块具有的属性值,分别为:

  1. index: 上边我们介绍的”循环下标”,默认为0
  2. index_prev: 当前下标的前一个值,默认为-1
  3. index_next: 当前下标的下一个值,默认为1
  4. first: 是否为第一下循环
  5. last: 是否为最后一个循环
  6. iteration: 循环次数
  7. rownum: 当前的行号,iteration的另一个别名
  8. loop: 最后一个循环号,可用在section块后统计section的循环次数
  9. total: 循环次数,可用在section块后统计循环次数
  10. 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}    //总数