Smarty手册
上一篇	第八章定制函数	下一篇

{html_image}

{html_image}是一个定制函数用来创建一个HTML的<img>标记。其height和width会自动根据图形文件计算，如果未指定的话。

属性名	类型	必需？	缺省	描述
file	string	Yes	n/a	图形的名称和路径
height	string	No	实际的图形高度	图形显示的高度
width	string	No	实际的图形宽度	图形显示的宽度
basedir	string	no	WEB服务器的文档根目录	相对路径构造时所基于的根目录
alt	string	no	""	图形的文本描述
href	string	no	n/a	图形链接的地址
path_prefix	string	no	n/a	输出路径的前缀

basedir是图形相对路径构造的基础路径。如果不给出的话，那么会使用WEB服务器的文档根目录$_ENV['DOCUMENT_ROOT']。如果激活了$security，图形的路径必需在一个安全目录中。
href是图形超链接的值。如果提供了链接，那么在图形标记周围会插入一个<a href="LINKVALUE"></a>标记对。
path_prefix是控制输出路径的可选前缀。如果你想给图形提供一个不同的服务器名，会有用。
所有其它不在该列表中的参数，将在创建的<img>标记中以名称/值对的形式输出。

技术注解：{html_image}需要读一次磁盘以获得图形的高度和宽度。如果你不使用模板缓存，通常更好的做法是避免使用{html_image}而使用静态图形标记以获得优化的性能。

例子8-11. {html_image}

{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}

上面的模板可能输出为：

<img src="pumpkin.jpg" alt="" width="44" height="68" />
<img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" />
<img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />

上一篇	主页	下一篇
{html_checkboxes}	返回	{html_options}