PHP模板引擎Smarty內建函數section,sectionelse用法及實例詳解-php教程-PHP中文網

PHP模板引擎Smarty內建函數section,sectionelse用法及實例詳解

墨辰丷

發布： 2023-03-29 15:42:01

原創

1223 人瀏覽過

這篇文章主要介紹了PHP模板引擎Smarty內建函數section,sectionelse用法,結合實例形式詳細分析了section,sectionelse進行循環處理的技巧與使用方法,需要的朋友可以參考下

section 是Smarty 模板中除了foreach 以外的另一種處理循環的方案，section 比foreach 要靈活，就像是一個改進的foreach 語句，除了擁有相同的循環特性外，還提供了很多附加選項，可以更好的控制循環的執行。在範本中，必須使用成對的section 標記，有兩個必須設定的屬性name 和loop ，關於section 的屬性請看下表：

##屬性類型是否必須缺省值描述namestringYes該迴圈的名稱loop[$variable_name]Yesstart##0stepintegerNo 1#maxintegerNo1showbooleanNotrue

我們透過一個實例，來示範 Smarty 中 {section} 和 {sectionelse} 的使用。

實例思路：從資料庫中取出內容，賦給一個數組變數 $_html ，再給這個數組變數分配給模板，然後在模板中進行該數組的遍歷。

資料庫、主檔案index.php，Smarty 範本初始化檔案init.inc.php，可參考前面一篇《PHP模板引擎Smarty內建函數foreach,foreachelse用法分析》

#/ tpl/index.tpl

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>section,sectionelse</title>
</head>
<body>
 <table align="center" border="1" width="800">
  <tr>
   <th>编号(iteration)</th>
   <th>编号(rownum)</th>
   <th>姓名</th>
   <th>电子邮件</th>
   <th>添加时间</th>
  </tr>
  <{section loop=$data name="ls" max="100" start="0" step="2" }> <!-- 使用 section 遍历数组 $data，max 表示最多可以循环多少条，start 表示从哪个数组下标开始显示，step决定了循环的步长，如果设置为2，那么将遍历下标为0,2,4……的元素 -->
  <!-- 在此，我们做几个保留变量 $smarty.section 的操作 -->
    <!-- 当数据显示第一条的时候，第一行的表格背景为黄色，使用属性：first -->
    <!-- 当数据显示最后一条的时候，最后一行的表格背景为蓝色,使用属性：last -->
  <{if $smarty.section.ls.first}>
  <tr align="center" bgcolor="#FFFF00">
  <{elseif $smarty.section.ls.last}>
  <tr align="center" bgcolor="#0000FF">
  <{else}>
  <tr align="center">
  <{/if}>
   <td><{$smarty.section.ls.iteration}></td> <!-- iteration 是保留变量中显示行号的属性 -->
   <td><{$smarty.section.ls.rownum}></td> <!-- rownum 是保留变量中显示行号的属性 -->
   <td><{$data[ls].username}></td> <!-- 输出数组第二维下标为 username 的元素值 -->
   <td><{$data[ls].email}></td> <!-- 输出数组第二维下标为 email 的元素值 -->
   <td><{$data[ls].addTime}></td> <!-- 输出数组第二维下标为 addTime 的元素值 -->
  </tr>
  <{sectionelse}> <!-- 如果分配过来的数组没有内容的话，显示下面内容 -->
  <tr>
   <td colspan="5">对不起！暂时没有数据。</td>
  </tr>
  <{/section}>
  <{if $data}> <!-- 如果循环的次数不为空的话，那么使用 Smarty 的保留变量 {$smarty.section} 显示出循环的次数 -->
  <tr>
   <td align="center" colspan="5">循环的次数为：<{$smarty.section.ls.total}></td>
  </tr>
  <{/if}>
 </table>
</body>
</html>

登入後複製

執行結果：

#section 循環區域中可以使用的變數


		n/a
		#n/a##決定循環次數的變數名稱
integer	#No	循環執行的初始位置. 如果該值為負數，開始位置從數組的尾部算起. 例如：如果數組中有7個元素，指定start為-2，那麼指向當前數組的索引為5. 非法值(超過了循環數組的下限)將被自動調整為最接近的合法值.
		該值決定循環的步長. 例如指定step=2只會遍歷下標示為0、2、4等的元素. 如果step為負值，那麼遍歷數組的時候從後向前遍歷.
		設定循環最大執行次數.
		#決定是否顯示該循環.

##index_next用於顯示下一個循環索引值，循環執行到最後一次時，此值仍然比當前索引值大1（如果指定了step 屬性，那麼由該值決定）iteration用於顯示迴圈的次數first目前section 迴圈在第一次執行時該變數的值為truelast目前section 迴圈在最後執行時該變數的值為truerownum用於顯示循環的次數，該屬性是iteration 的別名，兩者相同#loop用於顯示該循環上一次循環時的索引值，該值可以用於循環內部或循環結束後show#是section 的參數，show 取值為布林值true 和false,如果設定為false，該循環將不顯示。如果指定了 sectionelse 子句，則該子句是否顯示也取決於該值total用於顯示循環執行的次數。不僅可以在迴圈中，也可以在執行結束後呼叫此屬性

變數名稱	描述
index	用於顯示目前循環的索引，從0 開始（如果設定了start 屬性，那麼就由該值開始），每次加1，（如果指定了step 屬性，那麼由該值決定）
index_prev	用於顯示上一個循環索引值，當迴圈開始時，此值為-1