图片字段

The image field stores one managed image asset.

最适用于

• 主视觉图
• 卡片缩略图
• 徽标
• 作者照片
• 区块视觉

模式示例

{ "name": "heroImage", "label": "Hero Image", "type": "image" }

模板用法

<img src="{heroImage.webp}" alt="{heroImage.description}">

主视觉用法：

{{#if heroImage}}
  <figure class="hero-media">
    <img src="{heroImage.width(1200).webp}" alt="{heroImage.description}">
  </figure>
{{/if}}

适用场景

当区块需要一个主要的托管视觉时，使用 image。

不应使用情形

在以下情况下不要使用 image：

• 区块需要多个视觉
• 资产应作为可下载文件而非直接展示

请改用 images 或 file。

技术说明

• 当区块需要明确的说明或标签时，将 image 字段与相关的文本字段配对
• 将该图片视为一个主资产，而非多项内容模型
• 使用 {{#if}} 保护可选的图片输出，以避免空的媒体容器
• 如果每个视觉都需要其各自的配文或元数据，请使用 images 或 repeater
• 单图片字段支持字段特定的辅助方法，例如 {heroImage.raw}、{heroImage.webp}、{heroImage.width(N)} 和 {heroImage.description}
• 该简写特定于组件字段契约；来自页面或列表上下文的图像对象通常使用以 .url 结尾的对象式 Facet 链

相关

• 多图字段
• 文件字段
• 重复器