下載元件 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 和資料層中元件的唯一識別碼。
- 如果留空,則會自動產生唯一識別碼,您可以透過檢查得出的頁面找到該 ID。
- 若已指定 ID,則作者應確保其為唯一識別碼。
- 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。
樣式索引標籤 styles-tab-edit
下載元件支援 AEM 樣式系統。
使用下拉式清單,選取想要套用至元件的樣式。在編輯對話框中所做的選取,與從元件工具列中選擇具有相同效果。
元件樣式必須在設計對話框中設定,才能使用該下拉式清單。
設計對話框 design-dialog
透過設計對話框,範本作者可為使用下載元件的內容作者定義可用選項。
屬性索引標籤 properties-tab-design
- 允許從檔案系統上傳 - 允許內容作者從其本機檔案系統上傳資產作為下載資產。
- 預設值為未選取。
- 標題類型 - HTML 元素用作下載元件標題。
- 如果未選取任何值,預設值為 H3。
- 顯示檔案大小 - 選取後,資產的檔案大小將顯示在下載元件中。
- 預設值已選取。
- 顯示檔案格式 - 選取後,資產的檔案格式將顯示在下載元件中。
- 預設值已選取。
- 顯示檔案名稱 - 選取後,資產的檔案名稱將顯示在下載元件中。
- 預設值已選取。
樣式索引標籤 styles-tab
影像元件支援 AEM 樣式系統。