useMutationObserver

监听一个或多个 DOM 节点的结构或属性变化。

签名

function useMutationObserver<T extends Node>(
    targets: readonly ResolvableTarget<T>[],
    callback: MutationCallback,
    options: MutationObserverInit & {
        enabled?: boolean;
    },
): void;

基本用法

关键行为

• targets 是目标数组，单个目标也需要写成 [target]。
• targets 中的每一项支持 DOM 对象、React ref、null 和 undefined。
• 回调变化时不会重新创建观察器，内部会调用最新回调。
• 缺少 MutationObserver、targets 为空或 enabled: false 时不会执行任何操作。

注意事项

• options 会直接传给 MutationObserver.observe，至少需要指定一个观察维度，例如 childList、attributes 或 characterData。
• targets 中重复的节点只会被观察一次。