ECSHOP模板系统显示标签使用介绍

成留發表於 2023-6-5 00:00:00

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>
cycle</li><li>
html_options</li><li>
html_select_date</li><li>
html_radios</li></ul></div>
ECSHOP模板系统中显示标签主要是转换HTML代码，该特性使得在表格中交替输出颜色或轮转使用数组中的值变得很容易，或者是根据给定的数据创建选项组，创建日期下拉菜单，它可以显示任意年月日。亦或者是根据给定的数据创建单选按钮组等，本文就给大家讲解一下ECSHOP模板系统的显示标签。
<h2>
cycle</h2>
<table border="0" width="100%"><tbody>
<tr>
<td>

属性
</td>
<td>

类型
</td>
<td>

是否必须
</td>
<td>

缺省值
</td>
<td>

描述
</td>
</tr>
<tr>
<td>

name
</td>
<td>

string
</td>
<td>

No
</td>
<td>

default
</td>
<td>

轮转的名称
</td>
</tr>
<tr>
<td>

values
</td>
<td>

mixed
</td>
<td>


</td>
<td>

N/A
</td>
<td>

待轮转的值，可以是用逗号分隔的列表(请查看 delimiter 属性)或一个包含多值的数组.
</td>
</tr>
<tr>
<td>

print
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

true
</td>
<td>

是否输出值
</td>
</tr>
<tr>
<td>

advance
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

true
</td>
<td>

是否使用下一个值(为 false 时使用当前值)
</td>
</tr>
<tr>
<td>

delimiter
</td>
<td>

string
</td>
<td>

No
</td>
<td>

，
</td>
<td>

指出values 属性中使用的分隔符，默认是逗号.
</td>
</tr>
<tr>
<td>

assign
</td>
<td>

string
</td>
<td>

No
</td>
<td>

N/A
</td>
<td>

输出值将被赋给模板变量的名称
</td>
</tr>
</tbody></table>

描述：

Cycle 用于轮转使用一组值. 该特性使得在表格中交替输出颜色或轮转使用数组中的值变得很容易。

如果需要在模板中使用多个轮转，需要给出唯一的 name 属性.

用户可以设置 print 属性为 false 强制不输出当前值. 该特性可以很方便地略过某个值.

advance 属性用于重复使用某个值. 当该属性设置为 false 时，下次调用该轮转时将输出同样的值.

如果指定了 “assign” 这个特殊属性，该轮转的输出值将被赋给由 assign 指定的模板变量，而不是直接输出。

例子：
<pre>
{section name=rows loop=$data}<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"><td>{$data}</td></tr>{/section}</pre>

输出：
<pre>
<tr bgcolor="#eeeeee"><td>1</td></tr><tr bgcolor="#d0d0d0"><td>2</td></tr><tr bgcolor="#eeeeee"><td>3</td></tr></pre>
<h2>
html_options</h2>
<table border="0" width="100%"><tbody>
<tr>
<td>

属性
</td>
<td>

类型
</td>
<td>

是否必须
</td>
<td>

缺省值
</td>
<td>

描述
</td>
</tr>
<tr>
<td>

values
</td>
<td>

array
</td>
<td>

Yes, unless using options attribute
</td>
<td>

N/A
</td>
<td>

包含下拉列表各元素值的数组
</td>
</tr>
<tr>
<td>

output
</td>
<td>

array
</td>
<td>

Yes, unless using options attribute
</td>
<td>

N/A
</td>
<td>

包含下拉列表各元素显示值的数组
</td>
</tr>
<tr>
<td>

selected
</td>
<td>

string/array
</td>
<td>

No
</td>
<td>

empty
</td>
<td>

已选定的元素或元素数组
</td>
</tr>
<tr>
<td>

options
</td>
<td>

associative array
</td>
<td>

Yes, unless using values and output
</td>
<td>

N/A
</td>
<td>

包含值和显示的关联数组
</td>
</tr>
<tr>
<td>

name
</td>
<td>

string
</td>
<td>

No
</td>
<td>

empty
</td>
<td>

下拉菜单的名称
</td>
</tr>
</tbody></table>

描述：

自定义函数 html_options 根据给定的数据创建选项组. 该函数可以指定哪些元素被选定. 要么必须指定 values 和 ouput 属性，要么指定 options 替代。

如果给定值是数组，将作为 OPTGROUP 处理，且支持递归. 所有的输出与 XHTML 兼容。

如果指定了可选属性 name，该选项列表将将被置于<select name=”groupname”></select>标签对中. 如果没有指定，那么只产生选项列表。

上表未提到的其它参数在 <select> 标签中以”名称/属性”对的方式显示. 如果没有指定可选属性 name 这些参数将被忽略。

例子：

index.php:
<pre>
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></pre>

index.php:
<pre>
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');</pre>

index.tpl:
<pre>
<select name=customer_id>{html_options options=$cust_options selected=$customer_id}</select></pre>

输出：
<pre>
<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></pre>
<h2>
html_select_date</h2>
<table><tbody>
<tr>
<td>

属性
</td>
<td>

类型
</td>
<td>

是否必须
</td>
<td>

缺省值
</td>
<td>

描述
</td>
</tr>
<tr>
<td>

prefix
</td>
<td>

string
</td>
<td>

No
</td>
<td>

Date_
</td>
<td>

变量名称前缀
</td>
</tr>
<tr>
<td>

time
</td>
<td>

timestamp/YYYY-MMDD
</td>
<td>

No
</td>
<td>

UNIX时间戳或年-月-日
</td>
<td>

使用时间类型(data/time)
</td>
</tr>
<tr>
<td>

start_year
</td>
<td>

string
</td>
<td>

No
</td>
<td>

年份或与当前年份的相对值
</td>
<td>

下拉列表中第一个年份，或与当前年份的相对值(正/负几年)
</td>
</tr>
<tr>
<td>

end_year
</td>
<td>

string
</td>
<td>

No
</td>
<td>

同start_year
</td>
<td>

下拉列表中最后一个年份，或与当前年份的相对值(正/负几年)
</td>
</tr>
<tr>
<td>

display_days
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

true
</td>
<td>

是否显示天
</td>
</tr>
<tr>
<td>

display_months
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

true
</td>
<td>

是否显示月
</td>
</tr>
<tr>
<td>

display_years
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

true
</td>
<td>

是否显示年
</td>
</tr>
<tr>
<td>

month_format
</td>
<td>

string
</td>
<td>

No
</td>
<td>

%B
</td>
<td>

月份的表示方法(strftime)
</td>
</tr>
<tr>
<td>

day_format
</td>
<td>

string
</td>
<td>

No
</td>
<td>

%02d
</td>
<td>

天显示的格式(sprintf)
</td>
</tr>
<tr>
<td>

day_value_format
</td>
<td>

string
</td>
<td>

No
</td>
<td>

%d
</td>
<td>

天的表示方法(sprintf)
</td>
</tr>
<tr>
<td>

year_as_text
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

false
</td>
<td>

是否以文本方式显示年份
</td>
</tr>
<tr>
<td>

reverse_years
</td>
<td>

boolean
</td>
<td>

No
</td>
<td>

false
</td>
<td>

逆序显示年份
</td>
</tr>
<tr>
<td>

field_array
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果指定了名称，选定的区域将以,,的形式返回给PHP(待考)
</td>
</tr>
<tr>
<td>

day_size
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加大小属性
</td>
</tr>
<tr>
<td>

month_size
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加大小属性
</td>
</tr>
<tr>
<td>

year_size
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加大小属性
</td>
</tr>
<tr>
<td>

all_extra
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为所有标签添加附加属性
</td>
</tr>
<tr>
<td>

day_extra
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加附加属性
</td>
</tr>
<tr>
<td>

month_extra
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加附加属性
</td>
</tr>
<tr>
<td>

year_extra
</td>
<td>

string
</td>
<td>

No
</td>
<td>

null
</td>
<td>

如果给定，为标签添加附加属性
</td>
</tr>
<tr>
<td>

field_order
</td>
<td>

string
</td>
<td>

No
</td>
<td>

MDY
</td>
<td>

显示区域的顺序
</td>
</tr>
<tr>
<td>

field_separator
</td>
<td>

string
</td>
<td>

No
</td>
<td>

\n
</td>
<td>

各区域间输出的分隔字符串
</td>
</tr>
<tr>
<td>

month_value_format
</td>
<td>

string
</td>
<td>

No
</td>
<td>

%m
</td>
<td>

月份值的strftime表示方法，默认为%m
</td>
</tr>
</tbody></table>

描述：

自定义函数 html_select_date 用于创建日期下拉菜单. 它可以显示任意年月日.

例子：
<pre>
{html_select_date}</pre>

输出：
<pre>
<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></pre>

例子：
<pre>
{* 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}</pre>

输出：
<pre>
<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></pre>
<h2>
html_radios</h2>
<table border="0" width="100%"><tbody>
<tr>
<td>

属性
</td>
<td>

类型
</td>
<td>

是否必须
</td>
<td>

缺省值
</td>
<td>

描述
</td>
</tr>
<tr>
<td>

name
</td>
<td>

string
</td>
<td>

No
</td>
<td>

radio
</td>
<td>

单选按钮列表的名称
</td>
</tr>
<tr>
<td>

values
</td>
<td>

array
</td>
<td>

Yes, 或指定 options 属性
</td>
<td>

N/A
</td>
<td>

包含单选按钮值的数组
</td>
</tr>
<tr>
<td>

output
</td>
<td>

array
</td>
<td>

Yes, 或指定 options 属性
</td>
<td>

N/A
</td>
<td>

包含单选按钮显示值的数组
</td>
</tr>
<tr>
<td>

checked
</td>
<td>

string
</td>
<td>

No
</td>
<td>

empty
</td>
<td>

已选定的元素
</td>
</tr>
<tr>
<td>

options
</td>
<td>

associative array
</td>
<td>

Yes, 或指定 values 属性
</td>
<td>

N/A
</td>
<td>

包含值和显示的关联数组
</td>
</tr>
<tr>
<td>

separator
</td>
<td>

string
</td>
<td>

No
</td>
<td>

empty
</td>
<td>

分隔每个单选按钮的字符串
</td>
</tr>
</tbody></table>

描述：

自定义函数 html_radios 根据给定的数据创建单选按钮组. 该函数可以指定哪个元素被选定，要么必须指定 values 和 ouput 属性，要么指定 options 替代. 所有的输出与 XHTML 兼容，上表未提到的其它参数在 <input> 标签中以”名称/属性”对的方式显示.

例子：

index.php:
<pre>
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=" "}</pre>

index.php:
<pre>
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');</pre>

index.tpl:
<pre>
{html_radios name="id" options=$cust_radios checked=$customer_id separator=" "}</pre>

输出：
<pre>
<input type="radio" name="id[]" value="1000">Joe Schmoe <input type="radio" name="id[]" value="1001" checked="checked"> <input type="radio" name="id[]" value="1002">Jane Johnson <input type="radio" name="id[]" value="1003">Charlie Brown </pre>
<div>
</div>
<div>
<ul></ul>
</div>

頁: [1]

琼殿技术论坛's Archiver

ECSHOP模板系统显示标签使用介绍