AEM Cloud Sites:正文内容未在media-module组件中渲染
本文介绍如何解决AEM Cloud Sites上最终用户无法正确呈现Media-module组件中的正文内容的问题,即使内容在其他环境中按预期显示也是如此。
描述 description
环境
Adobe Experience Manager (AEM) Cloud Sites(所有版本)
症状
- 在已发布页面上的媒体模块组件中,最终用户缺少正文(RTE)内容或无法正确呈现内容。
- 与其他AEM Cloud Sites环境(例如创作和预览)中预期显示的内容相同。
- 该问题对于所有用户均可重现,且不是特定于帐户的。
- 在受影响的页面中,只有专家标题或其他字段会呈现在正文容器中,而编写的个人简介或正文段落不可见。
- 查看页面源可确认投放源中存在内容,但为最终用户呈现的DOM会忽略预期的主体内容。
原因
此问题是由于media-module.js组件使用硬编码的行索引(例如: rows[ 8])作为主体(RTE)内容的回退而导致的,此时已发布的标记中缺少通用编辑器字段标记。 如果行顺序更改或与预期的结构不匹配,则会呈现错误的内容(如专家标题)来代替正文内容。
解决方法 resolution
请按照以下步骤解决问题:
- 查看
media-module.js组件的实施,特别是负责选择要呈现为正文(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