section,sectionelse

Table of Contents目錄

Attribute Name	Type	Required	Default	描述
name	string	Yes	n/a	The name of the section
loop	[$variable_name]	Yes	n/a	The name of the variable to determine # of loop iterations
start	integer	No	0	The index position that the section will begin looping. If the value is negative, the start position is calculated from the end of the array. For example, if there are seven values in the loop array and start is -2, the start index is 5. Invalid values (values outside of the length of the loop array) are automatically truncated to the closest valid value.
step	integer	No	1	The step value that will be used to traverse the loop array. For example, step=2 will loop on index 0,2,4, etc. If step is negative, it will step through the array backwards.
max	integer	No	1	Sets the maximum number of times the section will loop.
show	boolean	No	true	determines whether or not to show this section

屬性	型別	是否必須	預設值	描述
name	string	Yes	n/a	該迴圈的名稱
loop	[$variable_name]	Yes	n/a	決定迴圈次數的變數名稱
start	integer	No	0	迴圈執行的初始位置. 如果該值為負數，開始位置從陣列的尾部算起. 例如：如果陣列中有7個元素，指定start為-2，那麼指向當前陣列的索引為5. 非法值(超過了迴圈陣列的下限)將被自動調整為最接近的合法值.
step	integer	No	1	該值決定回圈的步長. 例如指定step=2將只遍歷下標為0、2、4等的元素. 如果step為負值，那麼遍歷陣列的時候從後向前遍歷.
max	integer	No	1	設定迴圈最大執行次數.
show	boolean	No	true	決定是否顯示該迴圈.

模板的 section 用於遍歷陣列中的資料. section 標籤必須成對出現. 必須設定 name 和 loop 屬性. 名稱可以是包含字母、數位和下劃線的任意組合. 可以巢狀但必須保證巢狀的 name 唯一. 變數 loop (通常是陣列)決定迴圈執行的次數. 當需要在 section 迴圈內輸出變數時，必須在變數後加上中括號包含著的 name 變數. sectionelse 當 loop 變數無值時被執行.

Example 7-15. section
例 7-15. section 函式演示

{* this example will print out all the values of the $custid array *}
{section name=customer loop=$custid}
	id: {$custid[customer]}<br>
{/section}

OUTPUT:

id: 1000<br>
id: 1001<br>
id: 1002<br>

例 7-16.loop 變數演示

{* the loop variable only determines the number of times to loop.
 you can access any variable from the template within the section.
 This example assumes that $custid, $name and $address are all
 arrays containing the same number of values *}
{section name=customer loop=$custid}
	id: {$custid[customer]}<br>
	name: {$name[customer]}<br>
	address: {$address[customer]}<br>
	<p>
{/section}


OUTPUT:

id: 1000<br>
name: John Smith<br>
address: 253 N 45th<br>
<p>
id: 1001<br>
name: Jack Jones<br>
address: 417 Mulberry ln<br>
<p>
id: 1002<br>
name: Jane Munson<br>
address: 5605 apple st<br>
<p>

例 7-17. section 名稱演示

{* the name of the section can be anything you like,
 and it is used to reference the data within the section *}
{section name=mydata loop=$custid}
	id: {$custid[mydata]}<br>
	name: {$name[mydata]}<br>
	address: {$address[mydata]}<br>
	<p>
{/section}

例 7-18. 巢狀 section 演示

{* sections can be nested as deep as you like. With nested sections,
 you can access complex data structures, such as multi-dimensional
 arrays. In this example, $contact_type[customer] is an array of
 contact types for the current customer. *}
{section name=customer loop=$custid}
	id: {$custid[customer]}<br>
	name: {$name[customer]}<br>
	address: {$address[customer]}<br>
	{section name=contact loop=$contact_type[customer]}
		{$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br>
	{/section}
	<p>
{/section}


OUTPUT:

id: 1000<br>
name: John Smith<br>
address: 253 N 45th<br>
home phone: 555-555-5555<br>
cell phone: 555-555-5555<br>
e-mail: [email protected]<br>
<p>
id: 1001<br>
name: Jack Jones<br>
address: 417 Mulberry ln<br>
home phone: 555-555-5555<br>
cell phone: 555-555-5555<br>
e-mail: [email protected]<br>
<p>
id: 1002<br>
name: Jane Munson<br>
address: 5605 apple st<br>
home phone: 555-555-5555<br>
cell phone: 555-555-5555<br>
e-mail: [email protected]<br>
<p>

例 7-19. section 遍歷多維陣列演示

{* This is an example of printing an associative array
 of data within a section *}
{section name=customer loop=$contacts}
	name: {$contacts[customer].name}<br>
	home: {$contacts[customer].home}<br>
	cell: {$contacts[customer].cell}<br>
	e-mail: {$contacts[customer].email}<p>
{/section}


OUTPUT:

name: John Smith<br>
home: 555-555-5555<br>
cell: 555-555-5555<br>
e-mail: [email protected]<p>
name: Jack Jones<br>
home phone: 555-555-5555<br>
cell phone: 555-555-5555<br>
e-mail: [email protected]<p>
name: Jane Munson<br>
home phone: 555-555-5555<br>
cell phone: 555-555-5555<br>
e-mail: [email protected]<p>

例 7-20. sectionelse 演示

{* sectionelse will execute if there are no $custid values *}
{section name=customer loop=$custid}
	id: {$custid[customer]}<br>
{sectionelse}
	there are no values in $custid.
{/section}

Section 迴圈也有可供呼叫的變數名. 通過如下方式呼叫{$smarty.section.sectionname.varname}.

注意：Smarty 1.5.0 版中，section 名稱屬性變數的格式由{%sectionname.varname%}變成 {$smarty.section.sectionname.varname}，老版本的格式依然支援，但在手冊的例子中只提供新的格式.

Smarty section,sectionelse

section,sectionelse