import React from 'react'; import classNames from 'classnames'; import ResizeObserver from 'rc-resize-observer'; import omit from 'rc-util/lib/omit'; import throttleByAnimationFrame from '../_util/throttleByAnimationFrame'; import type { ConfigConsumerProps } from '../config-provider'; import { ConfigContext } from '../config-provider'; import useStyle from './style'; import { getFixedBottom, getFixedTop, getTargetRect } from './utils'; const TRIGGER_EVENTS = [ 'resize', 'scroll', 'touchstart', 'touchmove', 'touchend', 'pageshow', 'load', ] as const; function getDefaultTarget() { return typeof window !== 'undefined' ? window : null; } // Affix export interface AffixProps { /** Triggered when the specified offset is reached from the top of the window */ offsetTop?: number; /** Triggered when the specified offset is reached from the bottom of the window */ offsetBottom?: number; style?: React.CSSProperties; /** Callback function triggered when fixed state changes */ onChange?: (affixed?: boolean) => void; /** Set the element that Affix needs to listen to its scroll event, the value is a function that returns the corresponding DOM element */ target?: () => Window | HTMLElement | null; prefixCls?: string; className?: string; rootClassName?: string; children: React.ReactNode; } enum AffixStatus { None, Prepare, } interface AffixState { affixStyle?: React.CSSProperties; placeholderStyle?: React.CSSProperties; status: AffixStatus; lastAffix: boolean; prevTarget: Window | HTMLElement | null; } export interface AffixRef { updatePosition: ReturnType; } const Affix = React.forwardRef((props, ref) => { const { style, offsetTop, offsetBottom, prefixCls, className, rootClassName, children, target, onChange, } = props; const { getPrefixCls, getTargetContainer } = React.useContext(ConfigContext); const affixPrefixCls = getPrefixCls('affix', prefixCls); const [lastAffix, setLastAffix] = React.useState(false); const [affixStyle, setAffixStyle] = React.useState(); const [placeholderStyle, setPlaceholderStyle] = React.useState(); const status = React.useRef(AffixStatus.None); const prevTarget = React.useRef(null); const prevListener = React.useRef(); const placeholderNodeRef = React.useRef(null); const fixedNodeRef = React.useRef(null); const timer = React.useRef | null>(null); const targetFunc = target ?? getTargetContainer ?? getDefaultTarget; const internalOffsetTop = offsetBottom === undefined && offsetTop === undefined ? 0 : offsetTop; // =================== Measure =================== const measure = () => { if ( status.current !== AffixStatus.Prepare || !fixedNodeRef.current || !placeholderNodeRef.current || !targetFunc ) { return; } const targetNode = targetFunc(); if (targetNode) { const newState: Partial = { status: AffixStatus.None, }; const placeholderRect = getTargetRect(placeholderNodeRef.current); if ( placeholderRect.top === 0 && placeholderRect.left === 0 && placeholderRect.width === 0 && placeholderRect.height === 0 ) { return; } const targetRect = getTargetRect(targetNode); const fixedTop = getFixedTop(placeholderRect, targetRect, internalOffsetTop); const fixedBottom = getFixedBottom(placeholderRect, targetRect, offsetBottom); if (fixedTop !== undefined) { newState.affixStyle = { position: 'fixed', top: fixedTop, width: placeholderRect.width, height: placeholderRect.height, }; newState.placeholderStyle = { width: placeholderRect.width, height: placeholderRect.height, }; } else if (fixedBottom !== undefined) { newState.affixStyle = { position: 'fixed', bottom: fixedBottom, width: placeholderRect.width, height: placeholderRect.height, }; newState.placeholderStyle = { width: placeholderRect.width, height: placeholderRect.height, }; } newState.lastAffix = !!newState.affixStyle; if (lastAffix !== newState.lastAffix) { onChange?.(newState.lastAffix); } status.current = newState.status!; setAffixStyle(newState.affixStyle); setPlaceholderStyle(newState.placeholderStyle); setLastAffix(newState.lastAffix); } }; const prepareMeasure = () => { status.current = AffixStatus.Prepare; measure(); if (process.env.NODE_ENV === 'test') { (props as any)?.onTestUpdatePosition?.(); } }; const updatePosition = throttleByAnimationFrame(() => { prepareMeasure(); }); const lazyUpdatePosition = throttleByAnimationFrame(() => { // Check position change before measure to make Safari smooth if (targetFunc && affixStyle) { const targetNode = targetFunc(); if (targetNode && placeholderNodeRef.current) { const targetRect = getTargetRect(targetNode); const placeholderRect = getTargetRect(placeholderNodeRef.current); const fixedTop = getFixedTop(placeholderRect, targetRect, internalOffsetTop); const fixedBottom = getFixedBottom(placeholderRect, targetRect, offsetBottom); if ( (fixedTop !== undefined && affixStyle.top === fixedTop) || (fixedBottom !== undefined && affixStyle.bottom === fixedBottom) ) { return; } } } // Directly call prepare measure since it's already throttled. prepareMeasure(); }); const addListeners = () => { const listenerTarget = targetFunc?.(); if (!listenerTarget) { return; } TRIGGER_EVENTS.forEach((eventName) => { if (prevListener.current) { prevTarget.current?.removeEventListener(eventName, prevListener.current); } listenerTarget?.addEventListener(eventName, lazyUpdatePosition); }); prevTarget.current = listenerTarget; prevListener.current = lazyUpdatePosition; }; const removeListeners = () => { if (timer.current) { clearTimeout(timer.current); timer.current = null; } const newTarget = targetFunc?.(); TRIGGER_EVENTS.forEach((eventName) => { newTarget?.removeEventListener(eventName, lazyUpdatePosition); if (prevListener.current) { prevTarget.current?.removeEventListener(eventName, prevListener.current); } }); updatePosition.cancel(); lazyUpdatePosition.cancel(); }; React.useImperativeHandle(ref, () => ({ updatePosition })); // mount & unmount React.useEffect(() => { // [Legacy] Wait for parent component ref has its value. // We should use target as directly element instead of function which makes element check hard. timer.current = setTimeout(addListeners); return () => removeListeners(); }, []); React.useEffect(() => { addListeners(); }, [target, affixStyle]); React.useEffect(() => { updatePosition(); }, [target, offsetTop, offsetBottom]); const [wrapCSSVar, hashId, cssVarCls] = useStyle(affixPrefixCls); const rootCls = classNames(rootClassName, hashId, affixPrefixCls, cssVarCls); const mergedCls = classNames({ [rootCls]: affixStyle }); let otherProps = omit(props, [ 'prefixCls', 'offsetTop', 'offsetBottom', 'target', 'onChange', 'rootClassName', ]); if (process.env.NODE_ENV === 'test') { otherProps = omit(otherProps, ['onTestUpdatePosition' as any]); } return wrapCSSVar(
{affixStyle && , ); }); if (process.env.NODE_ENV !== 'production') { Affix.displayName = 'Affix'; } export default Affix;