AEM Cloud Sites:主體內容未呈現在媒體模組元件中
本文說明如何解決AEM Cloud Sites中,即使內容在其他環境中如預期般顯示,媒體模組元件中的內文內容無法正確呈現給使用者的問題。
說明 description
環境
Adobe Experience Manager (AEM) Cloud Sites (所有版本)
症狀
- 在已發佈頁面上的媒體模組元件中,一般使用者缺少內文(RTE)內容或內容無法正確呈現。
- 與其他AEM Cloud Sites環境(例如製作和預覽)中預期顯示的內容相同。
- 此問題可對所有使用者重複產生,且不是特定於帳戶的。
- 在受影響的頁面中,只有專家標題或其他欄位會呈現在內文容器中,而撰寫的傳記或內文段落不會顯示。
- 檢視頁面來源可確認內容存在於傳遞來源中,但使用者的轉譯DOM會忽略預期的內文內容。
原因
此問題是由於media-module.js元件使用硬式編碼的列索引(例如: rows[ 8])做為內文(RTE)內容的遞補內容時,所發佈的標籤中遺失通用編輯器欄位標籤所造成。 如果列順序變更或不符合預期的結構,則會轉譯錯誤的內容(例如專家標題)來取代內文內容。
解決方法 resolution
請依照下列步驟解決問題:
- 檢閱
media-module.js元件的實作,特別是負責選取要呈現為Body (RTE)內容之列的邏輯。 - 識別通用編輯器欄位標籤遺失時,遞補邏輯如何選取列。 例如,檢查它是否使用硬式編碼索引,例如
rows[ 8]。 - 決定您目前發佈之標籤中內文(RTE)內容的正確列索引。 例如,如果
rows[ 9]包含內文(RTE)內容,請更新遞補邏輯以選取rows[ 9]而非rows[ 8]。 - 或者,您可以考慮實作與位置無關的遞補機制,根據內容或結構來識別Body (RTE)列,而不是依賴固定的索引。 此方法可讓元件對於日後的列順序變更更具韌性。
- 在中繼環境中測試更新的邏輯。 使用瀏覽器開發人員工具來驗證
.media-module-rte容器中是否呈現了正確的內容。 - 驗證後,將更新的元件部署到生產環境。
- 監視受影響的頁面,以確定內文(RTE)內容現在可為一般使用者正確呈現。
相關閱讀
recommendation-more-help
experience-cloud-kcs-help-kbarticles