图像组件 image-component
核心组件图像组件是自适应图像组件。
用途 usage
图像组件具有自适应图像选择和响应式行为,页面访客可以延迟加载,内容作者可以轻松放置图像。
内容作者可使用“编辑”对话框编辑图像资源,如应用裁切或旋转图像。
模板作者可以在“设计”对话框中定义图像宽度以及其他设置。内容编辑者可以在“配置”对话框中上传或选择资源。
版本和兼容性 version-and-compatibility
图像组件的当前版本是 v3,此版本随 2022 年 2 月的核心组件发行版 2.18.0 的发布引入,具体说明见本文。
下表详述所有支持的组件版本、组件版本与其兼容的 AEM 版本以及旧版文档的链接。
有关核心组件版本的更多信息,请参阅文档核心组件版本。
响应式功能 responsive-features
图像组件提供了可靠的响应式功能,可以直接使用。在页面模板级别,可以使用“设计”对话框来定义图像资源的默认宽度。图像组件根据浏览器窗口的大小,自动加载适合显示的宽度。在窗口调整大小时,图像组件即时动态加载正确的图像大小。组件开发人员无需担心自定义媒体查询的定义方式,因为图像组件已经针对加载内容进行了优化。
此外,图像组件支持延迟加载,可以将实际图像资源的加载推迟到在浏览器中可见时,从而提升了页面的响应能力。
Dynamic Media 支持 dynamic-media
图像组件(截止 发行版本 2.13.0)支持 Dynamic Media 资源。在启用时,这些功能提供了一种能力,即通过简单的拖放功能或者通过资源浏览器,就可以像对任何其他图像一样加载 Dynamic Media 图像资源。此外还支持图像修饰符、图像预设和智能裁切。
使用核心组件构建的 Web 体验现在具备丰富、支持 Sensei、可靠、高性能、跨平台的 Dynamic Media 图像功能。
远程资产支持 remote-assets
图像组件(截止 发行版本 2.23.2)支持远程资产。配置后, 您可以从远程服务中为您的图像组件选择资产。
SVG 支持 svg-support
图像组件支持可缩放矢量图 (SVG)。
- 支持从 DAM 拖放 SVG 资源以及从本地文件系统上传 SVG 文件。
- 对原始 SVG 文件进行流式处理(跳过转换)。
- 对于 SVG 图像,“智能图像”和“智能大小”均设置为图像模型中的空数组。
安全性 security
为安全起见,图像编辑器从不直接调用原始 SVG。通过 <img src="path-to-component">
调用它。这可以防止浏览器执行在 SVG 文件中嵌入的任何脚本。
示例组件输出 sample-component-output
要体验图像组件并查看其配置选项以及 HTML 和 JSON 输出的示例,请访问组件库。
技术详细信息 technical-details
在 GitHub 上可找到有关图像组件的最新技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
图像组件支持 schema.org 微数据。
“编辑”对话框 edit-dialog
利用“编辑”对话框,内容作者可以裁切和缩放图像。
根据是否启用了 Dynamic Media 或 远程资产支持 功能,对于编辑图像可用的选项有所不同。
编辑标准资源 standard-assets
如果编辑标准 AEM 资源,可在图像组件的上下文菜单中单击 编辑 图标。
-
开始裁切
选择此选项将打开一个预定义裁切比例的下拉菜单。
- 选择 删除裁切 可显示原始资源。
选择一个裁切选项后,可使用蓝色手柄调整图像上的裁切大小。
-
向右旋转
使用此选项可将图像向右(顺时针)旋转 90°。
-
重置缩放
如果图像已缩放,使用此选项可重置缩放级别。
-
打开缩放滑块
使用此选项可显示用于控制图像的缩放级别的滑块。
就地编辑器也可以用于修改图像。由于有空间限制,因此仅将基本选项排成一行。对于完整的编辑选项,请使用全屏模式。
编辑 Dynamic Media 资源 dynamic-media-assets
如果启用了 Dynamic Media 功能,则必须在资源控制台中执行对图像本身的编辑。
“配置”对话框 configure-dialog
图像组件提供了一个“配置”对话框,其中定义了图像本身及其描述和基本属性。
“资源”选项卡 asset-tab
-
从页面继承精选图像 – 此选项使用链接页面的精选图像或当前页面的精选图像(如果未链接图像)。
-
图像资源 - 如果选中了 从页面继承特色图像,则自动填充此项。取消选中可通过设置以下选项而手动定义图像。
-
用于辅助功能的替换文本 – 此字段允许您为视障用户定义图像的描述。
- 从页面继承替换文本 – 此选项使用 DAM 中
dc:description
元数据的链接资源值的替代描述或当前页面的替代描述(如果未链接资源)。
- 从页面继承替换文本 – 此选项使用 DAM 中
-
不提供替换文本 - 标出图像,以使其在图像纯粹起装饰作用或以其他方式不向页面传达额外信息的情况下被屏幕阅读器等辅助技术忽略。
“元数据”选项卡 metadata-tab
-
预设类型 – 这定义了可用图像预设的类型,可以是 图像预设 或 智能裁切,并且仅在启用了 Dynamic Media 功能的情况下可用。
- 图像预设 - 选中了 图像预设 的 预设类型 时,下拉菜单 图像预设 可用,并允许从可用的 Dynamic Media 预设中选择。 此项只有在为所选资源定义了预设时才可用。
- 智能裁剪 - 选中 智能裁剪 的 预设类型 时,将有 演绎版 下拉菜单可用,可从中选择所选资源的可用演绎版。只有为所选资源定义了演绎版,才有此项可用。
- 图像修饰符 – 在这里可以定义其他 Dynamic Media 图像服务命令,不论选择了什么 预设类型,都使用
&
分隔。
-
题注 – 有关图像的附加信息,默认显示在图像的下方。
- 从 DAM 获取题注 - 选中此项时,为图像的题注文本填入 DAM 中
dc:title
元数据的值。 - 以弹出窗口显示题注 - 选中此项后,将光标悬停在图像上方时,并不在图像下方显示题注,而是被某些浏览器显示为弹出窗口。
- 从 DAM 获取题注 - 选中此项时,为图像的题注文本填入 DAM 中
-
链接 – 将图像链接到其他资源。
- 使用“选择”对话框可链接到其他 AEM 资源。
- 如果未链接到 AEM 资源,请输入绝对 URL。无法解析的 URL 被解释为相对于 AEM。
- 在新标签页中打开链接 - 此选项在新浏览器窗口中打开链接。
-
ID - 通过此选项,可控制组件在 HTML 和数据层中的唯一标识符。
- 如果留空,则自动为您生成一个唯一 ID,通过检查所得页面即可找到该 ID。
- 如果指定一个 ID,作者有责任确保它是唯一的。
- 更改 ID 可能会影响 CSS、JS 和数据层跟踪。
“样式”选项卡 styles-tab-edit
图像组件支持 AEM 样式系统。
使用下拉菜单选择要应用于该组件的样式。在“编辑”对话框中所做的选择与从组件工具栏中选择的操作效果相同。
必须在“设计”对话框中为此组件配置样式,以便有下拉菜单可用。
“设计”对话框 design-dialog
主选项卡 main-tab
-
启用 DM 功能 – 在选中时,Dynamic Media 功能可用。
- 仅当环境中启用了 Dynamic Media 时,才会出现此选项。
-
启用 Web 优化图像 - 选中此项后,Web 优化图像投放服务以 WebP 格式投放图像,使图像大小平均减小 25%。
- 仅在 AEMaaCS 中有此选项可用。
- 当未选中此项或 Web 优化图像投放服务不可用时,将使用自适应图像 Servlet。
-
禁用延迟加载 - 选中此项后,组件预先加载所有图像而不延迟加载。
-
图像是装饰性的 – 定义在将图像组件添加到页面时,是否自动启用装饰性图像选项。
-
从 DAM 获取替换文本 – 定义在将图像组件添加到页面时,是否自动启用从 DAM 检索替换文本的选项。
-
从 DAM 获取题注 – 定义在将图像组件添加到页面时,是否自动启用从 DAM 检索题注的选项。
-
以弹出窗口显示题注 – 定义在将图像组件添加到页面时,是否自动启用以弹出窗口显示图像题注的选项。
-
调整宽度 – 此值用于调整作为 DAM 资源的基本图像的宽度。
- 保留图像的纵横比。
- 如果此值大于图像的实际宽度,则此值无效。
- 此值不影响 SVG 图像。
可为图像定义以像素为单位的宽度的列表,而组件根据浏览器大小自动加载最合适的宽度。这是图像组件的响应式功能的重要组成部分。
-
宽度 – 定义图像的宽度(以像素为单位),组件将根据浏览器的大小自动加载最合适的宽度。
-
点按或单击 “添加” 按钮可添加其他大小。
- 使用抓取手柄重新排列大小顺序。
- 使用 “删除” 图标可删除宽度。
-
默认情况下,图像加载会被延迟,直到图像变得可见。
- 选择 禁用延迟加载 选项,以使您可在加载页面时加载图像。
-
-
JPEG 质量 - 转换(例如,缩放或裁剪)的 JPEG 图像的质量系数(以从 0 到 100 的百分比表示)。
样式选项卡 styles-tab
图像组件支持 AEM 样式系统。
Adobe 客户端数据层 data-layer
图像组件支持 Adobe 客户端数据层。