下載元件 download-component

核心元件下載元件允許在頁面上建立下載選項。

TIP
您是否考慮過適用於 AEM 的 Edge Delivery Services?
現有的專案可以繼續使用本文件中所述的方法。然而,針對新專案,Adobe 建議採用 Edge Delivery Services。

用途 usage

核心元件下載元件允許在頁面上包含下載選項及其相關資產。

版本和相容性 version-and-compatibility

下載元件的目前版本為 v2,此版本於 2022 年 2 月隨著核心元件 2.18.0 版發行導入,詳情請參閱本文件。

下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本,以及舊版文件的連結。

元件版本
AEM 6.4
AEM 6.5
AEM 6.5 LTS
AEM as a Cloud Service
v2
-
相容
相容
相容
v1
相容
相容
-
相容

如需核心元件版本和發行版本的進一步詳細資訊,請參閱核心元件版本文件。

範例元件輸出 sample-component-output

若要體驗「下載元件」,並檢視其設定選項及 HTML 和 JSON 輸出的範例,請造訪「元件庫」。

技術詳細資訊 technical-details

在 GitHub 上可找到有關下載元件的最新技術文件。

如需開發「核心元件」的進一步詳細資訊,請參閱核心元件開發人員文件

設定對話框 configure-dialog

設定對話框可讓內容作者定義下載項目,以及其對頁面訪客的行為與顯示方式。

下載元件編輯對話框的資產索引標籤

資產索引標籤 asset-tab

下載資產的選取與影像元件的功能非常類似,也同樣運用 AEM 的 DAM。

  • 下載資產

    • 資產瀏覽器拖曳資產,或點選​ 瀏覽 ​選項,以從本機檔案系統上傳。
    • 點選或按一下​ 「清除」,取消選取目前選取的影像。
    • 點選或按一下​ 編輯,以在 Asset Editor 中管理資產的轉譯

屬性索引標籤 properties-tab

下載元件編輯對話框的屬性索引標籤

  • 標題 - 顯示為下載項目標題

    • 從 DAM 資產取得標題 - 選取後,標題會自動填入 DAM 資產的標題。
  • 說明 - 顯示為下載項目的說明性副標題

    • 從 DAM 資產取得說明 - 選取後,說明會自動填入 DAM 資產的說明。
  • 動作文字 - 顯示為下載項目的動作文字

    • 從檔案系統上傳資產時,此欄位為必填欄位。
    • 顯示內嵌 - 選取後,提供的​ 動作文字 ​將顯示內嵌。
  • ID - 此選項可讓您控制 HTML 和資料層中元件的唯一識別碼。

    • 如果留空,則會自動產生唯一識別碼,您可以透過檢查得出的頁面找到該 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