下载组件 (v1)

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

用途

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

• 在“配置”对话框中可选择下载选项的属性。
• 下载组件的默认值可在“设计”对话框中定义。

版本和兼容性

本文档介绍了下载组件 v1，此版本随 2019 年 6 月的核心组件发行版本 2.5.0 的发布引入。

示例组件输出

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

技术详细信息

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

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

“配置”对话框

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

“资源”选项卡

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

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

“属性”选项卡

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

“设计”对话框

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

“属性”选项卡

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

“样式”选项卡

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