DOM 事件

问题：嵌套元素上的同一个事件，执行顺序是什么？

没有统一规范：
  Netscape：父元素先执行（捕获）
  IE：子元素先执行（冒泡）

解决：W3C 统一为三个阶段

  捕获阶段：window → document → html → body → ... → 目标元素
  目标阶段：目标元素上的所有监听器
  冒泡阶段：目标元素 → ... → body → html → document → window

┌───────────────────────────────────────┐
│  event.preventDefault()               │  ← 阻止浏览器的默认行为
│  例：阻止链接跳转、阻止表单提交        │
└───────────────────────────────────────┘

┌───────────────────────────────────────┐
│  event.stopPropagation()              │  ← 阻止事件继续传播
│  例：阻止冒泡到父元素                  │
└───────────────────────────────────────┘

// preventDefault：阻止浏览器默认行为，不影响事件传播
link.addEventListener("click", (e) => {
  e.preventDefault(); // 链接不会跳转，但事件照样冒泡到父元素
});

// stopPropagation：阻止事件继续传播，不影响默认行为
button.addEventListener("click", (e) => {
  e.stopPropagation(); // 事件不会冒泡到父元素，但按钮的默认行为不受影响
});

// stopImmediatePropagation：阻止传播 + 阻止同一元素上的其他监听器执行
button.addEventListener("click", (e) => {
  e.stopImmediatePropagation();
  // 同一个 button 上绑定的其他 click 监听器也不会执行了
});

// 在 HTML 属性中 return false = preventDefault + stopPropagation
// 但在 addEventListener 回调中 return false 不会阻止冒泡！

// 手动设置 passive
element.addEventListener("touchmove", handler, { passive: true });

// Chrome 的默认行为：document 级别的 touch/wheel 事件默认 passive: true
// 如果你确实需要阻止滚动，必须显式设置 passive: false
document.addEventListener(
  "touchmove",
  (e) => {
    e.preventDefault(); // 会触发 Chrome 控制台的警告
  },
  { passive: false },
); // 必须显式声明

// EventDispatcher::DispatchEvent 的核心逻辑
void EventDispatcher::DispatchEvent(Node& node, Event& event) {
  // 1. 构建传播路径：从目标元素向上遍历到 window
  HeapVector<Member<EventTarget>> propagation_path;
  for (EventTarget* t = &node; t; t = t->ParentOrShadowHost())
    propagation_path.push_back(t);

  // 2. 捕获阶段：从 window 向下遍历
  event.SetEventPhase(Event::PhaseType::kCapturingPhase);
  for (auto it = propagation_path.rbegin(); it != propagation_path.rend(); ++it)
    FireEventListeners(*it, event);

  // 3. 目标阶段
  event.SetEventPhase(Event::PhaseType::kAtTarget);
  FireEventListeners(node, event);

  // 4. 冒泡阶段：从目标向上遍历
  event.SetEventPhase(Event::PhaseType::kBubblingPhase);
  for (auto& target : propagation_path)
    FireEventListeners(target, event);
}

// RegisteredEventListener 存储每个监听器的元数据
class RegisteredEventListener {
  Member<EventListener> callback_;
  bool use_capture_;      // 捕获还是冒泡
  bool passive_;          // 是否 passive
  bool once_;             // 是否只执行一次
  AbortSignal* signal_;   // 用于 AbortController 移除
};