import * as React from 'react'; import classNames from 'classnames'; import { ConfigContext } from '../config-provider'; import devWarning from '../_util/devWarning'; import { composeRef } from '../_util/ref'; 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?: 'large' | 'small' | 'default' | number; gap?: number; /** Src of image avatar */ src?: string; /** Srcset of image avatar */ srcSet?: string; draggable?: boolean; /** icon to be used in avatar */ icon?: React.ReactNode; style?: React.CSSProperties; prefixCls?: string; className?: string; children?: React.ReactNode; alt?: string; /* callback when img load error */ /* return false to prevent Avatar show default fallback behavior, then you can do fallback by your self */ 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(); const avatarChildrenRef = React.useRef(); const avatarNodeMergeRef = composeRef(ref, avatarNodeRef); let lastChildrenWidth: number; let lastNodeWidth: number; 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; const { gap = 4 } = props; // denominator is 0 is no meaning if ( childrenWidth !== 0 && nodeWidth !== 0 && (lastChildrenWidth !== childrenWidth || lastNodeWidth !== nodeWidth) ) { lastChildrenWidth = childrenWidth; lastNodeWidth = nodeWidth; } 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.children, props.gap, props.size]); React.useEffect(() => { if (props.children) { setScaleParam(); } }, [isImgExist]); const handleImgLoadError = () => { const { onError } = props; const errorFlag = onError ? onError() : undefined; if (errorFlag !== false) { setIsImgExist(false); } }; const { prefixCls: customizePrefixCls, shape, size, src, srcSet, icon, className, alt, draggable, children, ...others } = props; devWarning( !(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 sizeCls = classNames({ [`${prefixCls}-lg`]: size === 'large', [`${prefixCls}-sm`]: size === 'small', }); const classString = classNames(prefixCls, className, sizeCls, { [`${prefixCls}-${shape}`]: shape, [`${prefixCls}-image`]: src && isImgExist, [`${prefixCls}-icon`]: icon, }); const sizeStyle: React.CSSProperties = typeof size === 'number' ? { width: size, height: size, lineHeight: `${size}px`, fontSize: icon ? size / 2 : 18, } : {}; let childrenToRender; if (src && isImgExist) { childrenToRender = ( {alt} ); } 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 = ( { avatarChildrenRef.current = node; }} style={{ ...sizeChildrenStyle, ...childrenStyle }} > {children} ); } else { childrenToRender = ( { avatarChildrenRef.current = node; }} > {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 ( {childrenToRender} ); }; const Avatar = React.forwardRef(InternalAvatar); Avatar.displayName = 'Avatar'; Avatar.defaultProps = { shape: 'circle' as AvatarProps['shape'], size: 'default' as AvatarProps['size'], }; export default Avatar;