Magento2 分类描述WYSIWYG编辑器在非默认商店视图下的显示问题解析

问题现象

在Magento 2.4.7版本中，当管理员在后台编辑非默认商店视图下的分类时，如果取消勾选"使用默认值"选项并在WYSIWYG编辑器中输入描述内容后保存，再次加载编辑页面时编辑器内容会显示为空。

问题根源

这个问题源于dom-observer.js文件中的一个逻辑变更。在之前的版本中，相关代码使用_.each函数进行循环处理，而在5b931fe这次提交中，代码被修改为直接使用循环结构。关键变化在于：

原代码中循环内的break语句位于_函数内部，而修改后它直接位于主循环体中。这导致当条件不满足时循环会提前终止，而不是继续检查其他监听器。

技术分析

dom-observer.js文件负责处理DOM元素的观察和事件监听。在分类描述的WYSIWYG编辑器场景中，该文件用于管理编辑器内容的加载和显示。当代码提前跳出循环时，会导致部分必要的监听器没有被正确设置，从而造成内容无法正常显示。

解决方案

修复方案很简单：将循环中的break语句改为continue语句。这样当条件不满足时，循环会继续检查下一个监听器而不是完全终止。

_.each(watchers.selectors, function (listeners, selector) {
    for (let data of listeners) {
        if (!data.ctx.contains(node) || !$(node, data.ctx).is(selector)) {
            continue;  // 修改这里
        }
        // 其余处理逻辑
    }
});

影响范围

该问题影响所有使用WYSIWYG编辑器且需要多商店视图支持的功能，特别是：

• 分类描述
• CMS页面内容
• 产品描述等富文本编辑区域

临时解决方案

对于无法立即升级系统的用户，可以手动应用上述补丁来临时解决问题。修改后需要清除缓存并重新部署静态内容。

版本兼容性

虽然问题最初在2.4.7版本中发现，但类似的代码结构可能影响其他版本。建议所有使用多商店视图功能的项目都检查是否存在此问题。

最佳实践

在处理类似DOM观察和事件监听的代码时，开发人员应当：

1. 仔细考虑循环控制语句的影响范围
2. 充分测试多语言/多商店场景
3. 确保修改不会破坏原有的事件监听链

这个问题提醒我们在重构代码时，即使是看似简单的循环结构变化，也可能带来意想不到的副作用，特别是在处理复杂的DOM操作和事件监听时。