'use client'; import classNames from 'classnames'; import ResizeObserver from 'rc-resize-observer'; import omit from 'rc-util/lib/omit'; import React, { createRef, forwardRef, useContext } from 'react'; 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; } interface InternalAffixProps extends AffixProps { affixPrefixCls: string; } enum AffixStatus { None, Prepare, } export interface AffixState { affixStyle?: React.CSSProperties; placeholderStyle?: React.CSSProperties; status: AffixStatus; lastAffix: boolean; prevTarget: Window | HTMLElement | null; } class InternalAffix extends React.Component { static contextType = ConfigContext; state: AffixState = { status: AffixStatus.None, lastAffix: false, prevTarget: null, }; private placeholderNodeRef = createRef(); private fixedNodeRef = createRef(); private timer: NodeJS.Timeout | null; context: ConfigConsumerProps; private getTargetFunc() { const { getTargetContainer } = this.context; const { target } = this.props; if (target !== undefined) { return target; } return getTargetContainer ?? getDefaultTarget; } addListeners = () => { const targetFunc = this.getTargetFunc(); const target = targetFunc?.(); const { prevTarget } = this.state; if (prevTarget !== target) { TRIGGER_EVENTS.forEach((eventName) => { prevTarget?.removeEventListener(eventName, this.lazyUpdatePosition); target?.addEventListener(eventName, this.lazyUpdatePosition); }); this.updatePosition(); this.setState({ prevTarget: target }); } }; removeListeners = () => { if (this.timer) { clearTimeout(this.timer); this.timer = null; } const { prevTarget } = this.state; const targetFunc = this.getTargetFunc(); const newTarget = targetFunc?.(); TRIGGER_EVENTS.forEach((eventName) => { newTarget?.removeEventListener(eventName, this.lazyUpdatePosition); prevTarget?.removeEventListener(eventName, this.lazyUpdatePosition); }); this.updatePosition.cancel(); // https://github.com/ant-design/ant-design/issues/22683 this.lazyUpdatePosition.cancel(); }; // Event handler componentDidMount() { // [Legacy] Wait for parent component ref has its value. // We should use target as directly element instead of function which makes element check hard. this.timer = setTimeout(this.addListeners); } componentDidUpdate(prevProps: AffixProps) { this.addListeners(); if ( prevProps.offsetTop !== this.props.offsetTop || prevProps.offsetBottom !== this.props.offsetBottom ) { this.updatePosition(); } this.measure(); } componentWillUnmount() { this.removeListeners(); } getOffsetTop = () => { const { offsetBottom, offsetTop } = this.props; return offsetBottom === undefined && offsetTop === undefined ? 0 : offsetTop; }; getOffsetBottom = () => this.props.offsetBottom; // =================== Measure =================== measure = () => { const { status, lastAffix } = this.state; const { onChange } = this.props; const targetFunc = this.getTargetFunc(); if ( status !== AffixStatus.Prepare || !this.fixedNodeRef.current || !this.placeholderNodeRef.current || !targetFunc ) { return; } const offsetTop = this.getOffsetTop(); const offsetBottom = this.getOffsetBottom(); const targetNode = targetFunc(); if (targetNode) { const newState: Partial = { status: AffixStatus.None, }; const placeholderRect = getTargetRect(this.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, offsetTop); 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 (onChange && lastAffix !== newState.lastAffix) { onChange(newState.lastAffix); } this.setState(newState as AffixState); } }; prepareMeasure = () => { // event param is used before. Keep compatible ts define here. this.setState({ status: AffixStatus.Prepare, affixStyle: undefined, placeholderStyle: undefined, }); // Test if `updatePosition` called if (process.env.NODE_ENV === 'test') { const { onTestUpdatePosition } = this.props as any; onTestUpdatePosition?.(); } }; updatePosition = throttleByAnimationFrame(() => { this.prepareMeasure(); }); lazyUpdatePosition = throttleByAnimationFrame(() => { const targetFunc = this.getTargetFunc(); const { affixStyle } = this.state; // Check position change before measure to make Safari smooth if (targetFunc && affixStyle) { const offsetTop = this.getOffsetTop(); const offsetBottom = this.getOffsetBottom(); const targetNode = targetFunc(); if (targetNode && this.placeholderNodeRef.current) { const targetRect = getTargetRect(targetNode); const placeholderRect = getTargetRect(this.placeholderNodeRef.current); const fixedTop = getFixedTop(placeholderRect, targetRect, offsetTop); 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. this.prepareMeasure(); }); // =================== Render =================== render() { const { affixStyle, placeholderStyle } = this.state; const { affixPrefixCls, rootClassName, children } = this.props; const className = classNames(affixStyle && rootClassName, { [affixPrefixCls]: !!affixStyle, }); let props = omit(this.props, [ 'prefixCls', 'offsetTop', 'offsetBottom', 'target', 'onChange', 'affixPrefixCls', 'rootClassName', ]); // Omit this since `onTestUpdatePosition` only works on test. if (process.env.NODE_ENV === 'test') { props = omit(props as typeof props & { onTestUpdatePosition: any }, ['onTestUpdatePosition']); } return (
{affixStyle && ); } } // just use in test export type InternalAffixClass = InternalAffix; const Affix = forwardRef((props, ref) => { const { prefixCls: customizePrefixCls, rootClassName } = props; const { getPrefixCls } = useContext(ConfigContext); const affixPrefixCls = getPrefixCls('affix', customizePrefixCls); const [wrapSSR, hashId] = useStyle(affixPrefixCls); const AffixProps: InternalAffixProps = { ...props, affixPrefixCls, rootClassName: classNames(rootClassName, hashId), }; return wrapSSR(); }); if (process.env.NODE_ENV !== 'production') { Affix.displayName = 'Affix'; } export default Affix;