文件字段

文件字段

The file field stores one managed file asset.

适用场景

  • 可下载的 PDF
  • 宣传册
  • 附件
  • 规格表

模式示例

{ "name": "downloadFile", "label": "Download File", "type": "file" }

模板用法

<a href="{{ downloadFile.url }}">Download</a>

下载块示例:

{{#if downloadFile}}
  <a href="{{ downloadFile.url }}" class="download-link">
    {{ downloadLabel | default("Download file") }}
  </a>
{{/if}}

何时使用

当某个区块需要一个可下载或可链接的资产时,使用 file

何时不应使用

不要将 file 用于:

  • 用于显示的图像
  • 需要行特定元数据的多个文件

请改用 imageimagesrepeater

技术说明

  • file 用于受管理的可下载资源,而不是用于可见的图像展示
  • 如有需要,将该文件字段与单独的文本字段配对,用作可见的链接标签
  • 使用 {{#if}} 来保护可选的下载输出
  • 如果每个可下载项需要自己的标题、描述或 CTA,请改用 repeater

相关