Skip to content

{html_image}

{html_image} 是一个自定义函数，用于生成 HTML 的 <img> 标签。如果没有提供 height 和 width，它们将自动从图像文件中计算得出。

属性

属性名 必需 描述
file 是 图像的名称/路径
height 否 显示图像的高度（默认为实际图像高度）
width 否 显示图像的宽度（默认为实际图像宽度）
basedir 否 相对路径的基本目录（默认为 Web 服务器文档根目录）
alt 否 图像的替代描述
href 否 图像链接的 href 值
path_prefix 否 输出路径的前缀

  • basedir 是相对图像路径所基于的基本目录。如果未提供，将使用 Web 服务器的文档根目录 $_ENV['DOCUMENT_ROOT'] 作为基本目录。如果启用了安全性，那么图像必须位于安全策略的 $secure_dir 路径中。有关详细信息，请参阅 安全性 部分。

  • href 是图像链接的 href 值。如果提供了链接，将在图像标签周围放置一个 <a href="LINKVALUE"><a> 标签。

  • path_prefix 是一个可选的前缀字符串，用于给输出路径添加前缀。如果您想为图像提供不同的服务器名称，这将非常有用。

  • 所有不在上述列表中的参数都将以名称/值对的形式打印在创建的 <img> 标签中。

注意

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