图像组件

核心组件图像组件是自适应图像组件。

用途

图像组件具有自适应图像选择和响应式行为,页面访客可以延迟加载,内容作者可以轻松放置图像。

内容作者可以使用 “编辑”对话框 编辑图像资源,如应用裁切或旋转图像。

模板作者可以在“设计”对话框中定义图像宽度以及其他设置。内容编辑者可以在“配置”对话框中上传或选择资源。

版本和兼容性

图像组件的当前版本是 v3,此版本随 2022 年 2 月的核心组件发行版 2.18.0 的发布引入,具体说明见本文。

下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。

组件版本 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v3 - 兼容 兼容
v2 兼容 兼容 兼容
v1 兼容 兼容 兼容

有关核心组件版本的更多信息,请参阅文档核心组件版本

响应式功能

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

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

小贴士

默认情况下,图像组件由自适应图像 Servlet 提供支持。 有关其工作原理的详细信息,请参阅自适应图像 Servlet

Dynamic Media 支持

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

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

下一代Dynamic Media支持

图像组件(截至 发行版本2.23.2)支持新一代Dynamic Media远程资源。

配置完毕后, 您可以从远程的新一代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 功能启用后,可用于编辑图像的选项将有所不同。

标准资产编辑

如果您正在编辑标准AEM资源,则可以单击 编辑 图标(在图像组件的上下文菜单中)。

图像组件的“编辑”对话框

  • 开始裁切

    开始裁切图标

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

    • 选择​删除裁切​可显示原始资源。

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

    裁切选项

  • 向右旋转

    向右旋转图标

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

  • 重置缩放

    重置缩放图标

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

  • 打开缩放滑块

    打开缩放滑块图标

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

    缩放滑块控件

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

图像就地编辑选项

注意

GIF图像不支持图像编辑操作。 在编辑模式下对 GIF 所做的任何此类更改都不会保留。

Dynamic Media资源编辑

如果您拥有 已启用Dynamic Media功能, 必须在资源控制台中编辑图像本身。

新一代Dynamic Media资源编辑

如果您拥有 新一代Dynamic Media已配置,智能裁剪 选项在组件的上下文菜单中可用。

智能裁剪

使用此对话框可调整智能裁切。

“智能裁剪”对话框

小贴士

有关智能裁切的详细信息,请参阅 此视频介绍了该功能。

“配置”对话框

图像组件提供了一个“配置”对话框,其中定义了图像本身及其描述和基本属性。

“资源”选项卡

图像组件“配置”对话框的“资源”选项卡

  • 从页面继承精选图像 – 此选项使用链接页面的精选图像或当前页面的精选图像(如果未链接图像)。

  • 图像资源 — 在以下情况下自动填充此值: 从页面继承精选图像 已选中。 取消选择可通过设置以下选项来手动定义图像。

    • 通过资源浏览器拖放资源或点击​浏览​选项,以从本地文件系统上传。
    • 点按或单击​“清除”​以取消选择当前选定的图像。
    • 点击或单击 选取 以打开 资产浏览器 以选择图像。
      • 如果 新一代Dynamic Media功能 启用后,您有多个选项可用于选择资产:
        • 本地 从本地AEM资产库中进行选择。
        • 远程 从AEM实例外的Dynamic Media库中进行选择。
    • 点按或单击​编辑​以在资产编辑器中管理资产的再现
  • 用于辅助功能的替换文本 - 此字段允许您为视障用户定义图像的描述。

    • 从页面继承替换文本 - 此选项使用 DAM 中 dc:description 元数据的链接资源值的替代描述或当前页面的替代描述(如果未链接资源)。
  • 不提供替换文本 – 此选项将图像标记为被屏幕阅读器等辅助技术忽略,以用于图像纯粹起装饰作用或不向页面传达额外信息的情况。

“元数据”选项卡

图像组件“配置”对话框的“元数据”选项卡

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

智能裁切​和​图像预设​为互斥选项。如果作者需要使用图像预设以及智能裁切再现,该作者必须使用​图像修饰符​来手动添加预设。

“样式”选项卡

图像组件“编辑”对话框的“样式”选项卡

图像组件支持 AEM 样式系统

使用下拉菜单选择要应用于该组件的样式。在“编辑”对话框中所做的选择与从组件工具栏中选择的操作效果相同。

必须在“设计”对话框中为此组件配置样式,以便下拉菜单可用。

“设计”对话框

主选项卡

图像组件“设计”对话框的主选项卡

  • 启用 DM 功能 – 在选中时,Dynamic Media 功能可用。
    • 仅当环境中启用了 Dynamic Media 时,才会出现此选项。
  • 启用 Web 优化图像 – 选中后,Web 优化图像传送服务将以 WebP 格式传送图像,使图像大小平均减少 25%。
    • 此选项仅在 AEMaaCS 中可用。
    • 当未选中或 Web 优化图像投放服务不可用时,将使用自适应图像 Servlet
  • 禁用延迟加载 – 在选中时,该组件将预加载所有图像而不会延迟加载。
  • 图像是装饰性的 – 定义在将图像组件添加到页面时,是否自动启用装饰性图像选项。
  • 从 DAM 获取替换文本 – 定义在将图像组件添加到页面时,是否自动启用从 DAM 检索替换文本的选项。
  • 从 DAM 获取题注 – 定义在将图像组件添加到页面时,是否自动启用从 DAM 检索题注的选项。
  • 以弹出窗口显示题注 – 定义在将图像组件添加到页面时,是否自动启用以弹出窗口显示图像题注的选项。
  • 调整宽度 – 此值用于调整作为 DAM 资源的基本图像的宽度。
    • 图像的长宽比将被保留。
    • 如果该值大于图像的实际宽度,则该值无效。
    • 该值对 SVG 图像没有影响。

您可以定义图像的宽度(以像素为单位),组件将根据浏览器的大小自动加载最合适的宽度。这是图像组件的响应式功能的重要组成部分。

  • 宽度 – 定义图像的宽度(以像素为单位),组件将根据浏览器的大小自动加载最合适的宽度。
    • 点按或单击​“添加”​按钮可添加其他大小。
      • 使用抓取手柄可重新排列大小。
      • 使用​“删除”​图标可删除宽度。
    • 默认情况下,图像加载会被延迟,直到图像变得可见。
      • 选择​禁用延迟加载​选项可在页面加载时加载图像。
  • JPEG 质量 – 用于转换(例如,缩放或裁切)的 JPEG 图像的质量系数(以从 0 到 100 的百分比表示)。
小贴士

查看文档自适应图像 Servlet 以了解通过仔细定义宽度来优化演绎版选择的提示。

样式选项卡

图像组件支持 AEM 样式系统

Adobe 客户端数据层

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

在此页面上