下载组件

利用核心组件下载组件,可在页面上创建下载选项。

用途

利用核心组件下载组件,可在页面上包括下载选项及其关联的资源。

版本和兼容性

下载组件的当前版本是 V1,此版本随 2019 年 6 月的核心组件发行版本 2.5.0 的发布引入,具体说明见本文。

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

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

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

示例组件输出

要体验下载组件并查看其配置选项示例以及 HTML 和 JSON 输出,请访问组件库

技术详细信息

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

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

“配置”对话框

利用“配置”对话框,内容作者可以定义下载项目,以及对于页面的访客它会如何表现和显示。

下载组件“编辑”对话框的“资源”选项卡

“资源”选项卡

下载资源的选择与图像组件非常相似,同样利用了 AEM 的 DAM。

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

“属性”选项卡

下载组件“编辑”对话框的“属性”选项卡

  • 标题 - 为下载项目的显示标题
    • 从 DAM 资源获取标题 - 在选中时,使用 DAM 资源的标题自动填充标题。
  • 描述 - 显示为下载项目的描述性子标题
    • 从 DAM 资源获取描述 - 在选中时,使用 DAM 资源的描述自动填充描述。
  • 操作文本 - 为下载项目显示的操作文本
    • 从文件系统上传资源时,此字段必填。
    • 显示内联 - 选中时,提供的​操作文本​将显示内联。
  • ID - 利用此选项,可以控制 HTML 和 Data Layer 中的组件的唯一标识符。
    • 如果留空,系统会自动为您生成一个唯一 ID,可以通过检查结果页面找到该 ID。
    • 如果指定一个 ID,作者有责任确保它是唯一的。
    • 更改此 ID 会对 CSS、JS 和 Data Layer 跟踪产生影响。

“设计”对话框

使用“设计”对话框,模板作者可以定义哪些选项可供使用下载组件的内容作者使用。

“属性”选项卡

下载组件“设计”对话框

  • 允许从文件系统上传资源 - 允许内容作者从其本地文件系统上传资源作为下载资源。
    • 默认值为未选中。
  • 标题类型 - 为下载组件的标题使用的 HTML 元素。
    • 如果未选中值,则默认值为 H3。
  • 显示文件大小 - 在选中时,资源的文件大小将显示在下载组件中。
    • 默认值为选中。
  • 显示文件格式 - 在选中时,资源的文件格式将显示在下载组件中。
    • 默认值为选中。
  • 显示文件名 - 在选中时,资源的文件名将显示在下载组件中。
    • 默认值为选中。

“样式”选项卡

图像组件支持 AEM 样式系统

在此页面上