影像元件(v2) image-component
核心元件影像元件是自我調整影像元件,具備就地編輯的功能。
使用狀況 usage
影像元件提供最適化影像選擇和回應式行為,頁面訪客可延遲載入,內容作者可輕鬆放置和裁切影像。
範本作者可以在中定義影像寬度、裁切以及其他設定。 設計對話方塊. 內容編輯者可以上傳或選取 設定對話方塊 並裁切影像 編輯對話方塊. 為了增加便利性,您也可以使用簡單的影像就地修改。
版本和相容性 version-and-compatibility
本檔案說明影像元件v2,此版本隨2018年1月的核心元件發行版本2.0.0的發佈引入。
回應式功能 responsive-features
影像元件隨附強大的回應式功能,立即可用。 在頁面範本層級, 設計對話方塊 可用來定義影像資產的預設寬度。 然後,影像元件會自動載入正確的寬度,以根據瀏覽器視窗的大小來顯示。 視窗調整大小時,影像元件會即時動態載入正確的影像大小。 元件開發人員無需擔心自訂媒體查詢的定義方式,因為影像元件已最佳化以載入您的內容。
此外,影像元件支援延遲載入,將實際影像資產的載入延遲到顯示在瀏覽器中時,以提高頁面的回應速度。
Dynamic Media支援 dynamic-media
影像元件(截至 版本2.13.0)支援 Dynamic Media 資產。 啟用時, 這些功能可讓您透過簡單的拖放功能或透過資產瀏覽器,像新增任何其他影像一樣新增Dynamic Media影像資產。 此外,也支援影像修飾元、影像預設集和智慧型裁切。
使用核心元件建立的網頁體驗無法具備豐富、Sensei支援、健全、高效能、跨平台的Dynamic Media影像功能。
SVG支援 svg-support
影像元件支援可縮放的向量圖形(SVG)。
- 支援從DAM拖放SVG資產以及從本機檔案系統上傳SVG檔案。
- 將原始SVG檔案串流(跳過轉換)。
- 對於SVG影像,「智慧型影像」和「智慧型大小」會設定為影像模型中的空陣列。
安全性 security
基於安全考量,影像編輯器絕對不會直接呼叫原始SVG。 會透過呼叫 <img src=“path-to-component”>
. 這可防止瀏覽器執行SVG檔案中內嵌的任何指令碼。
範例元件輸出 sample-component-output
若要體驗影像元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.
技術細節 technical-details
有關影像元件的最新技術檔案 可在GitHub上找到.
有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.
影像元件支援 schema.org microdata.
設定對話方塊 configure-dialog
除了標準 編輯對話方塊 和 設計對話方塊,影像元件會提供「設定」對話方塊,其中會定義影像本身及其說明和基本屬性。
資產標籤 asset-tab
中繼資料標籤 metadata-tab
-
預設集型別 — 這定義了可用的影像預設集型別,可以 影像預設集 或 智慧型裁切、和僅在以下情況下可用: Dynamic Media功能 已啟用。
- 影像預設集 — 時間 預設集型別 之 影像預設集 已選取,下拉式選單 影像預設集 可使用,並允許從可用的Dynamic Media預設集中選擇。 只有在為選取的資產定義了預設集時,才能使用此選項。
- 智慧型裁切 — 時間 預設集型別 之 智慧型裁切 在下拉式選單中選取 轉譯 可使用,並允許從所選資產的可用轉譯中進行選擇。 這只有在為選取的資產定義了轉譯時才可用。
- 影像修飾元 — 您可在這裡定義其他Dynamic Media影像伺服命令,區隔為
&
,無論哪一個 預設集型別 「 」已選取。
-
裝飾性影像 — 檢查輔助技術是否應忽略影像,因此不需要替代文字。 這僅適用於裝飾性影像。
-
替代文字 — 影像含義或功能的替代文字,適用於視障讀者。
- 從DAM取得替代文字 — 勾選後,影像的替代文字將會填入
dc:description
dam中的中繼資料。
- 從DAM取得替代文字 — 勾選後,影像的替代文字將會填入
-
註解 — 影像的其他相關資訊,預設會顯示於影像下方。
- 從DAM取得圖片說明 — 勾選後,影像的註解文字將會填入
dc:title
dam中的中繼資料。 - 以快顯視窗顯示註解 — 檢查完畢後,註解不會顯示在影像下方,但如在某些瀏覽器中將滑鼠懸停在影像上,註解會以快顯模式顯示。
- 從DAM取得圖片說明 — 勾選後,影像的註解文字將會填入
-
連結 — 將影像連結至其他資源。
- 使用選取對話方塊來連結至其他AEM資源。
- 如果未連結至AEM資源,請輸入絕對URL。 非解決方案URL將解譯為相對於AEM。
-
ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.
- 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
- 若指定ID,作者應負責確認該ID是唯一的。
- 變更ID會對CSS、JS和資料層追蹤造成影響。
編輯對話方塊 edit-dialog
內容作者可以使用「編輯」對話方塊裁切、修改啟動地圖及縮放影像。
-
開始裁切
選取此選項會開啟預先定義裁切比例的下拉式清單。
- 選擇選項 手繪 以定義您自己的裁切。
- 選擇選項 移除裁切 以顯示原始資產。
選取裁切選項後,請使用藍色控點來調整影像上的裁切大小。
-
向右旋轉
使用此選項可將影像向右(順時針)旋轉90°。
-
水準翻轉
使用此選項可水準翻轉影像或沿y軸將影像旋轉180°。
-
垂直翻轉
使用此選項可垂直翻轉影像或沿x軸將影像旋轉180°。
-
重設縮放
如果影像已經縮放,請使用此選項來重設縮放等級。
-
開啟縮放滑桿
使用此選項可顯示控制影像縮放等級的滑桿。
就地編輯器也可用來修改影像。 由於空間限制,僅基本選項內嵌提供。 如需完整編輯選項,請使用全熒幕模式。
設計對話方塊 design-dialog
「設計」對話方塊可讓範本作者定義內容作者在使用此元件時的裁切、上傳、輪換和上傳選項。
主要標籤 main-tab
於 主要 索引標籤您可以定義影像的寬度(以畫素為單位),元件會根據瀏覽器大小自動載入最適合的寬度。 這是 回應式功能 影像元件的。
此外,您可以定義在作者將元件新增至頁面時,會自動或停用哪些一般元件選項。
-
啟用DM功能 — 選取時,啟用 Dynamic Media功能 可用。
-
啟用Web最佳化的影像 — 若勾選, 網頁最佳化的影像傳遞服務 將以WebP格式傳送影像,平均將影像大小減少25%。
- 此選項僅適用於AEMaaCS。
- 取消勾選或Web最佳化的影像傳送服務無法使用時, 最適化影像Servlet 已使用。
-
啟用延遲載入 — 定義將影像元件新增至頁面時,是否自動啟用延遲載入選項。
-
裝飾性影像 — 定義將影像元件新增至頁面時,是否自動啟用裝飾性影像選項。
-
從DAM取得替代文字 — 定義將影像元件新增至頁面時,是否自動啟用從DAM擷取替代文字的選項。
-
從DAM取得圖片說明 — 定義將影像元件新增至頁面時,是否自動啟用從DAM擷取註解的選項。
-
以快顯視窗顯示註解 — 定義將影像元件新增至頁面時,是否自動啟用以快顯視窗顯示影像註解的選項。
-
停用UUID追蹤 — 勾選以停用影像資產的UUID追蹤。
-
寬度 — 定義影像的寬度(以畫素為單位),元件會根據瀏覽器大小自動載入最適合的寬度。
-
點選或按一下 新增 按鈕以新增其他大小。
- 使用抓取控點來重新排列大小。
- 使用 刪除 圖示可移除寬度。
-
依預設,影像載入會延遲到它們變成可見為止。
- 選取選項 停用延遲載入 以在頁面載入時載入影像。
-
-
JPEG品質 — 轉換(例如縮放或裁切)的JPEG影像的品質因數(以從0到100的百分比表示)。
功能標籤 features-tab
於 功能 索引標籤您可以定義在使用元件時內容作者可用的選項,包括上傳選項、方向和裁切選項。
-
來源
選取選項 允許從檔案系統上傳資產 允許內容作者從其本機電腦上傳影像。 若要強制內容作者僅從AEM中選取資產,請取消選取此選項。
-
方向
-
旋轉
使用此選項可允許內容作者使用
向右旋轉 選項。 -
翻轉
使用此選項可允許內容作者使用
水準翻轉 和 垂直翻轉 選項。note caution CAUTION 此 翻轉 選項預設為停用。 啟用時將會顯示 垂直翻轉 和 水準翻轉 按鈕,但AEM目前不支援此功能,且不會保留使用這些選項所做的任何變更。 -
裁切
選取選項 允許裁切 讓內容作者在「編輯」對話方塊中裁切元件中的影像。
- 按一下 新增 以新增預先定義的裁切外觀比例。
- 輸入描述性名稱,該名稱將顯示在 開始裁切 下拉式清單。
- 輸入外觀的數字比例。
- 使用拖曳操作框來重新排列長寬比
- 使用垃圾桶圖示可刪除長寬比。
note caution CAUTION 請注意,在AEM中,裁切比例定義為 高度/寬度. 這與傳統的寬度/高度定義不同,這樣做是出於舊版相容性的原因。 只要您提供明確的比率名稱,內容作者就不會察覺到任何差異,因為該名稱顯示在UI中,而不是比率本身。
樣式索引標籤 styles-tab-1
影像元件支援AEM 樣式系統.
Adobe使用者端資料層 data-layer
影像元件支援 Adobe使用者端資料層。