影像元件

核心元件影像元件是自我調整影像元件。

使用狀況

影像元件提供最適化影像選擇和回應式行為,頁面訪客可延遲載入,內容作者可輕鬆放置影像。

範本作者可以在下列位置定義影像寬度和其他設定: 設計對話方塊. 內容編輯者可以上傳或選取 設定對話方塊。

版本和相容性

影像元件的目前版本是v3,此版本隨2022年2月的核心元件2.18.0版的發佈引入,具體說明見本文。

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

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

如需核心元件版本和發行版本的詳細資訊,請參閱檔案 核心元件版本.

回應式功能

影像元件隨附強大的回應式功能,立即可用。 在頁面範本層級, 設計對話方塊 可用來定義影像資產的預設寬度。 然後,影像元件會自動載入正確的寬度,以根據瀏覽器視窗的大小來顯示。 視窗調整大小時,影像元件會即時動態載入正確的影像大小。 元件開發人員無需擔心自訂媒體查詢的定義方式,因為影像元件已最佳化以載入您的內容。

此外,影像元件支援延遲載入,將實際影像資產的載入延遲到顯示在瀏覽器中時,以提高頁面的回應速度。

秘訣

依預設,影像元件由最適化影像Servlet提供技術支援。 請參閱檔案 最適化影像Servlet 瞭解其運作方式的詳細資訊。

Dynamic Media支援

影像元件(截至 版本2.13.0)支援 Dynamic Media 資產。 啟用時, 這些功能可讓您透過簡單的拖放功能或透過資產瀏覽器,像新增任何其他影像一樣新增Dynamic Media影像資產。 此外,也支援影像修飾元、影像預設集和智慧型裁切。

使用核心元件建立的網頁體驗可包含豐富、Sensei支援、健全、高效能、跨平台的Dynamic Media影像功能。

SVG支援

影像元件支援可縮放的向量圖形(SVG)。

  • 支援從DAM拖放SVG資產以及從本機檔案系統上傳SVG檔案。
  • 將原始SVG檔案串流(跳過轉換)。
  • 對於SVG影像,「智慧型影像」和「智慧型大小」會設定為影像模型中的空陣列。

安全性

基於安全考量,影像編輯器絕對不會直接呼叫原始SVG。 會透過呼叫 <img src=“path-to-component”>. 這可防止瀏覽器執行SVG檔案中內嵌的任何指令碼。

範例元件輸出

若要體驗影像元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.

技術細節

有關影像元件的最新技術檔案 可在GitHub上找到.

有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.

影像元件支援 schema.org microdata.

設定對話方塊

影像元件提供設定對話方塊,其中定義了影像本身及其說明和基本屬性。

資產標籤

影像元件「設定」對話方塊的「資產」標籤

  • 從頁面繼承精選影像 — 此選項使用 連結頁面的精選影像 或目前頁面的精選影像(如果未連結影像)。

  • 協助工具的替代文字 — 此欄位可讓您為視障使用者定義影像說明。

    • 從頁面繼承替代文字 — 此選項使用連結資產值的替代說明, dc:description DAM中的中繼資料,或目前頁面的中繼資料(若未連結資產)。
  • 影像資產

    • 從拖放資產 資產瀏覽器 或點選 瀏覽 從本機檔案系統上傳的選項。
    • 點選或按一下 清除 以取消選取目前選取的影像。
    • 點選或按一下 編輯管理資產的轉譯 在資產編輯器中。
  • 不提供替代文字 — 此選項會針對影像純粹起裝飾作用或不向頁面傳達額外資訊的情況,將影像標籤為被熒幕閱讀器等輔助技術忽略。

中繼資料標籤

影像元件「設定」對話方塊的「中繼資料」標籤

  • 預設集型別 — 這定義了可用的影像預設集型別,可以 影像預設集智慧型裁切、和僅在以下情況下可用: Dynamic Media功能 已啟用。
    • 影像預設集 — 時間 預設集型別影像預設集 已選取,下拉式選單 影像預設集 可使用,並允許從可用的Dynamic Media預設集中選擇。 只有在為選取的資產定義了預設集時,才能使用此選項。
    • 智慧型裁切 — 時間 預設集型別智慧型裁切 在下拉式選單中選取 轉譯 可使用,並允許從所選資產的可用轉譯中進行選擇。 這只有在為選取的資產定義了轉譯時才可用。
    • 影像修飾元 — 您可在這裡定義其他Dynamic Media影像伺服命令,區隔為 &,無論哪一個 預設集型別 「 」已選取。
  • 註解 — 影像的其他相關資訊,預設會顯示於影像下方。
    • 從DAM取得圖片說明 — 勾選後,影像的註解文字將會填入 dc:title dam中的中繼資料。
    • 以快顯視窗顯示註解 — 檢查完畢後,註解不會顯示在影像下方,但如在某些瀏覽器中將滑鼠懸停在影像上,註解會以快顯模式顯示。
  • 連結 — 將影像連結至其他資源。
    • 使用選取對話方塊來連結至其他AEM資源。
    • 如果未連結至AEM資源,請輸入絕對URL。 非解決方案URL將解譯為相對於AEM。
    • 在新標籤中開啟連結 — 此選項會在新的瀏覽器視窗中開啟連結。
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.
    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。
秘訣

智慧型裁切影像預設集 是互斥選項。 如果作者需要使用影像預設集以及智慧型裁切轉譯,該作者必須使用 影像修飾元 以手動新增預設集。

樣式索引標籤

影像元件「編輯」對話方塊的「樣式」索引標籤

影像元件支援AEM 樣式系統。.

使用下拉式清單,選取要套用至元件的樣式。 在「編輯」對話方塊中所做的選取與從元件工具列中選擇的效果相同。

必須在以下位置為此元件設定樣式: 設計對話方塊 讓下拉式功能表可供使用。

設計對話方塊

主要標籤

影像元件的「設計」對話方塊主索引標籤

  • 啟用DM功能 — 檢查時, Dynamic Media功能 可用。
    • 此選項僅在環境中啟用Dynamic Media時顯示。
  • 啟用Web最佳化的影像 — 檢查時, 網頁最佳化的影像傳遞服務 將以WebP格式傳送影像,平均將影像大小減少25%。
    • 此選項僅適用於AEMaaCS。
    • 取消勾選或Web最佳化的影像傳送服務無法使用時, 最適化影像Servlet 已使用。
  • 停用延遲載入 — 選取後,元件會預先載入所有影像而不會延遲載入。
  • 裝飾性影像 — 定義將影像元件新增至頁面時,是否自動啟用裝飾性影像選項。
  • 從DAM取得替代文字 — 定義將影像元件新增至頁面時,是否自動啟用從DAM擷取替代文字的選項。
  • 從DAM取得圖片說明 — 定義將影像元件新增至頁面時,是否自動啟用從DAM擷取註解的選項。
  • 以快顯視窗顯示註解 — 定義將影像元件新增至頁面時,是否自動啟用以快顯視窗顯示影像註解的選項。
  • 調整寬度 — 此值用於調整作為DAM資產的基本影像的寬度。
    • 將會保留影像的外觀比例。
    • 如果該值大於影像的實際寬度,則該值無效。
    • 此值對SVG影像沒有影響。

您可以定義影像的寬度清單(以畫素為單位),元件會根據瀏覽器大小自動載入最適合的寬度。 這是 回應式功能 影像元件的。

  • 寬度 — 定義影像的寬度(以畫素為單位),元件會根據瀏覽器大小自動載入最適合的寬度。
    • 點選或按一下 新增 按鈕以新增其他大小。
      • 使用抓取控點來重新排列大小。
      • 使用 刪除 圖示可移除寬度。
    • 依預設,影像載入會延遲到它們變成可見為止。
      • 選取選項 停用延遲載入 以在頁面載入時載入影像。
  • JPEG品質 — 轉換(例如縮放或裁切)的JPEG影像的品質因數(以從0到100的百分比表示)。
秘訣

檢視檔案 最適化影像Servlet 提供透過仔細定義寬度來最佳化轉譯選擇的秘訣。

樣式索引標籤

影像元件支援AEM 樣式系統.

Adobe使用者端資料層

影像元件支援 Adobe使用者端資料層。

本頁內容