文件字段
文件字段
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 用于:
- 用于显示的图像
- 需要行特定元数据的多个文件
请改用 image、images 或 repeater。
技术说明
- 将
file用于受管理的可下载资源,而不是用于可见的图像展示 - 如有需要,将该文件字段与单独的文本字段配对,用作可见的链接标签
- 使用
{{#if}}来保护可选的下载输出 - 如果每个可下载项需要自己的标题、描述或 CTA,请改用
repeater