@arco-design/mobile-react 2.31.6 → 2.32.0

package/esnext/image-preview/index.js

@@ -0,0 +1,794 @@
+import React, { useRef, forwardRef, useImperativeHandle, useEffect, useState, } from 'react';
+import { nextTick, componentWrapper, preventEleScroll, freeEleScroll, cls, } from '@arco-design/mobile-utils';
+import TransformAble from '@arco-design/transformable';
+import { ContextLayout, CompWithGlobalContext } from '../context-provider';
+import Carousel from '../carousel';
+import Transition from '../transition';
+import BaseImage from '../image';
+import { useWindowSize, useRefState, usePopupScroll, getStyleWithVendor, useSystem, useSingleAndDoubleClick, } from '../_helpers';
+import Portal from '../portal';
+import { open } from './methods';
+import Loading from '../loading';
+export * from './methods';
+const MAX_ZOOM = 5;
+const MIN_ZOOM = 0.7;
+const ImagePreview = forwardRef((props, ref) => {
+    const { style, className, images, loop = false, openIndex, fit, noselect = true, displayDuration = 350, spaceBetween = 0, showLoading = true, loadingArea, errorArea, showError = true, retryTime, staticLabel, replaceFallbackWhenLoaded, scrollBezier, lazyloadCount = 1, swipeToClose = true, extra, getMinScale, getMaxScale, getDoubleClickScale, getContainer, getThumbBounds, renderIndicator, onChange, onAfterChange, onImageClick, onImageDoubleClick, onImageLongTap, close, onClose, onTouchStart, onTouchMove, onTouchEnd, indicatorPos = 'start', ...otherProps } = props;
+    const system = useSystem();
+    const domRef = useRef(null);
+    const imagesRef = useRef([]);
+    const carouselRef = useRef(null);
+    const transformersRef = useRef([]);
+    const longTimerRef = useRef(null);
+    const transImageRef = useRef(null);
+    const imageDomsRef = useRef([]);
+    const touchStartXRef = useRef(0);
+    const startTouchingSideRef = useRef(false);
+    const movedRef = useRef(false);
+    const dblClickingRef = useRef(false);
+    const longTapCheckingRef = useRef(false);
+    const innerIndexRef = useRef(openIndex);
+    const touchingSideDisRef = useRef(0);
+    const lastScaleRef = useRef(0);
+    const closingRef = useRef(false);
+    const isInitialMount = useRef(false);
+    const [showPlaceholders, setPlaceholders] = useState({});
+    const [imagesStatus, imagesStatusRef, setImagesStatus] = useRefState([]);
+    const [transImageInfo, setTransImageInfo] = useState(null);
+    const openLoaded = imagesStatus[openIndex]?.loaded;
+    const openAnimated = imagesStatus[openIndex]?.animated;
+    const visible = openIndex >= 0 && openIndex < images.length;
+    const { windowWidth, windowHeight } = useWindowSize(true);
+    useImperativeHandle(ref, () => ({
+        dom: domRef.current,
+        imageDoms: imageDomsRef.current,
+    }));
+    usePopupScroll(visible, domRef.current, () => [], 'top', handlePreventCallback);
+    useEffect(() => {
+        if (visible) {
+            innerIndexRef.current = openIndex;
+            closingRef.current = false;
+            carouselRef.current && carouselRef.current.changeIndex(openIndex, true);
+            setImagesStatus(images.map((_, index) => ({
+                firstLoaded: imagesStatusRef.current[index]?.firstLoaded || false,
+                animated: index !== openIndex,
+            })));
+            setDisplayAnimation(openIndex);
+        }
+        else {
+            // 移除长按事件监听
+            // @en Remove long press event listener
+            longTimerRef.current && clearTimeout(longTimerRef.current);
+            longTapCheckingRef.current = false;
+            // 图片状态重置
+            // @en Reset image state
+            setImagesStatus(imagesStatusRef.current.map(status => ({
+                ...status,
+                animated: false,
+                loaded: false,
+            })));
+            transformersRef.current = [];
+            // 移除过渡图片
+            // @en Remove transition image
+            removeChild(transImageRef.current);
+            setTransImageInfo(null);
+            setPlaceholders({});
+            const mounted = isInitialMount.current;
+            setTimeout(() => {
+                mounted && onClose && onClose();
+            }, displayDuration);
+        }
+        isInitialMount.current = true;
+    }, [visible]);
+    useEffect(() => {
+        if (visible && openLoaded && openAnimated) {
+            setTimeout(() => {
+                removeChild(transImageRef.current);
+                transImageRef.current = null;
+            }, 100);
+        }
+    }, [visible, openLoaded, openAnimated]);
+    useEffect(() => {
+        // 执行过渡动画时避免滚动穿透
+        // @en Avoid scroll penetration when performing transition animation
+        if (transImageInfo) {
+            preventEleScroll();
+        }
+        else {
+            nextTick(() => {
+                freeEleScroll();
+            });
+        }
+    }, [transImageInfo]);
+    useEffect(() => {
+        (transformersRef.current || []).forEach((transformer, index) => {
+            transformer && transformer.setMinScale(getImageMinScale(index));
+        });
+    }, [getMinScale]);
+    useEffect(() => {
+        (transformersRef.current || []).forEach((transformer, index) => {
+            transformer && transformer.setMaxScale(getImageMaxScale(index));
+        });
+    }, [getMaxScale]);
+    function removeChild(child) {
+        try {
+            child &&
+                domRef.current
+                    ?.querySelectorAll('.carousel-item')?.[innerIndexRef.current]?.removeChild(child);
+        }
+        catch (e) { }
+    }
+    // 监听滑动到上下边缘后还在往外滑动的操作，则关闭弹窗
+    // @en Monitor the operation of sliding out after sliding to the upper and lower edges, then close the popup
+    function handlePreventCallback(_, dir) {
+        if (!isTransforming() && dir === 'y') {
+            touchingSideDisRef.current += 1;
+        }
+    }
+    /**
+     * 缩放插件初始化
+     * @en Zoom plugin initialization
+     */
+    function initTransformer(index) {
+        const imageDom = imagesRef.current[index]?.dom;
+        const wrapDom = imageDom?.parentElement;
+        if (!imageDom || !wrapDom) {
+            return;
+        }
+        if (transformersRef.current[index]) {
+            transformersRef.current[index].setDom(wrapDom);
+        }
+        else {
+            // 缩放插件中对长图的处理：放大状态为模拟手势滚动，还原状态为真实滚动
+            // @en The processing of long images in the zoom plugin: the zoomed state is simulated gesture scrolling, and the restored state is real scrolling
+            transformersRef.current[index] = new TransformAble({
+                // wrapDom为无transform和transition的纯净容器
+                // @en wrapDom is a pure container without transform and transition
+                dom: wrapDom,
+                motionThreshold: 0,
+                dragMode: 'always',
+                transformMode: 'matrix',
+                useDomBoundary: false,
+                preventScroll: false,
+                cubic: {
+                    scroll: scrollBezier,
+                },
+                onTransform: () => {
+                    // 图片放大再缩小，解决ios图片放大后模糊的问题
+                    // @en The image is zoomed in and then zoomed out to solve the problem of blurring after zooming in on ios images
+                    const img = imageDomsRef.current[index];
+                    const trans = transformersRef.current[index]?.getTransform?.() || {};
+                    const width = imagesStatusRef.current[index]?.originWidth;
+                    const height = imagesStatusRef.current[index]?.originHeight;
+                    const scale = trans.scale || 1;
+                    // 判断下只有图片缩放发生改变时重写图片样式
+                    // @en It is judged that only the image style is rewritten when the zoom of the image changes.
+                    if (img && width && height && lastScaleRef.current !== scale) {
+                        lastScaleRef.current = scale;
+                        const atCenter = !imageHasOverflow(img) ? ' translateY(-50%)' : '';
+                        img.style.width = `${width * scale}px`;
+                        img.style.height = `${height * scale}px`;
+                        const transform = `scale(${1 / scale}) translateZ(0)${atCenter}`;
+                        img.style.transform = transform;
+                        img.style.webkitTransform = transform;
+                        img.style.transformOrigin = 'top left';
+                        img.style.webkitTransformOrigin = 'top left';
+                    }
+                },
+                onRestore: () => {
+                    lastScaleRef.current = 0;
+                },
+                onZoomEnd: (_1, _2, pinchStartCenter) => {
+                    setPlaceholders(holders => ({ ...holders, [index]: false }));
+                    const image = imageDomsRef.current[index];
+                    const transformer = transformersRef.current[index];
+                    if (!image || !transformer || transformer.getTransform().scale < 1) {
+                        return;
+                    }
+                    const imageRect = image.getBoundingClientRect();
+                    if (imageRect.width > windowWidth && imageRect.height > windowHeight) {
+                        if (pinchStartCenter && pinchStartCenter.length) {
+                            transformer.setCenter(...pinchStartCenter);
+                        }
+                        transformer.setFixedX(false);
+                        transformer.setFixedY(false);
+                    }
+                    else if (imageRect.height <= windowHeight) {
+                        if (!transformer.fixedY) {
+                            transformer.setFixedY(true);
+                            transformer.bounce();
+                        }
+                    }
+                    else if (imageRect.width <= windowWidth) {
+                        if (!transformer.fixedX) {
+                            transformer.setFixedX(true);
+                            transformer.bounce();
+                        }
+                    }
+                },
+                minScale: getImageMinScale(index),
+                maxScale: getImageMaxScale(index),
+            });
+        }
+        setOriginBoundary(index);
+    }
+    function imageHasOverflow(img) {
+        return Boolean(img && !img.classList.contains('preview-fit-contain-y'));
+    }
+    function setOriginBoundary(index) {
+        const imageEle = imagesRef.current[index];
+        const imageDom = imageEle?.dom;
+        // 边界范围变为图片范围和容器范围的并集
+        // @en The bounding range becomes the union of the image range and the container range
+        if (imageDom?.parentElement && imageEle?.image) {
+            const rect = imageEle.image.getBoundingClientRect();
+            const eleRect = imageDom.parentElement.getBoundingClientRect();
+            if (transformersRef.current[index]) {
+                transformersRef.current[index].setBoundary({
+                    left: Math.min(rect.left, eleRect.left),
+                    right: Math.max(rect.right, eleRect.right),
+                    top: Math.min(rect.top, eleRect.top),
+                    bottom: Math.max(rect.bottom, eleRect.bottom),
+                }, true);
+            }
+        }
+    }
+    /**
+     * 获取最小缩放倍数
+     * @en Get the minimum zoom factor
+     */
+    function getImageMinScale(index) {
+        const currentIndex = index === void 0 ? innerIndexRef.current : index;
+        const imageDom = imageDomsRef.current[currentIndex];
+        if (!imageDom) {
+            return 1;
+        }
+        if (getMinScale) {
+            return getMinScale(imageDom, currentIndex);
+        }
+        return MIN_ZOOM;
+    }
+    /**
+     * 获取最大缩放倍数
+     * @en Get the maximum zoom factor
+     */
+    function getImageMaxScale(index) {
+        const currentIndex = index === void 0 ? innerIndexRef.current : index;
+        const imageDom = imageDomsRef.current[currentIndex];
+        if (!imageDom) {
+            return 1;
+        }
+        if (getMaxScale) {
+            return getMaxScale(imageDom, currentIndex);
+        }
+        const imageWidth = imageDom.naturalWidth;
+        const imageHeight = imageDom.naturalHeight;
+        let maxScale = 1;
+        if (imageWidth > imageHeight) {
+            maxScale = (imageWidth / windowWidth) * MAX_ZOOM;
+        }
+        else {
+            maxScale = Math.max(MAX_ZOOM, imageWidth / windowWidth);
+        }
+        return maxScale;
+    }
+    /**
+     * 计算双击时图片缩放倍数
+     * @en Calculate the zoom factor of the image when double-clicking
+     */
+    function getImageDoubleClickScale(currentScale) {
+        const index = innerIndexRef.current;
+        const imageDom = imageDomsRef.current[index];
+        if (!imageDom) {
+            return 1;
+        }
+        const maxScale = getImageMaxScale(index);
+        if (getDoubleClickScale) {
+            return getDoubleClickScale(currentScale, maxScale, imageDom, index);
+        }
+        const imageWidth = imageDom.naturalWidth;
+        const imageHeight = imageDom.naturalHeight;
+        const fitScale = imageWidth > imageHeight
+            ? ((imageWidth / windowWidth) * windowHeight) / imageHeight
+            : 1;
+        let dblScale = 2;
+        if (fitScale >= 2) {
+            dblScale = Math.min(maxScale, fitScale);
+        }
+        const current = Number(currentScale.toFixed(3));
+        const dbl = Number(dblScale.toFixed(3));
+        return current >= 1 && current < dbl ? dbl : 1;
+    }
+    /**
+     * 还原缩放至原始位置
+     * @en Revert zoom to original position
+     */
+    function restoreTransformer(index) {
+        const transformer = transformersRef.current[index];
+        if (transformer) {
+            transformer.restore();
+        }
+    }
+    /**
+     * 是否正处于缩放状态
+     * @en Whether it is zooming
+     */
+    function isTransforming(index) {
+        const currentIndex = index === void 0 ? innerIndexRef.current : index;
+        return transformersRef.current[currentIndex]?.busy?.();
+    }
+    /**
+     * 是否已经放大过
+     * @en Whether is has been zoomed in
+     */
+    function isTransformed() {
+        return transformersRef.current[innerIndexRef.current]?.dirty?.();
+    }
+    function isTapStop() {
+        return transformersRef.current[innerIndexRef.current]?.isTapStop?.();
+    }
+    /**
+     * 计算距离左右侧的距离，如果为0说明到边缘了，可以进行正常轮播操作
+     * @en Calculate the distance from the left and right sides. If it is 0, it means that the edge is reached, and the normal rotation operation can be performed.
+     */
+    function transformTouchSide() {
+        const transformer = transformersRef.current[innerIndexRef.current];
+        const toLeft = transformer?.toLeft?.();
+        const toRight = transformer?.toRight?.();
+        return {
+            side: !toLeft || !toRight,
+            left: !toLeft,
+            right: !toRight,
+        };
+    }
+    function handleImageWrapTouchStart(e) {
+        if (onTouchStart && onTouchStart(e, innerIndexRef.current)) {
+            return true;
+        }
+        const { touches } = e;
+        touchStartXRef.current = e.touches && e.touches[0] ? e.touches[0].clientX : 0;
+        movedRef.current = false;
+        dblClickingRef.current = false;
+        // 单点长按才触发长按
+        // @en A single long press triggers a long press
+        if (touches.length === 1) {
+            if (!closingRef.current) {
+                longTapCheckingRef.current = true;
+            }
+            longTimerRef.current = window.setTimeout(() => {
+                if (longTapCheckingRef.current) {
+                    longTapCheckingRef.current = false;
+                    movedRef.current = true;
+                    onImageLongTap &&
+                        onImageLongTap(innerIndexRef.current, imageDomsRef.current[innerIndexRef.current], e);
+                }
+            }, 300);
+        }
+        else {
+            longTapCheckingRef.current = false;
+        }
+        if (isTapStop()) {
+            movedRef.current = true;
+        }
+        // 缩放状态下，未到边缘时不触发轮播手势
+        // @en In the zoomed state, the carousel gesture is not triggered when the edge is not reached
+        if (isTransforming()) {
+            startTouchingSideRef.current = transformTouchSide().side;
+            return !startTouchingSideRef.current;
+        }
+    }
+    function handleImageWrapTouchMove(e) {
+        movedRef.current = true;
+        longTapCheckingRef.current = false;
+        longTimerRef.current && clearTimeout(longTimerRef.current);
+        if (onTouchMove && onTouchMove(e, innerIndexRef.current)) {
+            return true;
+        }
+        const evt = e.changedTouches[0];
+        const touchMoveX = evt.clientX || 0;
+        const posDisX = touchMoveX - touchStartXRef.current;
+        // 缩放状态下，到边缘时如果还在往外滑动，则触发轮播手势
+        // @en In the zoomed state, if it is still swiped out when reaching the edge, the carousel gesture is triggered
+        if (isTransforming()) {
+            const sideInfo = transformTouchSide();
+            return (!startTouchingSideRef.current ||
+                !((sideInfo.left && posDisX > 0) || (sideInfo.right && posDisX < 0)));
+        }
+    }
+    function handleImageWrapTouchEnd(e) {
+        if (onTouchEnd && onTouchEnd(e, innerIndexRef.current)) {
+            return true;
+        }
+        // 滑动到上下边缘后还在往外滑动，则关闭弹窗
+        // @en After sliding to the upper and lower edges and still sliding outwards, close the popup box
+        // needClose为触发touchmove的次数，6和3是相对值，表示判断在往外滑动的敏感度，当未放大时对向外滑动手势更敏感
+        // @en needClose is the number of times the touchmove is triggered, 6 and 3 are relative values, indicating the sensitivity of judging the outward sliding, and it is more sensitive to the outward sliding gesture when it is not zoomed in
+        const needClose = swipeToClose && touchingSideDisRef.current >= (isTransformed() ? 6 : 3);
+        touchingSideDisRef.current = 0;
+        longTapCheckingRef.current = false;
+        longTimerRef.current && clearTimeout(longTimerRef.current);
+        if (needClose) {
+            goClose(e);
+            return true;
+        }
+        // 缩放状态下，未到边缘时不触发轮播手势
+        // @en In the zoomed state, the carousel gesture is not triggered when the edge is not reached
+        if (isTransforming() && !transformTouchSide().side) {
+            return true;
+        }
+    }
+    function handleImageClick(e) {
+        if (movedRef.current) {
+            return;
+        }
+        // 如果正在触发doubleClick就不触发click
+        // @en If doubleClick is being triggered, click will not be triggered
+        if (!dblClickingRef.current) {
+            if (!onImageClick || !onImageClick(innerIndexRef.current, e)) {
+                goClose(e);
+            }
+        }
+    }
+    function handleImageDoubleClick(e) {
+        if (dblClickingRef.current) {
+            // 防止重复触发dblclick
+            return;
+        }
+        dblClickingRef.current = true;
+        const index = innerIndexRef.current;
+        onImageDoubleClick && onImageDoubleClick(index, e);
+        // 双击时根据配置放大或缩小
+        // @en Zoom in or out according to configuration when double-clicking
+        const transformer = transformersRef.current[index];
+        if (transformer) {
+            const trans = transformer.getTransform();
+            const rate = trans.scale || 1;
+            const dblScale = getImageDoubleClickScale(rate);
+            if (dblScale === 1) {
+                const img = imageDomsRef.current[index];
+                // 长图双击还原缩放特殊处理，因为transform和scroll不能完全同步，所以先zoomTo到原点再restore
+                // @en Double-click the long image to restore zoom special processing, because transform and scroll cannot be completely synchronized, so first zoomTo to the origin and then restore
+                if (imageHasOverflow(img)) {
+                    transformer.zoomToScreenCenter(1, [windowWidth / 2, windowHeight / 2], {
+                        duration: 200,
+                        callback: () => transformer.restore(),
+                    });
+                }
+                else {
+                    transformer.bounce();
+                    transformer.restore();
+                }
+            }
+            else {
+                transformer.zoomToScreenCenter(dblScale, [windowWidth / 2, windowHeight / 2], {
+                    duration: 200,
+                    silent: false,
+                });
+            }
+        }
+    }
+    const handleClick = useSingleAndDoubleClick(handleImageClick, handleImageDoubleClick);
+    // 当使用 getThumbBounds 时，关闭图片预览有缩小效果
+    // @en When using getThumbBounds, closing the image preview has a shrinking effect
+    function animateBeforeClose() {
+        if (isTransformed()) {
+            return;
+        }
+        const index = innerIndexRef.current;
+        const imageDom = imagesRef.current[index]?.image;
+        const thumbBounds = getThumbBounds?.(index);
+        if (!imageDom || !thumbBounds || !thumbBounds.width || !thumbBounds.height) {
+            return;
+        }
+        // 小图超过一半在视野外时，不展示缩小效果
+        // @en When more than half of the thumbnail is outside the field of view, the zoom effect will not be displayed
+        if (thumbBounds.top < (-1 * thumbBounds.height) / 2 ||
+            thumbBounds.top > windowHeight - thumbBounds.height / 2 ||
+            thumbBounds.left < (-1 * thumbBounds.width) / 2 ||
+            thumbBounds.left > windowWidth - thumbBounds.width / 2) {
+            return;
+        }
+        const imageDomRect = imageDom.getBoundingClientRect();
+        if (!imageDomRect.width || !imageDomRect.height) {
+            return;
+        }
+        imageDom.classList.add('closing-animation');
+        setImageBounds(imageDom, imageDomRect, imageDomRect);
+        imageDom.style.objectPosition = images[index].thumbPosition || 'top center';
+        nextTick(() => {
+            imageDom.style.transitionDuration = `${displayDuration}ms`;
+            imageDom.style.webkitTransitionDuration = `${displayDuration}ms`;
+            setImageBounds(imageDom, thumbBounds, imageDomRect);
+        });
+    }
+    function goClose(e) {
+        if (closingRef.current) {
+            return;
+        }
+        closingRef.current = true;
+        animateBeforeClose();
+        close(e);
+    }
+    /**
+     * 更改指定图片状态
+     * @en Change specified image status
+     */
+    function setImagesStatusByIndex(index, data) {
+        setImagesStatus(current => {
+            const newStatus = current.slice();
+            newStatus[index] = {
+                ...(newStatus[index] || {}),
+                ...data,
+            };
+            return newStatus;
+        });
+    }
+    /**
+     * 缩略图放大过渡动画设置
+     * @en Set thumbnail zoom transition animation
+     */
+    function setDisplayAnimation(index) {
+        const firstLoaded = imagesStatusRef.current[index]?.firstLoaded;
+        const fallbackSrc = replaceFallbackWhenLoaded && firstLoaded
+            ? images[index].src
+            : images[index].fallbackSrc;
+        // 用户设置了getThumbBounds和images的fallbackSrc属性才有放大过渡效果
+        // @en Set the fallbackSrc attribute of getThumbBounds and images to have a zoom-in transition effect
+        if (!getThumbBounds || !images[index] || !fallbackSrc) {
+            resetAnimation(index);
+            return;
+        }
+        // 获取缩略图的rect，如果没获取到就取消放大过渡效果
+        // @en Get the rect of the thumbnail, if it is gotten, cancel the zoom transition effect
+        const thumbBounds = getThumbBounds(index);
+        if (!thumbBounds || !thumbBounds.width || !thumbBounds.height) {
+            resetAnimation(index);
+            return;
+        }
+        // 伪造一个fixed的图做小图放大效果
+        // @en Forge a fixed image to make a small image enlargement effect
+        const transImage = new Image();
+        transImageRef.current = transImage;
+        transImage.classList.add('image-preview-fake-trans-image');
+        setImageBounds(transImage, thumbBounds, thumbBounds);
+        transImage.src = fallbackSrc;
+        transImage.style.objectPosition = images[index].thumbPosition || 'top center';
+        transImage.style.opacity = '0';
+        transImage.style.transitionDuration = `${displayDuration}ms`;
+        transImage.style.webkitTransitionDuration = `${displayDuration}ms`;
+        domRef.current?.querySelectorAll('.carousel-item')?.[index]?.prepend(transImage);
+        // 拿到放大之后的位置rect，没拿到就取消小图放大效果
+        // @en Get the zoomed-in position rect, and cancel the zoom-in effect if not getting it
+        getNewImageBounds(index, fallbackSrc, transImage, rect => {
+            if (!rect || !rect.width || !rect.height) {
+                removeChild(transImage);
+                resetAnimation(index);
+                return;
+            }
+            // 通过小图rect变换到大图rect加transition做放大效果
+            // @en Transform the small image rect to the large image rect and add transition to make a magnification effect
+            nextTick(() => {
+                transImage.style.opacity = '1';
+                setImageBounds(transImage, rect, thumbBounds);
+                setTimeout(() => {
+                    setPlaceholders(holders => ({ ...holders, [index]: true }));
+                }, Math.max(0, displayDuration - 80));
+                const transitionEndDelay = images[index].transitionEndDelay || 30;
+                setTimeout(() => {
+                    resetAnimation(index);
+                }, displayDuration + transitionEndDelay);
+            });
+        });
+    }
+    /**
+     * 取消小图放大过渡效果
+     * @en Cancel the thumbnail zoom transition effect
+     */
+    function resetAnimation(index) {
+        setImagesStatusByIndex(index, { animated: true });
+        setTransImageInfo(null);
+    }
+    /**
+     * 根据rect设置图片的位置
+     * @en Set the position of the image according to the rect
+     */
+    function setImageBounds(image, rect, thumbRect) {
+        // 这里为保持原有比例，只设置宽度变化，高度会随宽度等比变化
+        image.style.width = `${thumbRect.width}px`;
+        const transform = `translate3d(${rect.left}px, ${rect.top}px, 0) scale(${rect.width / thumbRect.width}`;
+        image.style.transform = transform;
+        image.style.webkitTransform = transform;
+        image.style.transformOrigin = 'left top';
+        image.style.webkitTransformOrigin = 'left top';
+    }
+    /**
+     * 计算放大之后的位置rect
+     * @en Calculate the position rect after zooming in
+     */
+    function getNewImageBounds(index, transSrc, transImage, callback) {
+        if (!transSrc) {
+            callback(null);
+            return;
+        }
+        setTransImageInfo({
+            src: transSrc,
+            fit: images[index].fit,
+            index,
+            movingImage: transImage,
+            onLoad: (_, image) => {
+                setTimeout(() => {
+                    callback(image.getBoundingClientRect());
+                }, 20);
+            },
+            onError: () => callback(null),
+        });
+    }
+    /**
+     * @en 渲染轮播+图片展示
+     * Rendering carousel + displaying image
+     */
+    function renderContent(carouselProps, allImages, getImageProps) {
+        return (React.createElement(Carousel, Object.assign({ autoPlay: false, loop: loop, lazyloadCount: lazyloadCount, stopPropagation: false }, carouselProps), (allImages || []).map((image, index) => {
+            const innerNode = (React.createElement("div", { key: index, className: "preview-image-wrap", style: { padding: `0 ${spaceBetween}px` } },
+                React.createElement(BaseImage, Object.assign({ className: "preview-image", fit: image.fit || fit || 'preview-y', boxWidth: windowWidth - spaceBetween * 2, boxHeight: windowHeight, bottomOverlap: null }, getImageProps(image, index)))));
+            return (React.createElement("div", { className: "preview-image-wrap-container", key: `outer-${index}` },
+                innerNode,
+                image.extraNode));
+        })));
+    }
+    function getImageClass(index) {
+        const { loaded, animated } = imagesStatus[index] || {};
+        return cls('preview-image', {
+            'preview-hidden': index === openIndex && (!loaded || !animated),
+        });
+    }
+    /**
+     * 每张图片的样式
+     * @en style of each image
+     */
+    function getImageStyle() {
+        // 因为缩放的容器必须是没有transform和transition的纯净元素
+        // @en Because the scaled container must be a pure element without transform and transition
+        // 所以这里强制设置overflow为visible，溢出滚动的部分交由外层来做
+        // @en So it is forced to set overflow to visible, and the part of overflow scrolling is left to the outer layer.
+        return {
+            overflow: 'visible',
+        };
+    }
+    // 渲染轮播指引器
+    function renderPreviewIndicator(currentIndex, total, lastIndex) {
+        if (renderIndicator) {
+            return renderIndicator(currentIndex, total, lastIndex);
+        }
+        return openLoaded ? (React.createElement(Portal, { getContainer: getContainer },
+            React.createElement("div", { className: "image-preview-indicator" },
+                currentIndex + 1,
+                "/",
+                total))) : null;
+    }
+    // ios在重设style时图片会消失一下造成闪动，因此在底下垫一张图
+    // @en In iOS when resetting the style, the image will disappear and cause flickering, so put a image at the bottom
+    // 优先过渡图，其次用原图
+    // @en Prioritize the transition image, followed by the original image
+    function renderImagePlaceholder(src, index, fitCss) {
+        const { originWidth, originHeight, originLeft, originTop, hasOverflow } = imagesStatus[index] || {};
+        const trans = hasOverflow ? {} : getStyleWithVendor({ transform: 'translateY(-50%)' });
+        const fitObj = fitCss ? { objectFit: fitCss } : {};
+        return system === 'ios' && showPlaceholders[index] && originWidth && originHeight ? (React.createElement("img", { src: src, style: {
+                position: 'absolute',
+                width: originWidth,
+                height: originHeight,
+                left: originLeft,
+                top: originTop,
+                ...fitObj,
+                ...trans,
+            } })) : null;
+    }
+    function renderLoadingArea() {
+        return (React.createElement("div", { className: "image-preview-loading-area" }, loadingArea || React.createElement(Loading, { type: "circle", className: "loading-icon", radius: 7 })));
+    }
+    return (React.createElement(ContextLayout, null, ({ prefixCls }) => (React.createElement(Portal, { getContainer: getContainer },
+        React.createElement(Transition, { in: visible, timeout: displayDuration, type: "fade", mountOnEnter: true, unmountOnExit: true, nodeRef: domRef },
+            React.createElement("div", { className: cls(`${prefixCls}-image-preview`, 'all-border-box', { noselect }, className), style: style, ref: domRef, onClick: handleClick, onDoubleClick: handleImageDoubleClick },
+                renderContent({
+                    indicatorPos,
+                    initialIndex: openIndex,
+                    ref: carouselRef,
+                    renderIndicator: renderPreviewIndicator,
+                    onChange: index => {
+                        innerIndexRef.current = index;
+                        onChange && onChange(index);
+                    },
+                    onAfterChange: (index, oldIndex) => {
+                        onAfterChange && onAfterChange(index);
+                        restoreTransformer(oldIndex);
+                        nextTick(() => {
+                            initTransformer(innerIndexRef.current);
+                        });
+                    },
+                    onTouchMove: handleImageWrapTouchMove,
+                    onTouchStart: handleImageWrapTouchStart,
+                    onTouchEnd: handleImageWrapTouchEnd,
+                    ...otherProps,
+                }, images, (image, index) => ({
+                    src: image.src,
+                    ref: r => {
+                        imagesRef.current[index] = r;
+                    },
+                    showLoading,
+                    loadingArea: renderLoadingArea(),
+                    errorArea,
+                    showError,
+                    retryTime,
+                    staticLabel,
+                    animateDuration: transImageInfo ? 0 : void 0,
+                    style: getImageStyle(),
+                    className: getImageClass(index),
+                    bottomOverlap: renderImagePlaceholder(image.fallbackSrc || image.src, index, image.fit || fit),
+                    onLoad: (_, imageEle) => {
+                        imageDomsRef.current[index] = imageEle;
+                        setImagesStatusByIndex(index, {
+                            loaded: true,
+                            firstLoaded: true,
+                            originWidth: imageEle.offsetWidth,
+                            originHeight: imageEle.offsetHeight,
+                            originTop: imageEle.offsetTop,
+                            originLeft: imageEle.offsetLeft,
+                            hasOverflow: imageHasOverflow(imageEle),
+                        });
+                        if (index === openIndex) {
+                            initTransformer(index);
+                        }
+                        else {
+                            setPlaceholders(holders => ({
+                                ...holders,
+                                [index]: true,
+                            }));
+                        }
+                    },
+                    onError: () => {
+                        imageDomsRef.current[index] = null;
+                        if (index === openIndex) {
+                            const transImage = transImageInfo?.movingImage;
+                            removeChild(transImage);
+                            setImagesStatusByIndex(index, {
+                                animated: true,
+                                loaded: true,
+                            });
+                            setTransImageInfo(null);
+                        }
+                    },
+                })),
+                transImageInfo ? (React.createElement("div", { className: "image-preview-fake-rect" }, renderContent({
+                    initialIndex: 0,
+                }, [{ src: transImageInfo.src, fit: transImageInfo.fit }], () => ({
+                    staticLabel,
+                    src: transImageInfo.src,
+                    animateDuration: 0,
+                    onLoad: transImageInfo.onLoad,
+                    onError: transImageInfo.onError,
+                })))) : null,
+                extra)),
+        transImageInfo ? (React.createElement("div", { className: "image-preview-lock-modal", onClick: goClose })) : null))));
+});
+export function methodsGenerator(Comp) {
+    return {
+        /**
+         * 打开图片预览
+         * @desc {en} Open image preview
+         * @param {ImagePreviewProps} config configuration
+         * @returns {{ close: () => void; update: (newConfig: ImagePreviewProps) => void; }}
+         */
+        open: open(Comp),
+    };
+}
+const ImagePreviewWithGlobalContext = CompWithGlobalContext(ImagePreview);
+/**
+ * 图片预览组件，支持循环轮播、双指/双击缩放、缩略图放大效果。
+ * @en The image preview, supports circular rotation, two-finger/double-tap zoom, and thumbnail zoom effects.
+ * @type 信息展示
+ * @type_en Data Display
+ * @name 图片预览
+ * @name_en ImagePreview
+ */
+export default componentWrapper(ImagePreview, methodsGenerator(ImagePreviewWithGlobalContext));