import * as React from 'react'; import classNames from 'classnames'; import ResizeObserver from 'rc-resize-observer'; import { composeRef } from 'rc-util/lib/ref'; import type { Breakpoint } from '../_util/responsiveObserver'; import { responsiveArray } from '../_util/responsiveObserver'; import { devUseWarning } from '../_util/warning'; import { ConfigContext } from '../config-provider'; import useSize from '../config-provider/hooks/useSize'; import useBreakpoint from '../grid/hooks/useBreakpoint'; import type { AvatarContextType, AvatarSize } from './AvatarContext'; import AvatarContext from './AvatarContext'; import useStyle from './style'; import useCSSVar from './style/cssVar'; import useCSSVarCls from '../config-provider/hooks/useCSSVarCls'; export interface AvatarProps { /** Shape of avatar, options: `circle`, `square` */ shape?: 'circle' | 'square'; /* * Size of avatar, options: `large`, `small`, `default` * or a custom number size * */ size?: AvatarSize; gap?: number; /** Src of image avatar */ src?: React.ReactNode; /** Srcset of image avatar */ srcSet?: string; draggable?: boolean | 'true' | 'false'; /** Icon to be used in avatar */ icon?: React.ReactNode; style?: React.CSSProperties; prefixCls?: string; className?: string; rootClassName?: string; children?: React.ReactNode; alt?: string; crossOrigin?: '' | 'anonymous' | 'use-credentials'; onClick?: (e?: React.MouseEvent) => void; /* callback when img load error */ /* return false to prevent Avatar show default fallback behavior, then you can do fallback by yourself */ onError?: () => boolean; } const InternalAvatar: React.ForwardRefRenderFunction = ( props, ref, ) => { const [scale, setScale] = React.useState(1); const [mounted, setMounted] = React.useState(false); const [isImgExist, setIsImgExist] = React.useState(true); const avatarNodeRef = React.useRef(null); const avatarChildrenRef = React.useRef(null); const avatarNodeMergeRef = composeRef(ref, avatarNodeRef); const { getPrefixCls, avatar } = React.useContext(ConfigContext); const avatarCtx = React.useContext(AvatarContext); const setScaleParam = () => { if (!avatarChildrenRef.current || !avatarNodeRef.current) { return; } const childrenWidth = avatarChildrenRef.current.offsetWidth; // offsetWidth avoid affecting be transform scale const nodeWidth = avatarNodeRef.current.offsetWidth; // denominator is 0 is no meaning if (childrenWidth !== 0 && nodeWidth !== 0) { const { gap = 4 } = props; if (gap * 2 < nodeWidth) { setScale(nodeWidth - gap * 2 < childrenWidth ? (nodeWidth - gap * 2) / childrenWidth : 1); } } }; React.useEffect(() => { setMounted(true); }, []); React.useEffect(() => { setIsImgExist(true); setScale(1); }, [props.src]); React.useEffect(setScaleParam, [props.gap]); const handleImgLoadError = () => { const { onError } = props; const errorFlag = onError?.(); if (errorFlag !== false) { setIsImgExist(false); } }; const { prefixCls: customizePrefixCls, shape, size: customSize, src, srcSet, icon, className, rootClassName, alt, draggable, children, crossOrigin, ...others } = props; const size = useSize((ctxSize) => customSize ?? avatarCtx?.size ?? ctxSize ?? 'default'); const needResponsive = Object.keys(typeof size === 'object' ? size || {} : {}).some((key) => ['xs', 'sm', 'md', 'lg', 'xl', 'xxl'].includes(key), ); const screens = useBreakpoint(needResponsive); const responsiveSizeStyle = React.useMemo(() => { if (typeof size !== 'object') { return {}; } const currentBreakpoint: Breakpoint = responsiveArray.find((screen) => screens[screen])!; const currentSize = size[currentBreakpoint]; return currentSize ? { width: currentSize, height: currentSize, lineHeight: `${currentSize}px`, fontSize: currentSize && (icon || children) ? currentSize / 2 : 18, } : {}; }, [screens, size]); if (process.env.NODE_ENV !== 'production') { const warning = devUseWarning('Avatar'); warning( !(typeof icon === 'string' && icon.length > 2), 'breaking', `\`icon\` is using ReactNode instead of string naming in v4. Please check \`${icon}\` at https://ant.design/components/icon`, ); } const prefixCls = getPrefixCls('avatar', customizePrefixCls); const [, hashId] = useStyle(prefixCls); const cssVarCls = useCSSVarCls(prefixCls); const wrapCSSVar = useCSSVar(cssVarCls); const sizeCls = classNames({ [`${prefixCls}-lg`]: size === 'large', [`${prefixCls}-sm`]: size === 'small', }); const hasImageElement = React.isValidElement(src); const mergedShape = shape || avatarCtx?.shape || 'circle'; const classString = classNames( prefixCls, sizeCls, avatar?.className, `${prefixCls}-${mergedShape}`, { [`${prefixCls}-image`]: hasImageElement || (src && isImgExist), [`${prefixCls}-icon`]: !!icon, }, cssVarCls, className, rootClassName, hashId, ); const sizeStyle: React.CSSProperties = typeof size === 'number' ? { width: size, height: size, lineHeight: `${size}px`, fontSize: icon ? size / 2 : 18, } : {}; let childrenToRender: React.ReactNode; if (typeof src === 'string' && isImgExist) { childrenToRender = ( {alt} ); } else if (hasImageElement) { childrenToRender = src; } else if (icon) { childrenToRender = icon; } else if (mounted || scale !== 1) { const transformString = `scale(${scale}) translateX(-50%)`; const childrenStyle: React.CSSProperties = { msTransform: transformString, WebkitTransform: transformString, transform: transformString, }; const sizeChildrenStyle: React.CSSProperties = typeof size === 'number' ? { lineHeight: `${size}px`, } : {}; childrenToRender = ( {children} ); } else { childrenToRender = ( {children} ); } // The event is triggered twice from bubbling up the DOM tree. // see https://codesandbox.io/s/kind-snow-9lidz delete others.onError; delete others.gap; return wrapCSSVar( {childrenToRender} , ); }; const Avatar = React.forwardRef(InternalAvatar); if (process.env.NODE_ENV !== 'production') { Avatar.displayName = 'Avatar'; } export default Avatar;