{html_image}
{html_image}
是生成 HTML <img>
标签的 自定义函数。如果没有提供 height
和 width
,则可从图像文件中自动计算它们。
属性
属性名称 | 必须 | 说明 |
---|---|---|
file | 是 | 图像的名称/路径 |
height | 否 | 图像显示高度(默认为实际图像高度) |
width | 否 | 是 |
图像显示宽度(默认为实际图像宽度) | basedir | 否 |
相对路径的基本目录(默认为 Web 服务器文档根目录) | basedir | alt |
图像的替代说明 | basedir | href |
将图像链接到的 href 值 | basedir | path_prefix |
-
输出路径的前缀
-
basedir
是相对图像路径的基础目录。如果未给出,则使用 Web 服务器的文档根$_ENV['DOCUMENT_ROOT']
作为基础。如果启用了安全功能,则图像必须位于安全策略的$secure_dir
路径中。有关详细信息,请参阅 安全性 部分。 -
href
是将图像链接到的 href 值。如果提供了链接,则<a href="LINKVALUE"><a>
标签将放置在图像标签周围。 -
path_prefix
是您可以为输出路径提供的可选前缀字符串。当您想为图像提供不同的服务器名称时,此功能非常有用。
注意
{html_image}
必须直接操作磁盘读取并计算图像的高和宽。如果您不使用模板 缓存,那么通常更好避免使用{html_image}
,并将图像标签保持为静态以获得最佳性能。
示例
{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}
上述模板的示例输出如下