import classNames from 'classnames'; import ResizeObserver from 'rc-resize-observer'; import { composeRef } from 'rc-util/lib/ref'; import * as React from 'react'; import type { Breakpoint } from '../_util/responsiveObserver'; import { responsiveArray } from '../_util/responsiveObserver'; import warning from '../_util/warning'; import { ConfigContext } from '../config-provider'; import useBreakpoint from '../grid/hooks/useBreakpoint'; import type { AvatarSize } from './SizeContext'; import SizeContext from './SizeContext'; import useStyle from './style'; 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 groupSize = React.useContext(SizeContext); 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 } = React.useContext(ConfigContext); 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 ? onError() : undefined; if (errorFlag !== false) { setIsImgExist(false); } }; const { prefixCls: customizePrefixCls, shape = 'circle', size: customSize = 'default', src, srcSet, icon, className, rootClassName, alt, draggable, children, crossOrigin, ...others } = props; const size = customSize === 'default' ? groupSize : customSize; 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: icon ? currentSize / 2 : 18, } : {}; }, [screens, size]); warning( !(typeof icon === 'string' && icon.length > 2), 'Avatar', `\`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 [wrapSSR, hashId] = useStyle(prefixCls); const sizeCls = classNames({ [`${prefixCls}-lg`]: size === 'large', [`${prefixCls}-sm`]: size === 'small', }); const hasImageElement = React.isValidElement(src); const classString = classNames( prefixCls, sizeCls, { [`${prefixCls}-${shape}`]: !!shape, [`${prefixCls}-image`]: hasImageElement || (src && isImgExist), [`${prefixCls}-icon`]: !!icon, }, 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 wrapSSR( {childrenToRender} , ); }; const Avatar = React.forwardRef(InternalAvatar); if (process.env.NODE_ENV !== 'production') { Avatar.displayName = 'Avatar'; } export default Avatar;