smarty自定义函数

1. assign assign 用于在模板被执行时为模板变量赋值. {assign var="name" value="Bob"}
2. counter

counter 用于输出一个记数过程. counter 保存了每次记数时的当前记数值. 用户可以通过调节 interval 和 direction 调节该值. 也可以决定是否输出该值. 如果需要同时运行多个计数器，必须为它们指定不同的名称. 如果没有指定名称，模板引擎使用 "default" 作为缺省值.

属性	类型	是否必须	缺省值	描述
name	string	No	default	计数器的名称
start	number	No	1	记数器初始值
skip	number	No	1	记数器间隔、步长
direction	string	No	up	记数器方向，(增/减)
print	boolean	No	true	是否输出值
assign	string	No	n/a	输出值将被赋给模板变量的名称

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

属性	类型	是否必须	缺省值	描述
name	string	No	default	轮转的名称
values	mixed	Yes	N/A	待轮转的值，可以是用逗号分隔的列表(请查看 delimiter 属性)或一个包含多值的数组.
print	boolean	No	true	是否输出值
advance	boolean	No	true	是否使用下一个值(为 false 时使用当前值)
delimiter	string	No	,	指出values 属性中使用的分隔符，默认是逗号.
assign	string	No	n/a	输出值将被赋给模板变量的名称

advance 属性用于重复使用某个值. 当该属性设置为 false 时，下次调用该轮转时将输出同样的值. {section name=rows loop=$data}
<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}">
<td>{$data[rows]}</td>
</tr>
{/section}

4. debug

{debug} 将调式信息输出到页面上. 该函数是否可用取决于 Smarty 的 debug 设置. 该函数在运行时取得数据，因此不能显示使用中的模板，只能显示运行时被赋值的变量. 不过还是可以看到所有模板内当前可用的变量.

5. eval

eval 按处理模板的方式计算取得变量的值. 该特性可用于在配置文件中的标签/变量中嵌入其它模板标签/变量.

6. fetch

fetch 用于从本地文件系统、HTTP或FTP上取得文件并显示文件的内容. 如果文件名称以"http://"开头，将取得该网站页面并显示. 如果文件名称以"ftp://"开头，将从ftp服务器取得该文件并显示.

7. html_checkboxes

自定义函数 html_checkboxes 根据给定的数据创建复选按钮组. 该函数可以指定哪些元素被选定. 要么必须指定 values 和 ouput 属性，要么指定 options 替代. 所有的输出与 XHTML 兼容.

8. html_image 自定义函数 html_image 产生一个图象的 HTML 标签. 如果没有提供高度和宽度值，将根据图象的实际大小自动取得. 9. html_options 自定义函数 html_options 根据给定的数据创建选项组. 该函数可以指定哪些元素被选定. 要么必须指定 values 和 ouput 属性，要么指定 options 替代. 10. html_radios

自定义函数 html_radios 根据给定的数据创建单选按钮组. 该函数可以指定哪个元素被选定. 要么必须指定 values 和 ouput 属性，要么指定 options 替代. 所有的输出与 XHTML 兼容.

11. html_select_date 自定义函数 html_select_date 用于创建日期下拉菜单. 它可以显示任意年月日. 12. html_select_time 自定义函数 html_select_time 用于创建时间下拉菜单. 它可以显示任意时分秒. 13. html_table

自定义函数 html_table 将数组中的数据填充到 HTML 表格中. cols 属性决定表格有多少列. table_attr , tr_attr和 td_attr 属性决定表格中 tr 和 td 标签的一些附加属性. 如果tr_attr 和 td_attr 属性值为数组，将轮流使用其中的值. 如果指定了 trailpad 属性，将在表尾最后一行附加一些数据.

14. math math 允许模板设计者在模板中进行数学表达式运算. 均表达式中可以使用任何数值类型的变量，结果在 math 标签的位置输出. 表达式中使用的变量被当做参数传递给函数，可以是模板变量或静态值. 目前可以使用的运算符有:+, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans 和 tan .关于数学函数的详细信息，请查看 PHP 文档. 15. mailto mailto 自动生成电子邮件链接，并根据选项决定是否对地址信息编码. 电子邮件地址编码使得网络嗅探程序难以收集到电子邮件地址信息.
16. popup_init

popup 函数整合了 overLib(用于弹出窗口的函数库) 库. 这些函数用于上下文敏感信息如帮助窗口或工具提示. 如果准备使用 popup 函数，在页首必须先调用 popup_init 函数. overLib 由 Erik Bosrup 开发，其主页位于http://www.bosrup.com/web/overlib/.

在 Smarty 2.1.2 版中没有带 overLib 库. 必须下载该库，将 overlib.js 文件置于文档根目录下，调用 popup_init 的时候将该文件的相对路径作为参数"src"传递.

17. popup popup 用于创建javascript弹出窗口.

属性	类型	是否必须	缺省值	描述
text	string	Yes	n/a	弹出窗口中要显示的内容，文本或超文本
trigger	string	No	onMouseOver	触发弹出窗口的条件，可选择onMouseOver(鼠标经过)或onClick(鼠标单击)
sticky	boolean	No	false	弹出窗口始终显示，直到关闭
caption	string	No	n/a	标题文本内容
fgcolor	string	No	n/a	弹出窗口内部颜色
bgcolor	string	No	n/a	弹出窗口边框颜色
textcolor	string	No	n/a	弹出窗口内部文字颜色
capcolor	string	No	n/a	弹出窗口标题颜色
closecolor	string	No	n/a	设置"关闭"文本信息的颜色
textfont	string	No	n/a	设置内容文本使用的字体类型
captionfont	string	No	n/a	设置标题文本的字体
closefont	string	No	n/a	设置"关闭"文本信息的字体类型
textsize	string	No	n/a	设置内容文本使用的字体大小
captionsize	string	No	n/a	设置标题文本使用的字体大小
closesize	string	No	n/a	设置"关闭"文本信息的字体大小
width	integer	No	n/a	sets the width of the box设置宽度
height	integer	No	n/a	sets the height of the box设置高度
left	boolean	No	false	使弹出窗口位于鼠标左侧
right	boolean	No	false	使弹出窗口位于鼠标右侧
center	boolean	No	false	使弹出窗口的中间位置和鼠标位置重合
above	boolean	No	false	使弹出窗口位于鼠标上侧. 注: 仅在设置了height属性时有效
below	boolean	No	false	使弹出窗口位于鼠标下侧
border	integer	No	n/a	决定弹出窗口的边框厚度
offsetx	integer	No	n/a	横向显示位置偏移量
offsety	integer	No	n/a	纵向显示位置偏移量
fgbackground	url to image	No	n/a	使用背景图片代替背景颜色
bgbackground	url to image	No	n/a	使用背景图片代替边框颜色. 注1: 必须设置bgcolor为""，边框颜色才不会显示. 注2: 当有关闭链接时，Netscape会重新渲染表格，看起来可能会有点问题.
closetext	string	No	n/a	自定义关闭链接显示文本
noclose	boolean	No	n/a	不显示关闭链接
status	string	No	n/a	设置状态栏显示的文本
autostatus	boolean	No	n/a	设置弹出窗口状态栏显示的文本为当前窗口状态栏显示的文本. 注: 该设置将覆盖status的设置
autostatuscap	string	No	n/a	设置状态栏显示的文本为标题栏显示的信息. 注: 该设置将覆盖status和autostatus设置
inarray	integer	No	n/a	该属性告诉overLib在ol_text数组中读该属性指定的索引的元素到text中. 该属性可以代替text属性
caparray	integer	No	n/a	该属性告诉overLib在ol_caps数组中读该属性指定的索引的元素到caption中.
capicon	url	No	n/a	弹出前先显示该图象
snapx	integer	No	n/a	横向将弹出窗口附着于指定位置
snapy	integer	No	n/a	纵向将弹出窗口附着于指定位置
fixx	integer	No	n/a	锁定弹出窗口的横向位置. 注: 该设置将覆盖其它横向设置
fixy	integer	No	n/a	锁定弹出窗口的纵向位置. 注: 该设置将覆盖其它纵向设置
background	url	No	n/a	设置图象作为输出表格区块的背景
padx	integer,integer	No	n/a	在背景图象后附加横向空白. 注: 该属性有两个参数
pady	integer,integer	No	n/a	在背景图象后附加纵向空白. 注: 该属性有两个参数
fullhtml	boolean	No	n/a	允许用户完全控制背景图片上的HTML. HTML代码位于"text"属性中
frame	string	No	n/a	控制弹出窗口在不同的框架中. 关于此函数更多详细信息，请查阅overlib文档.
timeout	string	No	n/a	调用特定javascript脚本函数，将返回值显示在弹出窗口中.
delay	integer	No	n/a	使得弹出窗口像一个工具提示，窗口将显示到该属性指定的时间(毫秒)
hauto	boolean	No	n/a	自动决定弹出窗口位于鼠标的左侧或右侧.
vauto	boolean	No	n/a	自动决定弹出窗口位于鼠标的上侧或下侧.

18. textformat textformat 用于格式化文本. 该函数主要清理空格和特殊字符，对段落按单词边界换行和行缩进等段落格式化处理.

属性	类型	是否必须	缺省值	描述
style	string	No	n/a	预处理风格
indent	number	No	0	单行缩进的字符数目
indent_first	number	No	0	首行缩进的字符数目
indent_char	string	No	(single space)	填充缩进区域的字符(或字符串)
wrap	number	No	80	单行长度，超过该长度自动折行
wrap_char	string	No	\n	折行使用的字符(或字符串)，被附加在行尾
wrap_cut	boolean	No	false	如果设置为真，换行时不考虑换行点所在位置是否为完整单词，直接换行. 反之将在单词的边界处换行.
assign	string	No	n/a	输出值将被赋给模板变量的名称