This commit is contained in:
eewing
2026-02-17 14:10:16 -06:00
parent 2bca5834c5
commit cf73cd3b4c
11246 changed files with 1690552 additions and 0 deletions
+1
View File
@@ -0,0 +1 @@
export * from "./use-mutation-observer.svelte.js";
+1
View File
@@ -0,0 +1 @@
export * from "./use-mutation-observer.svelte.js";
@@ -0,0 +1,15 @@
import type { MaybeGetter } from "../../internal/types.js";
import { type ConfigurableWindow } from "../../internal/configurable-globals.js";
export interface UseMutationObserverOptions extends MutationObserverInit, ConfigurableWindow {
}
/**
* Watch for changes being made to the DOM tree.
*
* @see https://runed.dev/docs/utilities/useMutationObserver
* @see https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver MutationObserver MDN
*/
export declare function useMutationObserver(target: MaybeGetter<HTMLElement | HTMLElement[] | null | undefined>, callback: MutationCallback, options?: UseMutationObserverOptions): {
stop: () => void;
takeRecords(): MutationRecord[] | undefined;
};
export type UseMutationObserverReturn = ReturnType<typeof useMutationObserver>;
@@ -0,0 +1,38 @@
import { extract } from "../extract/extract.svelte.js";
import { defaultWindow } from "../../internal/configurable-globals.js";
/**
* Watch for changes being made to the DOM tree.
*
* @see https://runed.dev/docs/utilities/useMutationObserver
* @see https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver MutationObserver MDN
*/
export function useMutationObserver(target, callback, options = {}) {
const { window = defaultWindow } = options;
let observer;
const targets = $derived.by(() => {
const value = extract(target);
return new Set(value ? (Array.isArray(value) ? value : [value]) : []);
});
const stop = $effect.root(() => {
$effect(() => {
if (!targets.size || !window)
return;
observer = new window.MutationObserver(callback);
for (const el of targets)
observer.observe(el, options);
return () => {
observer?.disconnect();
observer = undefined;
};
});
});
$effect(() => {
return stop;
});
return {
stop,
takeRecords() {
return observer?.takeRecords();
},
};
}