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

这篇文章主要介绍了ECSHOP模版系统显示标签使用介绍,需要的朋友可以参考下

ECSHOP模版系统中显示标签主要是转换HTML代码，该特性使得在表格中交替输出颜色或轮转使用数组中的值变得很容易，或者是根据给定的数据创建选项组，创建日期下拉菜单，它可以显示任意年月日。亦或者是根据给定的数据创建单选按钮组等，本文就给大家讲解一下ECSHOP模版系统的显示标签。

cycle

属性类型是否必须缺省值描述

namestringNodefault轮转的名称

valuesmixed

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

printbooleanNotrue是否输出值

advancebooleanNotrue是否使用下一个值(为 false 时使用当前值)

delimiterstringNo，指出values 属性中使用的分隔符，默认是逗号.

assignstringNoN/A输出值将被赋给模板变量的名称

描述：

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

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

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

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

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

例子：

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

输出：

html_options

属性类型是否必须缺省值描述

valuesarrayYes, unless using options attributeN/A包含下拉列表各元素值的数组

outputarrayYes, unless using options attributeN/A包含下拉列表各元素显示值的数组

selectedstring/arrayNoempty已选定的元素或元素数组

optionsassociative arrayYes, unless using values and outputN/A包含值和显示的关联数组

namestringNoempty下拉菜单的名称

描述：

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

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

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

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

例子：

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 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>

输出：

<select name=customer_id><option value="1000">Joe Schmoe</option>

<option value="1002">Jane Johnson</option>

<option value="1003">Charlie Brown</option>

</select>

html_select_date

属性类型是否必须缺省值描述

prefixstringNoDate_变量名称前缀

timetimestamp/YYYY-MMDDNoUNIX时间戳或年-月-日使用时间类型(data/time)

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

end_yearstringNo同start_year下拉列表中最后一个年份，或与当前年份的相对值(正/负几年)

display_daysbooleanNotrue是否显示天

display_monthsbooleanNotrue是否显示月

display_yearsbooleanNotrue是否显示年

month_formatstringNo%B月份的表示方法(strftime)

day_formatstringNo%02d天显示的格式(sprintf)

day_value_formatstringNo%d天的表示方法(sprintf)

year_as_textbooleanNofalse是否以文本方式显示年份

reverse_yearsbooleanNofalse逆序显示年份

field_arraystringNonull如果指定了名称，选定的区域将以[Day],[Year],[Month]的形式返回给PHP(待考)

day_sizestringNonull如果给定，为标签添加大小属性

month_sizestringNonull如果给定，为标签添加大小属性

year_sizestringNonull如果给定，为标签添加大小属性

all_extrastringNonull如果给定，为所有标签添加附加属性

day_extrastringNonull如果给定，为标签添加附加属性

month_extrastringNonull如果给定，为标签添加附加属性

year_extrastringNonull如果给定，为标签添加附加属性

field_orderstringNoMDY显示区域的顺序

field_separatorstringNo\n各区域间输出的分隔字符串

month_value_formatstringNo%m月份值的strftime表示方法，默认为%m

描述：

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

例子：

{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="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>

</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}

输出：

<option value="1">January</option>

<option value="2">February</option>

<option value="3">March</option>

<option value="4">April</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>

html_radios

属性类型是否必须缺省值描述

namestringNoradio单选按钮列表的名称

valuesarrayYes, 或指定 options 属性N/A包含单选按钮值的数组

outputarrayYes, 或指定 options 属性N/A包含单选按钮显示值的数组

checkedstringNoempty已选定的元素

optionsassociative arrayYes, 或指定 values 属性N/A包含值和显示的关联数组

separatorstringNoempty分隔每个单选按钮的字符串

描述：

自定义函数 html_radios 根据给定的数据创建单选按钮组. 该函数可以指定哪个元素被选定，要么必须指定 values 和 ouput 属性，要么指定 options 替代. 所有的输出与 XHTML 兼容，上表未提到的其它参数在 <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="1002">Jane Johnson<br />

<input type="radio" name="id[]" value="1003">Charlie Brown<br />