本文详细介绍了在cxjs应用中如何解决`onwheel`事件默认被动监听导致无法阻止默认行为的问题。通过利用`onref`属性获取dom元素引用，并结合`cx/util`库中的`addeventlistenerwithoptions`方法，开发者可以创建主动的滚轮事件监听器，从而有效地控制事件的默认行为，实现更精细的用户交互体验。
理解CxJS中滚轮事件的被动性
在现代Web开发中，为了优化页面滚动性能，浏览器和前端框架（如React，CxJS基于React）对某些事件（特别是wheel、touchstart、touchmove等）默认采取了“被动（passive）”监听模式。这意味着当这些事件被触发时，即使事件监听器中调用了e.preventDefault()方法，浏览器也可能不会阻止其默认行为，并且在被动监听器中尝试调用preventDefault()会抛出错误。
对于CxJS中的onWheel事件，它继承了React的这一特性，默认是一个被动事件监听器。因此，如果开发者尝试在onWheel回调函数中阻止默认的页面滚动行为，例如：
onWheelAction(e, {store}) {
e.preventDefault(); // 这里会抛出错误
// ...
}{/* ... */}
上述代码将导致e.preventDefault()无法执行，并可能在控制台输出“preventDefault cannot be done in the passive event listener”的错误信息。这对于需要自定义滚轮行为（如图片缩放、自定义滚动区域、拖拽辅助）的场景构成了障碍。
解决方案：利用onRef和addEventListenerWithOptions
为了在CxJS中实现主动的滚轮事件监听并能够成功阻止默认行为，我们需要绕过框架默认的被动监听机制，直接在DOM元素上添加一个非被动（active）的事件监听器。这可以通过以下两个CxJS特性和工具实现：
- onRef 属性： CxJS组件的onRef属性接受一个回调函数。当组件渲染并其DOM元素可用时，这个回调函数会被调用，并以该DOM元素的引用作为第一个参数。这为我们提供了直接操作底层DOM元素的机会。
- cx/util 中的 addEventListenerWithOptions 方法： CxJS提供了一个实用工具函数addEventListenerWithOptions，它允许我们以更精细的控制方式添加事件监听器，包括设置passive选项。
结合这两者，我们可以在组件挂载时获取到目标DOM元素的引用，然后使用addEventListenerWithOptions为其添加一个passive: false的滚轮事件监听器。
实现主动滚轮事件监听器
以下是具体的实现步骤和代码示例：
1. 导入必要的工具
首先，从cx/util中导入addEventListenerWithOptions。
import { addEventListenerWithOptions } from 'cx/util';2. 定义监听器管理方法
在CxJS组件的控制器（Controller）或组件定义中，创建一个方法来管理事件监听器的添加和清理。我们需要一个变量来存储addEventListenerWithOptions返回的取消订阅函数，以便在组件卸载或元素引用变化时进行清理，防止内存泄漏。
// 用于存储取消订阅函数的变量
let unsubscribeScroll: () => void;
addElementListener(el: Element) {
// 如果存在旧的监听器，先取消订阅，避免重复监听和内存泄漏
if (unsubscribeScroll) {
unsubscribeScroll();
}
// 如果元素不存在（例如组件卸载时 onRef 会传入 null），则直接返回
if (!el) return;
// 添加一个主动的滚轮事件监听器
unsubscribeScroll = addEventListenerWithOptions(
el, // 目标DOM元素
'wheel', // 事件类型
(e: WheelEvent) => {
e.preventDefault(); // 现在可以成功阻止默认行为了
// 在这里执行你的自定义滚轮操作，例如：
// console.log('滚轮事件触发，deltaY:', e.deltaY);
// 根据滚轮方向执行自定义逻辑
},
{ passive: false } // 关键：将事件设置为非被动模式
);
}在上述代码中：
- unsubscribeScroll 变量用于保存 addEventListenerWithOptions 返回的清理函数。
- addElementListener 方法会在每次onRef回调时被调用。它首先检查并清理任何现有的监听器。
- addEventListenerWithOptions 的第三个参数是事件回调函数，第四个参数是一个配置对象，其中passive: false是实现主动监听的关键。
- 回调函数中的e.preventDefault()现在将正常工作。
3. 在JSX中使用onRef
最后，将这个管理方法通过onRef属性绑定到你想要监听滚轮事件的DOM元素上。
{/* 你的内容，例如一个可缩放的图片、自定义滚动区域等 */} 这是一个需要自定义滚轮行为的区域。
当这个div元素被渲染到DOM中时，addElementListener方法就会被调用，并为其添加一个主动的wheel事件监听器。当组件卸载时，onRef回调会再次被调用，此时el参数为null，这将触发unsubscribeScroll()进行清理，确保没有遗留的事件监听器。
注意事项与最佳实践
- 事件监听器清理： 确保你的onRef回调函数能够正确处理组件的生命周期。当组件卸载时，onRef会传入null，这是一个执行清理操作的好时机。上述示例代码已经包含了清理逻辑，确保每次addElementListener被调用时，旧的监听器都会被移除，有效避免内存泄漏。
- passive: false 的权衡： 虽然passive: false解决了preventDefault()的问题，但它也意味着浏览器在处理滚轮事件时不能进行某些优化。在不需要阻止默认行为的场景下，应避免使用passive: false，以保持最佳的滚动性能。仅在确实需要完全控制事件默认行为时才使用此选项。
- 类型安全： 如果你使用TypeScript，为事件对象e指定正确的类型（例如WheelEvent）可以获得更好的类型检查和代码提示。
- CxJS版本： 确保你的CxJS版本支持addEventListenerWithOptions方法。这是一个标准工具函数，在大多数现代CxJS版本中都可用。
总结
通过巧妙地结合CxJS的onRef属性和cx/util库中的addEventListenerWithOptions方法，我们可以绕过React和CxJS默认的被动事件监听机制，为特定的DOM元素添加主动的滚轮事件监听器。这使得开发者能够在需要阻止默认滚轮行为的场景下，获得对事件的完全控制，从而实现更丰富、更精细的用户交互体验。记住，在享受这种灵活性的同时，也要注意事件监听器的正确清理和passive: false对性能的潜在影响，做到权衡取舍。
