图像组件 (v2)

核心组件图像组件是一个自适应图像组件，具备就地编辑的功能。

用途

图像组件具有面向页面访客的自适应图像选择功能和带延迟加载的响应式行为，还具有面向内容作者的轻松图像放置和裁切功能。

模板作者可以在“设计”对话框中定义图像宽度以及裁切和其他设置。内容编辑者可以在“配置”对话框中上传或选择资源，并在“编辑”对话框中裁切图像。为了增加便利性，还可以简单地就地修改图像。

版本和兼容性

本文档介绍了图像组件 v2，此版本随 2018 年 1 月的核心组件发行版本 2.0.0 的发布引入。

响应式功能

图像组件提供了可靠的响应式功能，可以直接使用。在页面模板级别，可以使用“设计”对话框来定义图像资源的默认宽度。然后，图像组件将自动加载正确的宽度，以根据浏览器窗口的大小进行显示。在窗口调整大小时，图像组件即时动态加载正确的图像大小。组件开发人员无需担心自定义媒体查询的定义方式，因为图像组件已经针对加载内容进行了优化。

此外，图像组件支持延迟加载，可以将实际图像资源的加载推迟到在浏览器中可见时，从而提升了页面的响应能力。

Dynamic Media 支持

图像组件（截止 发行版本 2.13.0）支持 Dynamic Media 资源。在启用时，这些功能提供了一种能力，即通过简单的拖放功能或者通过资源浏览器，就可以像对任何其他图像一样加载 Dynamic Media 图像资源。此外还支持图像修饰符、图像预设和智能裁切。

使用核心组件构建的 Web 体验现在具备丰富、支持 Sensei、可靠、高性能、跨平台的 Dynamic Media 图像功能。

SVG 支持

图像组件支持可缩放矢量图 (SVG)。

• 从 DAM 拖放上传 SVG 资源以及从本地文件系统上传 SVG 文件均受支持。
• 对原始 SVG 文件进行流式处理（跳过转换）。
• 对于 SVG 图像，“智能图像”和“智能大小”均设置为图像模型中的空数组。

安全性

为安全起见，图像编辑器从不直接调用原始 SVG。通过 <img src=“path-to-component”> 调用它。这可以防止浏览器执行在 SVG 文件中嵌入的任何脚本。

示例组件输出

要体验图像组件并查看其配置选项示例以及 HTML 和 JSON 输出，请访问组件库。

技术详细信息

在 GitHub 上可找到有关图像组件的最新技术文档。

在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。

图像组件支持 schema.org 微数据。

“配置”对话框

除了标准“编辑”对话框和“设计”对话框之外，图像组件还提供了一个“配置”对话框，其中定义了图像本身及其描述和基本属性。

“资源”选项卡

• 图像资源
  • 通过资源浏览器拖放资源或点击​浏览​选项，以从本地文件系统上传。
  • 点按或单击​“清除”​以取消选择当前选定的图像。
  • 点按或单击​“编辑”​可在资产编辑器中管理资产的再现。

“元数据”选项卡

• 预设类型 – 这定义了可用图像预设的类型，可以是​图像预设​或​智能裁切，并且仅在启用了 Dynamic Media 功能的情况下可用。
  • 图像预设 – 选中了​预设类型​的​图像预设​时，下拉菜单​图像预设​可用，并允许从可用的 Dynamic Media 预设中选择。此项只有在为所选资源定义了预设时才可用。
  • 智能裁切 – 选中了​预设类型​的​智能裁切​时，下拉菜单​再现​可用，并允许从所选资源的可用再现中选择。此项只有在为所选资源定义了再现时才可用。
  • 图像修饰符 – 在这里可以定义其他 Dynamic Media 图像服务命令，不论选择了什么​预设类型，都使用 & 分隔。
• 图像是装饰性的 – 检查图像是否应被辅助技术忽略，因此不需要替换文本。这仅适用于装饰性图像。
• 替换文本 – 用于替代该图像含义或功能的文字内容，适用于视障读者。
  • 从 DAM 获取替换文本 – 选中时，将使用 DAM 中 dc:description 元数据的值填充图像的替换文本。
• 题注 – 有关图像的附加信息，默认显示在图像的下方。
  • 从 DAM 获取题注 – 选中时，将使用 DAM 中 dc:title 元数据的值填充图像的题注文本。
  • 以弹出窗口显示题注 – 选中后，不会在图像下方显示题注，但在某些浏览器中，将鼠标悬停于图像上方时，会以弹出信息形式显示题注。
• 链接 – 将图像链接到其他资源。
  • 使用“选择”对话框可链接到其他 AEM 资源。
  • 如果未链接到 AEM 资源，请输入绝对 URL。非绝对 URL 将解释为相对于 AEM。
• ID – 利用此选项，可以控制 HTML 和 Data Layer 中组件的唯一标识符。
  • 如果留空，系统会自动为您生成一个唯一 ID，可以通过检查结果页面找到该 ID。
  • 如果指定一个 ID，作者有责任确保它是唯一的。
  • 更改此 ID 会对 CSS、JS 和数据层跟踪产生影响。

“编辑”对话框

利用“编辑”对话框，内容作者可以裁切、修改启动地图和缩放图像。

• 开始裁切

  

  选择此选项将打开一个预定义裁切比例的下拉菜单。

  • 选择​手动​选项可定义您自己的裁切。
  • 选择​删除裁切​可显示原始资源。

  选择一个裁切选项后，可使用蓝色手柄调整图像上的裁切大小。

  

• 向右旋转

  

  使用此选项可将图像向右（顺时针）旋转 90°。

• 水平翻转

  

  使用此选项可水平翻转图像或者将图像沿 y 轴旋转 180°。

• 垂直翻转

  

  使用此选项可垂直翻转图像或者将图像沿 x 轴旋转 180°。

• 重置缩放

  

  如果图像已缩放，使用此选项可重置缩放级别。

• 打开缩放滑块

  

  使用此选项可显示用于控制图像的缩放级别的滑块。

  

就地编辑器也可以用于修改图像。由于有空间限制，因此仅将基本选项排成一行。对于完整的编辑选项，请使用全屏模式。

“设计”对话框

利用“设计”对话框，模板作者可以在使用此组件时定义内容作者的裁切、上传和轮换上传选项。

主选项卡

在​主​选项卡上，您可以定义图像的宽度（以像素为单位），组件将根据浏览器的大小自动加载最合适的宽度。这是图像组件的响应式功能的重要组成部分。

此外，您可以定义在作者将组件添加到页面时，自动禁用哪些常规组件选项。

• 启用 DM 功能 – 在选中时，启用 Dynamic Media 功能可用。
• 启用 Web 优化图像 — 选中后，Web 优化图像传送服务 将以 WebP 格式传送图像，使图像大小平均减少 25%。
  • 此选项仅在 AEMaaCS 中可用。
  • 当未选中或 Web 优化图像投放服务不可用时，将使用自适应图像 Servlet。
• 启用延迟加载 – 定义在将图像组件添加到页面时，是否自动启用延迟加载选项。
• 图像是装饰性的 – 定义在将图像组件添加到页面时，是否自动启用装饰性图像选项。
• 从 DAM 获取替换文本 – 定义在将图像组件添加到页面时，是否自动启用从 DAM 检索替换文本的选项。
• 从 DAM 获取题注 – 定义在将图像组件添加到页面时，是否自动启用从 DAM 检索题注的选项。
• 以弹出窗口显示题注 – 定义在将图像组件添加到页面时，是否自动启用以弹出窗口显示图像题注的选项。
• 禁用 UUID 跟踪 – 选中此项可禁用图像资源的 UUID。
• 宽度 – 定义图像的宽度（以像素为单位），组件将根据浏览器的大小自动加载最合适的宽度。
  • 点按或单击​“添加”​按钮可添加其他大小。
    • 使用抓取手柄可重新排列大小。
    • 使用​“删除”​图标可删除宽度。
  • 默认情况下，图像加载会被延迟，直到图像变得可见。
    • 选择​禁用延迟加载​选项可在页面加载时加载图像。
• JPEG 质量 – 用于转换（例如，缩放或裁切）的 JPEG 图像的质量系数（以从 0 到 100 的百分比表示）。

“功能”选项卡

在​功能​选项卡上，您可以定义在使用组件时可供内容作者使用的选项，包括上传选项、方向和裁切选项。

• 来源

  

  选择​允许从文件系统上传资源​选项可允许内容作者从其本地计算机上传图像。要强制内容作者仅从 AEM 中选择资源，请取消选择此选项。

• 方向

  

• 旋转
  使用此选项可允许内容作者使用
  向右旋转​选项。

• 翻转
  使用此选项可允许内容作者使用
  水平翻转​和​垂直翻转​选项。

  注意

  默认情况下已禁用​翻转​选项。启用此选项将在图像组件的“编辑”对话框中显示​垂直翻转​和​水平翻转​按钮，但 AEM 当前不支持该功能，并且不会保留使用这些选项所做的任何更改。

• 裁切

  

  选择​允许裁切​选项可允许内容作者在“编辑”对话框中裁切组件中的图像。

  • 单击​“添加”​可添加预定义的裁切长宽比。
  • 输入一个描述性名称，该名称将显示在​开始裁切​下拉列表中。
  • 输入长宽比的数字比率。
  • 使用拖动手柄可重新排列长宽比
  • 使用垃圾桶图标可删除长宽比。
  注意

  请注意，在 AEM 中，裁切比例被定义为​高宽比。这与常见的宽高比的定义不同，这样做是出于对旧版兼容性的考虑。只要您提供明确的比率名称，内容作者就不会意识到任何差异，因为该名称显示在 UI 中，而不是比率本身。

“样式”选项卡

图像组件支持 AEM 样式系统。

Adobe 客户端数据层

图像组件支持 Adobe 客户端数据层。