跳至内容

{html_image}

{html_image} 是生成 HTML <img> 标签的 自定义函数。如果没有提供 heightwidth,则可从图像文件中自动计算它们。

属性

属性名称 必须 说明
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'}

上述模板的示例输出如下

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