useMergedRef

useMergedRef<T>(…refs): RefCallback<T>

Defined in: src/hooks/useMergedRef/useMergedRef.ts:24

Merge multiple refs into a single callback ref. Each provided ref (object ref, callback ref, or null/undefined) receives the node when the merged ref fires.

Useful when a component needs to keep an internal ref to a DOM node while also forwarding the same node through an externally supplied ref prop (ref-as-prop in React 19).

Type Parameters

T

T

Parameters

refs

…(Ref<T> | undefined)[]

Returns

RefCallback<T>

Example

const internalRef = useRef<HTMLDivElement>(null);
const mergedRef = useMergedRef(internalRef, props.ref);

return <div ref={mergedRef} />;