什么是 Smarty?
为什么使用它?
使用案例和工作流
语法比较
模板继承
最佳实践
速成课程
{html_image}
是一个可生成 HTML <img>
标记的自定义函数。如果没有提供 height
和 width
,则会根据图像文件对其进行自动计算。
属性名称 | 类型 | 是否必需 | 默认值 | 描述 |
---|---|---|---|---|
file | 字符串 | 是 | 不适用 | 图像的名称/路径 |
height | 字符串 | 否 | 图像的实际高度 | 显示图像的高度 |
width | 字符串 | 否 | 图像的实际宽度 | 显示图像的宽度 |
basedir | 字符串 | 否 | Web 服务器的文档根目录 | 相对路径使用的目录 |
alt | 字符串 | 否 | “” | 图像的替换说明 |
href | 字符串 | 否 | 不适用 | 图像的超链接 |
path_prefix | 字符串 | 否 | 不适用 | 输出路径的前缀 |
basedir
是相对图像路径使用的基本目录。如果没有给出,则 Web 服务器的文档根目录 $_ENV['DOCUMENT_ROOT']
将用作基准。如果启用了安全功能,则图像应位于安全性策略的 $secure_dir
路径。有关详细信息,请参阅安全性部分。
href
是图像超链接的值。如果提供了链接,则会在图像标记周围放置 <a href="LINKVALUE"><a>
标记。
path_prefix
是您可以给输出路径的可选前缀字符串。如果您想为图像提供其他服务器名称,这很有用。
上面列出列表中没有的所有参数都将作为创建的 <img>
标记内的名称/值对打印出来。
{html_image}
需要访问磁盘来读取图像并计算高宽。如果您不使用模板 缓存,则通常最好避免 {html_image}
并将图片标签设为静态以获得最佳性能。
示例 8.8 {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" />