下载组件 download-component
利用核心组件下载组件,可在页面上创建下载选项。
用途 usage
利用核心组件下载组件,可在页面上包括下载选项及其关联的资源。
版本和兼容性 version-and-compatibility
下载组件的当前版本是 v2,此版本随 2022 年 2 月的核心组件发行版 2.18.0 的发布引入,具体说明见本文。
下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。
有关核心组件版本的更多信息,请参阅文档核心组件版本。
示例组件输出 sample-component-output
要体验下载组件并查看其配置选项示例以及 HTML 和 JSON 输出,请访问组件库。
技术详细信息 technical-details
在 GitHub 上可找到有关下载组件的最新技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
“配置”对话框 configure-dialog
利用“配置”对话框,内容作者可以定义下载项目,以及对于页面的访客它会如何表现和显示。
“资源”选项卡 asset-tab
下载资源的选择与图像组件非常相似,同样利用了 AEM 的 DAM。
“属性”选项卡 properties-tab
-
标题 - 为下载项目的显示标题
- 从 DAM 资源获取标题 - 在选中时,使用 DAM 资源的标题自动填充标题。
-
描述 - 显示为下载项目的描述性子标题
- 从 DAM 资源获取描述 - 在选中时,使用 DAM 资源的描述自动填充描述。
-
操作文本 - 为下载项目显示的操作文本
- 从文件系统上传资源时,此字段必填。
- 显示内联 - 选中时,提供的 操作文本 将显示内联。
-
ID - 利用此选项,可以控制 HTML 和 Data Layer 中的组件的唯一标识符。
- 如果留空,系统会自动为您生成一个唯一 ID,可以通过检查结果页面找到该 ID。
- 如果指定一个 ID,作者有责任确保它是唯一的。
- 更改此 ID 会对 CSS、JS 和数据层跟踪产生影响。
“样式”选项卡 styles-tab-edit
下载组件支持 AEM 样式系统。
使用下拉菜单选择要应用于该组件的样式。在“编辑”对话框中所做的选择与从组件工具栏中选择的操作效果相同。
必须在“设计”对话框中为此组件配置样式,以便下拉菜单可用。
“设计”对话框 design-dialog
使用“设计”对话框,模板作者可以定义哪些选项可供使用下载组件的内容作者使用。
“属性”选项卡 properties-tab-design
- 允许从文件系统上传资源 - 允许内容作者从其本地文件系统上传资源作为下载资源。
- 默认值为未选中。
- 标题类型 - 为下载组件的标题使用的 HTML 元素。
- 如果未选中值,则默认值为 H3。
- 显示文件大小 - 在选中时,资源的文件大小将显示在下载组件中。
- 默认值为选中。
- 显示文件格式 - 在选中时,资源的文件格式将显示在下载组件中。
- 默认值为选中。
- 显示文件名 - 在选中时,资源的文件名将显示在下载组件中。
- 默认值为选中。
“样式”选项卡 styles-tab
图像组件支持 AEM 样式系统。
recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c