@douyinfe/semi-ui 2.49.0-beta.0 → 2.49.0

package/lib/cjs/image/interface.d.ts

@@ -53,6 +53,8 @@ export interface PreviewProps extends BaseProps {
     zIndex?: number;
     children?: ReactNode;
     crossOrigin?: "anonymous" | "use-credentials";
+    maxZoom?: number;
+    minZoom?: number;
     renderHeader?: (info: any) => ReactNode;
     renderPreviewMenu?: (props: MenuProps) => ReactNode;
     getPopupContainer?: () => HTMLElement;
@@ -138,14 +140,12 @@ export interface FooterProps extends SliderProps {
     onRotate?: (direction: string) => void;
     onDownload?: () => void;
     renderPreviewMenu?: (props: MenuProps) => ReactNode;
+    forwardRef?: React.RefObject<HTMLElement>;
 }
 export interface PreviewImageProps {
     src?: string;
     rotation?: number;
     style?: React.CSSProperties;
-    maxZoom?: number;
-    minZoom?: number;
-    zoomStep?: number;
     zoom?: number;
     ratio?: RatioType;
     disableDownload?: boolean;

package/lib/cjs/image/previewFooter.js

@@ -19,14 +19,9 @@ var _localeConsumer = _interopRequireDefault(require("../locale/localeConsumer")
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const prefixCls = _constants.cssClasses.PREFIX;
 const footerPrefixCls = `${_constants.cssClasses.PREFIX}-preview-footer`;
-let mouseActiveTime = 0;
 class Footer extends _baseComponent.default {
   get adapter() {
-    return Object.assign(Object.assign({}, super.adapter), {
-      setStartMouseOffset: time => {
-        mouseActiveTime = time;
-      }
-    });
+    return Object.assign({}, super.adapter);
   }
   constructor(props) {
     super(props);
@@ -266,13 +261,15 @@ class Footer extends _baseComponent.default {
   render() {
     const {
       className,
-      renderPreviewMenu
+      renderPreviewMenu,
+      forwardRef
     } = this.props;
     const menuCls = (0, _classnames.default)(footerPrefixCls, `${footerPrefixCls}-wrapper`, className, {
       [`${footerPrefixCls}-content`]: !Boolean(renderPreviewMenu)
     });
     return /*#__PURE__*/_react.default.createElement("section", {
-      className: menuCls
+      className: menuCls,
+      ref: forwardRef
     }, renderPreviewMenu ? this.customRenderViewMenu() : this.getFooterMenu());
   }
 }

package/lib/cjs/image/previewHeader.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import React from "react";
 import { HeaderProps } from "./interface";
-declare const Header: React.FC<HeaderProps>;
+declare const Header: React.ForwardRefExoticComponent<HeaderProps & React.RefAttributes<HTMLElement>>;
 export default Header;

package/lib/cjs/image/previewHeader.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var React = _interopRequireWildcard(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _semiIcons = require("@douyinfe/semi-icons");
 var _constants = require("@douyinfe/semi-foundation/lib/cjs/image/constants");
 var _classnames = _interopRequireDefault(require("classnames"));
@@ -13,14 +13,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 const prefixCls = `${_constants.cssClasses.PREFIX}-preview-header`;
-const Header = _ref => {
+const Header = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
   let {
     onClose,
     titleStyle,
     className,
     renderHeader
   } = _ref;
-  return /*#__PURE__*/React.createElement(_previewContext.PreviewContext.Consumer, null, _ref2 => {
+  return /*#__PURE__*/_react.default.createElement(_previewContext.PreviewContext.Consumer, null, _ref2 => {
     let {
       currentIndex,
       titles
@@ -29,16 +29,17 @@ const Header = _ref => {
     if (titles && typeof currentIndex === "number") {
       title = titles[currentIndex];
     }
-    return /*#__PURE__*/React.createElement("section", {
+    return /*#__PURE__*/_react.default.createElement("section", {
+      ref: ref,
       className: (0, _classnames.default)(prefixCls, className)
-    }, /*#__PURE__*/React.createElement("section", {
+    }, /*#__PURE__*/_react.default.createElement("section", {
       className: `${prefixCls}-title`,
       style: titleStyle
-    }, renderHeader ? renderHeader(title) : title), /*#__PURE__*/React.createElement("section", {
+    }, renderHeader ? renderHeader(title) : title), /*#__PURE__*/_react.default.createElement("section", {
       className: `${prefixCls}-close`,
       onMouseUp: onClose
-    }, /*#__PURE__*/React.createElement(_semiIcons.IconClose, null)));
+    }, /*#__PURE__*/_react.default.createElement(_semiIcons.IconClose, null)));
   });
-};
+});
 var _default = Header;
 exports.default = _default;

package/lib/cjs/image/previewImage.d.ts

@@ -8,9 +8,6 @@ export default class PreviewImage extends BaseComponent<PreviewImageProps, Previ
         src: PropTypes.Requireable<string>;
         rotation: PropTypes.Requireable<number>;
         style: PropTypes.Requireable<object>;
-        maxZoom: PropTypes.Requireable<number>;
-        minZoom: PropTypes.Requireable<number>;
-        zoomStep: PropTypes.Requireable<number>;
         zoom: PropTypes.Requireable<number>;
         ratio: PropTypes.Requireable<string>;
         disableDownload: PropTypes.Requireable<boolean>;
@@ -21,29 +18,21 @@ export default class PreviewImage extends BaseComponent<PreviewImageProps, Previ
         onError: PropTypes.Requireable<(...args: any[]) => any>;
     };
     static defaultProps: {
-        maxZoom: number;
-        minZoom: number;
-        zoomStep: number;
         zoom: any;
     };
     get adapter(): PreviewImageAdapter<PreviewImageProps, PreviewImageStates>;
     containerRef: React.RefObject<HTMLDivElement>;
-    imageRef: HTMLImageElement | null;
+    imageRef: React.RefObject<HTMLImageElement>;
     foundation: PreviewImageFoundation;
     constructor(props: any);
     componentDidMount(): void;
     componentWillUnmount(): void;
     componentDidUpdate(prevProps: PreviewImageProps, prevStates: PreviewImageStates): void;
     onWindowResize: () => void;
-    handleZoomChange: (newZoom: any, e: any) => void;
     handleRightClickImage: (e: any) => void;
-    handleWheel: (e: any) => void;
     handleLoad: (e: any) => void;
     handleError: (e: any) => void;
-    resizeImage: () => void;
     handleMoveImage: (e: any) => void;
-    registryImageRef: (ref: any) => void;
     onImageMouseDown: (e: React.MouseEvent<HTMLImageElement>) => void;
-    onImageMouseUp: () => void;
     render(): JSX.Element;
 }

package/lib/cjs/image/previewImage.js

@@ -13,38 +13,14 @@ var _previewImageFoundation = _interopRequireDefault(require("@douyinfe/semi-fou
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const prefixCls = _constants.cssClasses.PREFIX;
 const preViewImgPrefixCls = `${prefixCls}-preview-image`;
-let originImageWidth = null;
-let originImageHeight = null;
-let startMouseMove = false;
-// startMouseOffset：The offset of the mouse relative to the left and top of the picture
-let startMouseOffset = {
-  x: 0,
-  y: 0
-};
 class PreviewImage extends _baseComponent.default {
   get adapter() {
     return Object.assign(Object.assign({}, super.adapter), {
-      getOriginImageSize: () => ({
-        originImageWidth,
-        originImageHeight
-      }),
-      setOriginImageSize: size => {
-        originImageWidth = size.originImageWidth;
-        originImageHeight = size.originImageHeight;
-      },
       getContainer: () => {
         return this.containerRef.current;
       },
       getImage: () => {
-        return this.imageRef;
-      },
-      getMouseMove: () => startMouseMove,
-      setStartMouseMove: move => {
-        startMouseMove = move;
-      },
-      getMouseOffset: () => startMouseOffset,
-      setStartMouseOffset: offset => {
-        startMouseOffset = offset;
+        return this.imageRef.current;
       },
       setLoading: loading => {
         this.setState({
@@ -52,7 +28,7 @@ class PreviewImage extends _baseComponent.default {
         });
       },
       setImageCursor: canDrag => {
-        this.imageRef.style.cursor = canDrag ? "grab" : "default";
+        this.imageRef.current.style.cursor = canDrag ? "grab" : "default";
       }
     });
   }
@@ -61,52 +37,22 @@ class PreviewImage extends _baseComponent.default {
     this.onWindowResize = () => {
       this.foundation.handleWindowResize();
     };
-    this.handleZoomChange = (newZoom, e) => {
-      this.foundation.handleZoomChange(newZoom, e);
-    };
     // Determine the response method of right click according to the disableDownload parameter in props
     this.handleRightClickImage = e => {
       this.foundation.handleRightClickImage(e);
     };
-    this.handleWheel = e => {
-      this.foundation.handleWheel(e);
-    };
     this.handleLoad = e => {
       this.foundation.handleLoad(e);
     };
     this.handleError = e => {
       this.foundation.handleError(e);
     };
-    this.resizeImage = () => {
-      this.foundation.handleResizeImage();
-    };
     this.handleMoveImage = e => {
       this.foundation.handleMoveImage(e);
     };
-    // 为什么通过ref注册wheel而不是使用onWheel事件？
-    // 因为对于wheel事件，浏览器将 addEventListener 的 passive 默认值更改为 true。如此，事件监听器便不能取消事件，也不会在用户滚动页面时阻止页面呈现。
-    // 这里我们需要保持页面不动，仅放大图片，因此此处需要将 passive 更改设置为 false。
-    // Why register wheel via ref instead of using onWheel event?
-    // Because for wheel events, the browser changes the passive default of addEventListener to true. This way, the event listener cannot cancel the event, nor prevent the page from rendering when the user scrolls.
-    // Here we need to keep the page still and only zoom in on the image, so here we need to set the passive change to false.
-    // https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#improving_scrolling_performance_with_passive_listeners。
-    this.registryImageRef = ref => {
-      if (this.imageRef) {
-        this.imageRef.removeEventListener("wheel", this.handleWheel);
-      }
-      if (ref) {
-        ref.addEventListener("wheel", this.handleWheel, {
-          passive: false
-        });
-      }
-      this.imageRef = ref;
-    };
     this.onImageMouseDown = e => {
       this.foundation.handleImageMouseDown(e);
     };
-    this.onImageMouseUp = () => {
-      this.foundation.handleImageMouseUp();
-    };
     this.state = {
       width: 0,
       height: 0,
@@ -120,7 +66,7 @@ class PreviewImage extends _baseComponent.default {
       left: 0
     };
     this.containerRef = /*#__PURE__*/_react.default.createRef();
-    this.imageRef = null;
+    this.imageRef = /*#__PURE__*/_react.default.createRef();
     this.foundation = new _previewImageFoundation.default(this.adapter);
   }
   componentDidMount() {
@@ -131,27 +77,22 @@ class PreviewImage extends _baseComponent.default {
   }
   componentDidUpdate(prevProps, prevStates) {
     // If src changes, start a new loading
-    if (this.props.src && this.props.src !== prevProps.src) {
+    const zoomChange = "zoom" in this.props && this.props.zoom !== this.state.currZoom;
+    const srcChange = this.props.src && this.props.src !== prevProps.src;
+    if (srcChange) {
       this.foundation.setLoading(true);
     }
     // If the incoming zoom changes, other content changes are determined based on the new zoom value
-    if ("zoom" in this.props && this.props.zoom !== prevStates.currZoom) {
-      this.handleZoomChange(this.props.zoom, null);
+    if (zoomChange) {
+      this.foundation.calculatePreviewImage(this.props.zoom, null);
     }
-    // When the incoming ratio is changed, if it"s adaptation, then resizeImage is triggered to make the image adapt to the page
-    // else if it"s adaptation is realSize, then onZoom(1) is called to make the image size the original size;
-    if ("ratio" in this.props && this.props.ratio !== prevProps.ratio) {
-      if (originImageWidth && originImageHeight) {
-        if (this.props.ratio === "adaptation") {
-          this.resizeImage();
-        } else {
-          this.props.onZoom(1);
-        }
+    if (!zoomChange && !srcChange && prevProps) {
+      if ("ratio" in this.props && this.props.ratio !== prevProps.ratio) {
+        this.foundation.handleRatioChange();
+      }
+      if ("rotation" in this.props && this.props.rotation !== prevProps.rotation) {
+        this.onWindowResize();
       }
-    }
-    // When the incoming rotation angle of the image changes, it needs to be resized to make the image fit on the page
-    if ("rotation" in this.props && this.props.rotation !== prevProps.rotation) {
-      this.onWindowResize();
     }
   }
   render() {
@@ -173,21 +114,20 @@ class PreviewImage extends _baseComponent.default {
       transform: `rotate(${-rotation}deg)`,
       top,
       left,
-      width: loading ? "auto" : `${width}px`,
-      height: loading ? "auto" : `${height}px`
+      width,
+      height
     };
     return /*#__PURE__*/_react.default.createElement("div", {
       className: `${preViewImgPrefixCls}`,
       ref: this.containerRef
     }, /*#__PURE__*/_react.default.createElement("img", {
-      ref: this.registryImageRef,
+      ref: this.imageRef,
       src: src,
       alt: "previewImag",
       className: `${preViewImgPrefixCls}-img`,
       key: src,
       onMouseMove: this.handleMoveImage,
       onMouseDown: this.onImageMouseDown,
-      onMouseUp: this.onImageMouseUp,
       onContextMenu: this.handleRightClickImage,
       onDragStart: e => e.preventDefault(),
       onLoad: this.handleLoad,
@@ -205,9 +145,9 @@ PreviewImage.propTypes = {
   src: _propTypes.default.string,
   rotation: _propTypes.default.number,
   style: _propTypes.default.object,
-  maxZoom: _propTypes.default.number,
-  minZoom: _propTypes.default.number,
-  zoomStep: _propTypes.default.number,
+  // maxZoom: PropTypes.number,
+  // minZoom: PropTypes.number,
+  // zoomStep: PropTypes.number,
   zoom: _propTypes.default.number,
   ratio: _propTypes.default.string,
   disableDownload: _propTypes.default.bool,
@@ -218,8 +158,8 @@ PreviewImage.propTypes = {
   onError: _propTypes.default.func
 };
 PreviewImage.defaultProps = {
-  maxZoom: 5,
-  minZoom: 0.1,
-  zoomStep: 0.1,
+  // maxZoom: 5,
+  // minZoom: 0.1,
+  // zoomStep: 0.1,
   zoom: undefined
 };

package/lib/cjs/image/previewInner.d.ts

@@ -33,6 +33,8 @@ export default class PreviewInner extends BaseComponent<PreviewInnerProps, Previ
         disableDownload: PropTypes.Requireable<boolean>;
         viewerVisibleDelay: PropTypes.Requireable<number>;
         zIndex: PropTypes.Requireable<number>;
+        maxZoom: PropTypes.Requireable<number>;
+        minZoom: PropTypes.Requireable<number>;
         renderHeader: PropTypes.Requireable<(...args: any[]) => any>;
         renderPreviewMenu: PropTypes.Requireable<(...args: any[]) => any>;
         getPopupContainer: PropTypes.Requireable<(...args: any[]) => any>;
@@ -58,14 +60,20 @@ export default class PreviewInner extends BaseComponent<PreviewInnerProps, Previ
         zIndex: number;
         maskClosable: boolean;
         viewerVisibleDelay: number;
+        maxZoom: number;
+        minZoom: number;
     };
     private bodyOverflow;
     private scrollBarWidth;
     private originBodyWidth;
     get adapter(): PreviewInnerAdapter<PreviewInnerProps, PreviewInnerStates>;
-    timer: any;
     context: PreviewContextProps;
     foundation: PreviewInnerFoundation;
+    imageWrapRef: React.RefObject<HTMLDivElement>;
+    headerRef: React.RefObject<HTMLElement>;
+    footerRef: React.RefObject<HTMLElement>;
+    leftIconRef: React.RefObject<HTMLDivElement>;
+    rightIconRef: React.RefObject<HTMLDivElement>;
     constructor(props: PreviewInnerProps);
     static getDerivedStateFromProps(props: PreviewInnerProps, state: PreviewInnerStates): Partial<PreviewInnerStates>;
     componentDidMount(): void;
@@ -81,10 +89,11 @@ export default class PreviewInner extends BaseComponent<PreviewInnerProps, Previ
     handleZoomImage: (newZoom: number) => void;
     handleMouseUp: (e: any) => void;
     handleMouseMove: (e: any) => void;
-    handleMouseEvent: (e: any, event: string) => void;
     handleKeyDown: (e: KeyboardEvent) => void;
     onImageError: () => void;
     onImageLoad: (src: any) => void;
     handleMouseDown: (e: any) => void;
+    handleWheel: (e: any) => void;
+    registryImageWrapRef: (ref: any) => void;
     render(): JSX.Element;
 }

package/lib/cjs/image/previewInner.js

@@ -21,14 +21,6 @@ var _previewContext = require("./previewContext");
 var _utils = require("../_utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const prefixCls = _constants.cssClasses.PREFIX;
-let startMouseDown = {
-  x: 0,
-  y: 0
-};
-let mouseActiveTime = null;
-let stopTiming = false;
-let timer = null;
-// let bodyOverflowValue = document.body.style.overflow;
 class PreviewInner extends _baseComponent.default {
   get adapter() {
     return Object.assign(Object.assign({}, super.adapter), {
@@ -112,30 +104,22 @@ class PreviewInner extends _baseComponent.default {
       unregisterKeyDownListener: () => {
         window && window.removeEventListener("keydown", this.handleKeyDown);
       },
-      getMouseActiveTime: () => {
-        return mouseActiveTime;
-      },
-      getStopTiming: () => {
-        return stopTiming;
-      },
-      setStopTiming: value => {
-        stopTiming = value;
-      },
-      getStartMouseDown: () => {
-        return startMouseDown;
-      },
-      setStartMouseDown: (x, y) => {
-        startMouseDown = {
-          x,
-          y
-        };
-      },
-      setMouseActiveTime: time => {
-        mouseActiveTime = time;
-      },
       getSetDownloadFunc: () => {
         var _a, _b;
         return (_b = (_a = this.context) === null || _a === void 0 ? void 0 : _a.setDownloadName) !== null && _b !== void 0 ? _b : this.props.setDownloadName;
+      },
+      isValidTarget: e => {
+        const headerDom = this.headerRef && this.headerRef.current;
+        const footerDom = this.footerRef && this.footerRef.current;
+        const leftIconDom = this.leftIconRef && this.leftIconRef.current;
+        const rightIconDom = this.rightIconRef && this.rightIconRef.current;
+        const target = e.target;
+        if (headerDom && headerDom.contains(target) || footerDom && footerDom.contains(target) || leftIconDom && leftIconDom.contains(target) || rightIconDom && rightIconDom.contains(target)) {
+          // Move in the operation area, return false
+          return false;
+        }
+        // Move in the preview area except the operation area, return true
+        return true;
       }
     });
   }
@@ -168,9 +152,6 @@ class PreviewInner extends _baseComponent.default {
     this.handleMouseMove = e => {
       this.foundation.handleMouseMove(e);
     };
-    this.handleMouseEvent = (e, event) => {
-      this.foundation.handleMouseMoveEvent(e, event);
-    };
     this.handleKeyDown = e => {
       this.foundation.handleKeyDown(e);
     };
@@ -183,6 +164,31 @@ class PreviewInner extends _baseComponent.default {
     this.handleMouseDown = e => {
       this.foundation.handleMouseDown(e);
     };
+    this.handleWheel = e => {
+      this.foundation.handleWheel(e);
+    };
+    // 为什么通过 addEventListener 注册 wheel 事件而不是使用 onWheel 事件？
+    // 因为 Passive Event Listeners（https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#improving_scrolling_performance_with_passive_listeners）
+    // Passive Event Listeners 是一种优化技术，用于提高滚动性能。在默认情况下，浏览器会假设事件的监听器不会调用 
+    // preventDefault() 方法来阻止事件的默认行为，从而允许进行一些优化操作，例如滚动平滑。
+    // 对于 Image 而言，如果使用触控板，双指朝不同方向分开放大图片，则需要  preventDefault 防止页面整体放大。
+    // Why register wheel event through addEventListener instead of using onWheel event？
+    // Because of Passive Event Listeners(an optimization technique used to improve scrolling performance. By default, 
+    // the browser will assume that event listeners will not call preventDefault() method to prevent the default behavior of the event, 
+    // allowing some optimization operations such as scroll smoothing.)
+    // For Image, if we use the trackpad and spread your fingers in different directions to enlarge the image, we need to preventDefault
+    // to prevent the page from being enlarged as a whole.
+    this.registryImageWrapRef = ref => {
+      if (this.imageWrapRef) {
+        this.imageWrapRef.removeEventListener("wheel", this.handleWheel);
+      }
+      if (ref) {
+        ref.addEventListener("wheel", this.handleWheel, {
+          passive: false
+        });
+      }
+      this.imageWrapRef = ref;
+    };
     this.state = {
       imgSrc: [],
       imgLoadStatus: new Map(),
@@ -199,6 +205,11 @@ class PreviewInner extends _baseComponent.default {
     this.bodyOverflow = '';
     this.originBodyWidth = '100%';
     this.scrollBarWidth = 0;
+    this.imageWrapRef = null;
+    this.headerRef = /*#__PURE__*/_react.default.createRef();
+    this.footerRef = /*#__PURE__*/_react.default.createRef();
+    this.leftIconRef = /*#__PURE__*/_react.default.createRef();
+    this.rightIconRef = /*#__PURE__*/_react.default.createRef();
   }
   static getDerivedStateFromProps(props, state) {
     const willUpdateStates = {};
@@ -214,6 +225,9 @@ class PreviewInner extends _baseComponent.default {
       willUpdateStates.visible = props.visible;
       if (props.visible) {
         willUpdateStates.preloadAfterVisibleChange = true;
+        willUpdateStates.viewerVisible = true;
+        willUpdateStates.rotation = 0;
+        willUpdateStates.ratio = 'adaptation';
       }
     }
     if ("currentIndex" in props && props.currentIndex !== state.currentIndex) {
@@ -232,10 +246,8 @@ class PreviewInner extends _baseComponent.default {
     }
   }
   componentDidUpdate(prevProps, prevState) {
-    if (prevState.visible !== this.props.visible && this.props.visible) {
-      mouseActiveTime = new Date().getTime();
-      timer && clearInterval(timer);
-      timer = setInterval(this.viewVisibleChange, 1000);
+    if (prevProps.src !== this.props.src) {
+      this.foundation.updateTimer();
     }
     // hide => show
     if (!prevProps.visible && this.props.visible) {
@@ -247,7 +259,7 @@ class PreviewInner extends _baseComponent.default {
     }
   }
   componentWillUnmount() {
-    timer && clearInterval(timer);
+    this.foundation.clearTimer();
   }
   isInGroup() {
     return Boolean(this.context && this.context.isGroup);
@@ -312,10 +324,10 @@ class PreviewInner extends _baseComponent.default {
       style: style,
       onMouseDown: this.handleMouseDown,
       onMouseUp: this.handleMouseUp,
-      onMouseMove: this.handleMouseMove,
-      onMouseOver: e => this.handleMouseEvent(e.nativeEvent, "over"),
-      onMouseOut: e => this.handleMouseEvent(e.nativeEvent, "out")
+      ref: this.registryImageWrapRef,
+      onMouseMove: this.handleMouseMove
     }, /*#__PURE__*/_react.default.createElement(_previewHeader.default, {
+      ref: this.headerRef,
       className: (0, _classnames.default)(hideViewerCls),
       onClose: this.handlePreviewClose,
       renderHeader: renderHeader
@@ -326,7 +338,6 @@ class PreviewInner extends _baseComponent.default {
       setRatio: this.handleAdjustRatio,
       zoom: zoom,
       ratio: ratio,
-      zoomStep: zoomStep,
       rotation: rotation,
       crossOrigin: crossOrigin,
       onError: this.onImageError,
@@ -335,6 +346,7 @@ class PreviewInner extends _baseComponent.default {
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/click-events-have-key-events,jsx-a11y/no-static-element-interactions
     _react.default.createElement("div", {
+      ref: this.leftIconRef,
       className: (0, _classnames.default)(`${previewPrefixCls}-icon`, `${previewPrefixCls}-prev`, hideViewerCls),
       onClick: () => this.handleSwitchImage("prev")
     }, /*#__PURE__*/_react.default.createElement(_semiIcons.IconArrowLeft, {
@@ -343,11 +355,13 @@ class PreviewInner extends _baseComponent.default {
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/click-events-have-key-events,jsx-a11y/no-static-element-interactions
     _react.default.createElement("div", {
+      ref: this.rightIconRef,
       className: (0, _classnames.default)(`${previewPrefixCls}-icon`, `${previewPrefixCls}-next`, hideViewerCls),
       onClick: () => this.handleSwitchImage("next")
     }, /*#__PURE__*/_react.default.createElement(_semiIcons.IconArrowRight, {
       size: "large"
     })), /*#__PURE__*/_react.default.createElement(_previewFooter.default, {
+      forwardRef: this.footerRef,
       className: hideViewerCls,
       totalNum: total,
       curPage: currentIndex + 1,
@@ -406,6 +420,8 @@ PreviewInner.propTypes = {
   disableDownload: _propTypes.default.bool,
   viewerVisibleDelay: _propTypes.default.number,
   zIndex: _propTypes.default.number,
+  maxZoom: _propTypes.default.number,
+  minZoom: _propTypes.default.number,
   renderHeader: _propTypes.default.func,
   renderPreviewMenu: _propTypes.default.func,
   getPopupContainer: _propTypes.default.func,
@@ -430,5 +446,7 @@ PreviewInner.defaultProps = {
   preLoadGap: 2,
   zIndex: 1000,
   maskClosable: true,
-  viewerVisibleDelay: 10000
+  viewerVisibleDelay: 10000,
+  maxZoom: 5,
+  minZoom: 0.1
 };

package/lib/es/image/interface.d.ts

@@ -53,6 +53,8 @@ export interface PreviewProps extends BaseProps {
     zIndex?: number;
     children?: ReactNode;
     crossOrigin?: "anonymous" | "use-credentials";
+    maxZoom?: number;
+    minZoom?: number;
     renderHeader?: (info: any) => ReactNode;
     renderPreviewMenu?: (props: MenuProps) => ReactNode;
     getPopupContainer?: () => HTMLElement;
@@ -138,14 +140,12 @@ export interface FooterProps extends SliderProps {
     onRotate?: (direction: string) => void;
     onDownload?: () => void;
     renderPreviewMenu?: (props: MenuProps) => ReactNode;
+    forwardRef?: React.RefObject<HTMLElement>;
 }
 export interface PreviewImageProps {
     src?: string;
     rotation?: number;
     style?: React.CSSProperties;
-    maxZoom?: number;
-    minZoom?: number;
-    zoomStep?: number;
     zoom?: number;
     ratio?: RatioType;
     disableDownload?: boolean;

package/lib/es/image/previewFooter.js

@@ -12,14 +12,9 @@ import PreviewFooterFoundation from '@douyinfe/semi-foundation/lib/es/image/prev
 import LocaleConsumer from "../locale/localeConsumer";
 const prefixCls = cssClasses.PREFIX;
 const footerPrefixCls = `${cssClasses.PREFIX}-preview-footer`;
-let mouseActiveTime = 0;
 export default class Footer extends BaseComponent {
   get adapter() {
-    return Object.assign(Object.assign({}, super.adapter), {
-      setStartMouseOffset: time => {
-        mouseActiveTime = time;
-      }
-    });
+    return Object.assign({}, super.adapter);
   }
   constructor(props) {
     super(props);
@@ -259,13 +254,15 @@ export default class Footer extends BaseComponent {
   render() {
     const {
       className,
-      renderPreviewMenu
+      renderPreviewMenu,
+      forwardRef
     } = this.props;
     const menuCls = cls(footerPrefixCls, `${footerPrefixCls}-wrapper`, className, {
       [`${footerPrefixCls}-content`]: !Boolean(renderPreviewMenu)
     });
     return /*#__PURE__*/React.createElement("section", {
-      className: menuCls
+      className: menuCls,
+      ref: forwardRef
     }, renderPreviewMenu ? this.customRenderViewMenu() : this.getFooterMenu());
   }
 }

package/lib/es/image/previewHeader.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import React from "react";
 import { HeaderProps } from "./interface";
-declare const Header: React.FC<HeaderProps>;
+declare const Header: React.ForwardRefExoticComponent<HeaderProps & React.RefAttributes<HTMLElement>>;
 export default Header;