ECSHOP模版系統(tǒng)中顯示標簽主要是轉(zhuǎn)換HTML代碼，該特性使得在表格中交替輸出顏色或輪轉(zhuǎn)使用數(shù)組中的值變得很容易，或者是根據(jù)給定的數(shù)據(jù)創(chuàng)建選項組，創(chuàng)建日期下拉菜單，它可以顯示任意年月日。亦或者是根據(jù)給定的數(shù)據(jù)創(chuàng)建單選按鈕組等，本文就給大家講解一下ECSHOP模版系統(tǒng)的顯示標簽。

cycle

屬性	類型	是否必須	缺省值	描述
name	string	No	default	輪轉(zhuǎn)的名稱
values	mixed		N/A	待輪轉(zhuǎn)的值，可以是用逗號分隔的列表(請查看 delimiter 屬性)或一個包含多值的數(shù)組.
print	boolean	No	true	是否輸出值
advance	boolean	No	true	是否使用下一個值(為 false 時使用當前值)
delimiter	string	No	，	指出values 屬性中使用的分隔符，默認是逗號.
assign	string	No	N/A	輸出值將被賦給模板變量的名稱

描述：

Cycle 用于輪轉(zhuǎn)使用一組值. 該特性使得在表格中交替輸出顏色或輪轉(zhuǎn)使用數(shù)組中的值變得很容易。

如果需要在模板中使用多個輪轉(zhuǎn)，需要給出唯一的 name 屬性.

用戶可以設置 print 屬性為 false 強制不輸出當前值. 該特性可以很方便地略過某個值.

advance 屬性用于重復使用某個值. 當該屬性設置為 false 時，下次調(diào)用該輪轉(zhuǎn)時將輸出同樣的值.

如果指定了 “assign” 這個特殊屬性，該輪轉(zhuǎn)的輸出值將被賦給由 assign 指定的模板變量，而不是直接輸出。

例子：

{section name=rows loop=$data}<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"><td>{$data[rows]}</td></tr>{/section}

輸出：

<tr bgcolor="#eeeeee"><td>1</td></tr><tr bgcolor="#d0d0d0"><td>2</td></tr><tr bgcolor="#eeeeee"><td>3</td></tr>

html_options

屬性	類型	是否必須	缺省值	描述
values	array	Yes, unless using options attribute	N/A	包含下拉列表各元素值的數(shù)組
output	array	Yes, unless using options attribute	N/A	包含下拉列表各元素顯示值的數(shù)組
selected	string/array	No	empty	已選定的元素或元素數(shù)組
options	associative array	Yes, unless using values and output	N/A	包含值和顯示的關聯(lián)數(shù)組
name	string	No	empty	下拉菜單的名稱

描述：

自定義函數(shù) html_options 根據(jù)給定的數(shù)據(jù)創(chuàng)建選項組. 該函數(shù)可以指定哪些元素被選定. 要么必須指定 values 和 ouput 屬性，要么指定 options 替代。

如果給定值是數(shù)組，將作為 OPTGROUP 處理，且支持遞歸. 所有的輸出與 XHTML 兼容。

如果指定了可選屬性 name，該選項列表將將被置于<select name=”groupname”></select>標簽對中. 如果沒有指定，那么只產(chǎn)生選項列表。

上表未提到的其它參數(shù)在 <select> 標簽中以”名稱/屬性”對的方式顯示. 如果沒有指定可選屬性 name 這些參數(shù)將被忽略。

例子：

index.php:

require('Smarty.class.php');$smarty = new Smarty;$smarty->assign('cust_ids', array(1000,1001,1002,1003));$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','JaneJohnson','Carlie Brown'));$smarty->assign('customer_id', 1001);$smarty->display('index.tpl');index.tpl:<select name=customer_id>{html_options values=$cust_ids selected=$customer_id output=$cust_names}</select>

index.php:

require('Smarty.class.php');$smarty = new Smarty;$smarty->assign('cust_options', array(1001 => 'Joe Schmoe',1002 => 'Jack Smith',1003 => 'Jane Johnson',1004 => 'Charlie Brown'));$smarty->assign('customer_id', 1001);$smarty->display('index.tpl');

index.tpl:

<select name=customer_id>{html_options options=$cust_options selected=$customer_id}</select>

輸出：

<select name=customer_id><option value="1000">Joe Schmoe</option><option value="1001" selected="selected">Jack Smith</option><option value="1002">Jane Johnson</option><option value="1003">Charlie Brown</option></select>

html_select_date

屬性	類型	是否必須	缺省值	描述
prefix	string	No	Date_	變量名稱前綴
time	timestamp/YYYY-MMDD	No	UNIX時間戳或年-月-日	使用時間類型(data/time)
start_year	string	No	年份或與當前年份的相對值	下拉列表中第一個年份，或與當前年份的相對值(正/負幾年)
end_year	string	No	同start_year	下拉列表中最后一個年份，或與當前年份的相對值(正/負幾年)
display_days	boolean	No	true	是否顯示天
display_months	boolean	No	true	是否顯示月
display_years	boolean	No	true	是否顯示年
month_format	string	No	%B	月份的表示方法(strftime)
day_format	string	No	%02d	天顯示的格式(sprintf)
day_value_format	string	No	%d	天的表示方法(sprintf)
year_as_text	boolean	No	false	是否以文本方式顯示年份
reverse_years	boolean	No	false	逆序顯示年份
field_array	string	No	null	如果指定了名稱，選定的區(qū)域?qū)⒁訹Day],[Year],[Month]的形式返回給PHP(待考)
day_size	string	No	null	如果給定，為標簽添加大小屬性
month_size	string	No	null	如果給定，為標簽添加大小屬性
year_size	string	No	null	如果給定，為標簽添加大小屬性
all_extra	string	No	null	如果給定，為所有標簽添加附加屬性
day_extra	string	No	null	如果給定，為標簽添加附加屬性
month_extra	string	No	null	如果給定，為標簽添加附加屬性
year_extra	string	No	null	如果給定，為標簽添加附加屬性
field_order	string	No	MDY	顯示區(qū)域的順序
field_separator	string	No	\n	各區(qū)域間輸出的分隔字符串
month_value_format	string	No	%m	月份值的strftime表示方法，默認為%m

描述：

自定義函數(shù) html_select_date 用于創(chuàng)建日期下拉菜單. 它可以顯示任意年月日.

例子：

{html_select_date}

輸出：

<select name="Date_Month"><option value="1">January</option><option value="2">February</option><option value="3">March</option><option value="4">April</option><option value="5">May</option><option value="6">June</option><option value="7">July</option><option value="8">August</option><option value="9">September</option><option value="10">October</option><option value="11">November</option><option value="12" selected>December</option></select><select name="Date_Day"><option value="1">01</option><option value="2">02</option><option value="3">03</option><option value="4">04</option><option value="5">05</option><option value="6">06</option><option value="7">07</option><option value="8">08</option><option value="9">09</option><option value="10">10</option><option value="11">11</option><option value="12">12</option><option value="13" selected>13</option><option value="14">14</option><option value="15">15</option><option value="16">16</option><option value="17">17</option><option value="18">18</option><option value="19">19</option><option value="20">20</option><option value="21">21</option><option value="22">22</option><option value="23">23</option><option value="24">24</option><option value="25">25</option><option value="26">26</option><option value="27">27</option><option value="28">28</option><option value="29">29</option><option value="30">30</option><option value="31">31</option></select><select name="Date_Year"><option value="2001" selected>2001</option></select>

例子：

{* start and end year can be relative to current year *}{html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1"display_days=false}

輸出：

<select name="StartDateMonth"><option value="1">January</option><option value="2">February</option><option value="3">March</option><option value="4">April</option><option value="5">May</option><option value="6">June</option><option value="7">July</option><option value="8">August</option><option value="9">September</option><option value="10">October</option><option value="11">November</option><option value="12" selected>December</option></select><select name="StartDateYear"><option value="1999">1995</option><option value="1999">1996</option><option value="1999">1997</option><option value="1999">1998</option><option value="1999">1999</option><option value="2000" selected>2000</option><option value="2001">2001</option></select>

html_radios

屬性	類型	是否必須	缺省值	描述
name	string	No	radio	單選按鈕列表的名稱
values	array	Yes, 或指定 options 屬性	N/A	包含單選按鈕值的數(shù)組
output	array	Yes, 或指定 options 屬性	N/A	包含單選按鈕顯示值的數(shù)組
checked	string	No	empty	已選定的元素
options	associative array	Yes, 或指定 values 屬性	N/A	包含值和顯示的關聯(lián)數(shù)組
separator	string	No	empty	分隔每個單選按鈕的字符串

描述：

自定義函數(shù) html_radios 根據(jù)給定的數(shù)據(jù)創(chuàng)建單選按鈕組. 該函數(shù)可以指定哪個元素被選定，要么必須指定 values 和 ouput 屬性，要么指定 options 替代. 所有的輸出與 XHTML 兼容，上表未提到的其它參數(shù)在 <input> 標簽中以”名稱/屬性”對的方式顯示.

例子：

index.php:

require('Smarty.class.php');$smarty = new Smarty;$smarty->assign('cust_ids', array(1000,1001,1002,1003));$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','JaneJohnson','Carlie Brown'));$smarty->assign('customer_id', 1001);$smarty->display('index.tpl');index.tpl:{html_radios values=$cust_ids checked=$customer_id output=$cust_namesseparator="<br />"}

index.php:

require('Smarty.class.php');$smarty = new Smarty;$smarty->assign('cust_radios', array(1001 => 'Joe Schmoe',1002 => 'Jack Smith',1003 => 'Jane Johnson',1004 => 'Charlie Brown'));$smarty->assign('customer_id', 1001);$smarty->display('index.tpl');

index.tpl:

{html_radios name="id" options=$cust_radios checked=$customer_id separator="<br />"}

輸出：

<input type="radio" name="id[]" value="1000">Joe Schmoe<br /><input type="radio" name="id[]" value="1001" checked="checked"><br /><input type="radio" name="id[]" value="1002">Jane Johnson<br /><input type="radio" name="id[]" value="1003">Charlie Brown<br />