媒体标签说明

本文整理模板中缩略图、普通图片和附件相关的内联标签。缩略图和图片属于图片类；附件是文件类，不和图片共用标签语义。

缩略图和图片

推荐在新模板中使用函数式 URL 写法，由模板作者自行组织 <img> 结构：

{thumb_url($t.thumb)}
{thumb_url($t.thumb, 300, 200)}
{thumb_url($t.thumb, 300, 200, "crop")}

{image_url($image)}
{image_url($image, 300, 200)}

{file_url($t.thumb)}

说明：

• thumb_url($value, $width, $height) 用于内容缩略图，返回缩略图 URL。
• image_url($value, $width, $height) 用于普通图片字段，返回缩略图 URL。
• file_url($value) 返回原图或附件公开地址，不生成缩略图。
• 宽高可以自由设置；任意一个大于 0 时会尝试生成本地缩略图。
• 第 4 个参数可以传 "crop"，用于按裁剪方式生成缩略图。
• 判断是否有缩略图仍直接判断字段值，例如 {if $t.thumb}...{else}...{/if}。

示例：

{if $t.thumb}
  <img src="{thumb_url($t.thumb, 200, 200)}" alt="{$t.title}">
{else}
  <span>没有缩略图</span>
{/if}

{if $t.thumb}
  <a href="{file_url($t.thumb)}">查看原图</a>
{/if}

兼容的属性式写法仍可使用：

{thumb_url url=$thumb}
{thumb_url url=$thumb width=300 height=200}
{thumb_img url=$thumb width=300 height=200 alt=$title class=cover}

{image_url url=$image default="/assets/images/default.png"}
{image_img url=$image width=300 height=200 loading=lazy}

说明：

• thumb_* 用于内容缩略图。
• image_* 用于普通图片字段。
• width/w 和 height/h 任意一个大于 0 时，会尝试生成本地缩略图。
• 不设置宽高时，直接输出原图地址。
• default 或 empty 用于字段为空时的默认图片。
• *_img 输出完整 <img>，支持 alt、class、id、title、style、loading、decoding、width、height。

附件

{file_url url=$file}
{file_link url=$file text="下载附件" target=_blank class=download}

说明：

• 附件统一使用 file_url 和 file_link。
• 附件不生成缩略图，只输出文件地址或下载链接。
• file_link 未设置 text 时，默认使用文件名。
• target=_blank 会自动补 rel="noopener"。