Folo/packages/internal/hooks/src/useMeasure.ts

211 lines
6.2 KiB
TypeScript

// @copy https://github.com/pmndrs/react-use-measure/blob/master/src/web/index.ts
import { debounce } from "es-toolkit/compat"
import { useEffect, useMemo, useRef, useState } from "react"
const createDebounce = debounce
declare type ResizeObserverCallback = (entries: any[], observer: ResizeObserver) => void
declare class ResizeObserver {
constructor(callback: ResizeObserverCallback)
observe(target: Element, options?: any): void
unobserve(target: Element): void
disconnect(): void
static toString(): string
}
export interface RectReadOnly {
readonly x: number
readonly y: number
readonly width: number
readonly height: number
readonly top: number
readonly right: number
readonly bottom: number
readonly left: number
[key: string]: number
}
type HTMLOrSVGElement = HTMLElement | SVGElement
type Result = [(element: HTMLOrSVGElement | null) => void, RectReadOnly, () => void]
type State = {
element: HTMLOrSVGElement | null
scrollContainers: HTMLOrSVGElement[] | null
resizeObserver: ResizeObserver | null
lastBounds: RectReadOnly
}
export type Options = {
debounce?: number | { scroll: number; resize: number }
scroll?: boolean
offsetSize?: boolean
}
const defaultOptions: Options = {
debounce: 0,
scroll: false,
offsetSize: false,
}
export function useMeasure({ debounce, scroll, offsetSize }: Options = defaultOptions): Result {
const [bounds, set] = useState<RectReadOnly>({
left: 0,
top: 0,
width: 0,
height: 0,
bottom: 0,
right: 0,
x: 0,
y: 0,
})
// keep all state in a ref
const state = useRef<State>({
element: null,
scrollContainers: null,
resizeObserver: null,
lastBounds: bounds,
})
// set actual debounce values early, so effects know if they should react accordingly
const scrollDebounce = debounce
? typeof debounce === "number"
? debounce
: debounce.scroll
: null
const resizeDebounce = debounce
? typeof debounce === "number"
? debounce
: debounce.resize
: null
// make sure to update state only as long as the component is truly mounted
const mounted = useRef(false)
useEffect(() => {
mounted.current = true
return () => void (mounted.current = false)
})
// memoize handlers, so event-listeners know when they should update
const [forceRefresh, resizeChange, scrollChange] = useMemo(() => {
const callback = () => {
if (!state.current.element) return
const { left, top, width, height, bottom, right, x, y } =
state.current.element.getBoundingClientRect() as unknown as RectReadOnly
const size = {
left,
top,
width,
height,
bottom,
right,
x,
y,
}
if (state.current.element instanceof HTMLElement && offsetSize) {
size.height = state.current.element.offsetHeight
size.width = state.current.element.offsetWidth
}
Object.freeze(size)
if (mounted.current && !areBoundsEqual(state.current.lastBounds, size)) {
set((state.current.lastBounds = size))
}
}
return [
callback,
resizeDebounce ? createDebounce(callback, resizeDebounce) : callback,
scrollDebounce ? createDebounce(callback, scrollDebounce) : callback,
]
}, [set, offsetSize, scrollDebounce, resizeDebounce])
// cleanup current scroll-listeners / observers
function removeListeners() {
if (state.current.scrollContainers) {
state.current.scrollContainers.forEach((element) =>
element.removeEventListener("scroll", scrollChange, true),
)
state.current.scrollContainers = null
}
if (state.current.resizeObserver) {
state.current.resizeObserver.disconnect()
state.current.resizeObserver = null
}
}
// add scroll-listeners / observers
function addListeners() {
if (!state.current.element) return
state.current.resizeObserver = new ResizeObserver(scrollChange)
state.current.resizeObserver!.observe(state.current.element)
if (scroll && state.current.scrollContainers) {
state.current.scrollContainers.forEach((scrollContainer) =>
scrollContainer.addEventListener("scroll", scrollChange, {
capture: true,
passive: true,
}),
)
}
}
// the ref we expose to the user
const ref = (node: HTMLOrSVGElement | null) => {
if (!node || node === state.current.element) return
removeListeners()
state.current.element = node
state.current.scrollContainers = findScrollContainers(node)
addListeners()
}
// add general event listeners
useOnWindowScroll(scrollChange, Boolean(scroll))
useOnWindowResize(resizeChange)
// respond to changes that are relevant for the listeners
useEffect(() => {
removeListeners()
addListeners()
}, [scroll, scrollChange, resizeChange])
// remove all listeners when the components unmounts
useEffect(() => removeListeners, [])
return [ref, bounds, forceRefresh]
}
// Adds native resize listener to window
function useOnWindowResize(onWindowResize: (event: Event) => void) {
useEffect(() => {
const cb = onWindowResize
window.addEventListener("resize", cb)
return () => void window.removeEventListener("resize", cb)
}, [onWindowResize])
}
function useOnWindowScroll(onScroll: () => void, enabled: boolean) {
useEffect(() => {
if (enabled) {
const cb = onScroll
window.addEventListener("scroll", cb, { capture: true, passive: true })
return () => void window.removeEventListener("scroll", cb, true)
}
}, [onScroll, enabled])
}
// Returns a list of scroll offsets
function findScrollContainers(element: HTMLOrSVGElement | null): HTMLOrSVGElement[] {
const result: HTMLOrSVGElement[] = []
if (!element || element === document.body) return result
const { overflow, overflowX, overflowY } = window.getComputedStyle(element)
if ([overflow, overflowX, overflowY].some((prop) => prop === "auto" || prop === "scroll")) {
result.push(element)
}
return [...result, ...findScrollContainers(element.parentElement)]
}
// Checks if element boundaries are equal
const keys: (keyof RectReadOnly)[] = ["x", "y", "top", "bottom", "left", "right", "width", "height"]
const areBoundsEqual = (a: RectReadOnly, b: RectReadOnly): boolean =>
keys.every((key) => a[key] === b[key])