当前位置：首页 > news >正文

React实现多图片预览功能、预览图上下张切换（实战示例）

news 2025/8/26 6:41:54

前言

在React项目中，展示和预览多张图片是一种常见的需求。本篇帖子将介绍如何使用React和antd库来实现这一功能，并探讨如何在预览模态框中切换到前一张或后一张图片。

背景

我们将以一个OCR图像列表展示的示例来演示代码的运用。假设我们有一个OCR系统，可以将图片文件中的文本提取出来。我们希望在前端展示从OCR系统返回的图像列表，并支持点击图片来进行预览。此外，我们还希望在预览模态框中能够实现切换到前一张或后一张图片的功能。下面是具体的操作示例：

操作示例：

首先，我们需要导入所需的组件和hooks:

import React, { useEffect, useState } from 'react';
import { Row, Col, Modal} from 'antd';

接下来，我们定义一个Splitor组件，该组件将用于展示多张图片和实现预览功能：

const Splitor: React.FC = () => {const [ocrImageList, setOcrImageList] = useState<ETEST.ImageInfo[]>([]); // 图片列表的状态const [visible, setVisible] = useState(false); // 大图预览的可见性状态const [currentImage, setCurrentImage] = useState(""); // 当前点击的图片路径useEffect(() => {const intervalId = setInterval(updateOcrImageList, 1000 * 10); // 创建定时器，每 10 秒钟调用一次 updateOcrImageList 函数// 组件卸载时清除定时器return () => {clearInterval(intervalId);};}, []);const updateOcrImageList = async () => {try {const msg = await ocrList(); // 调用 ocrList 函数获取最新的图片列表console.log('ocrList响应数据=', msg.data);if (msg.isSuccess && msg.data.length > 0) {setOcrImageList(msg.data); // 更新图片列表状态}} catch (error) {console.error(error);}};const handleImageClick = (imagePath: string) => {setCurrentImage(imagePath); // 设置当前点击的图片路径setVisible(true); // 显示大图预览};return (<Row gutter={24}>{/* 遍历渲染图片列表 */}{ocrImageList.map((image) => ({/* 图片容器 */}<Col span={4} key={image.id}>{/* 图片元素 */}<div style={{ border: '1px solid #ccc', borderRadius: '8px', padding: '16px', marginBottom: '20px' }}><imgsrc={image.imgPath}alt={image.id}style={{ width: '100%', objectFit: 'contain', cursor: 'pointer' }}onClick={() => handleImageClick(image.imgPath)} // 点击图片时调用 handleImageClick 函数/></div>{/* 图片描述 */}<div style={{ textAlign: 'center' }}>{image.content}</div> // 显示图片内容</Col>))}{/* 大图预览弹窗 */}<Modal visible={visible} onCancel={() => setVisible(false)} footer={null} className="custom-modal"><img src={currentImage} alt="Preview" style={{ height: "100%", width: "100%" }} /></Modal></Row>);
};

在上述代码中，我们使用useState来维护了多个状态变量，包括ocrImageList（图片列表数据）、visible（控制模态框的显示与隐藏）、currentImage（当前要预览的图片路径）。

我们通过updateOcrImageList函数来异步获取ocrImageList数据，并在handleImageClick函数中实现了点击图片触发预览的功能。

在返回的JSX中，我们通过遍历ocrImageList并使用antd的Col和Row组件来展示图片。图片被点击后，会调用handleImageClick函数来设置currentImage和visible状态，从而展示预览模态框。

拓展（预览图片切换）：

导入新增

   import Lightbox from 'react-image-lightbox';import 'react-image-lightbox/style.css';

在预览模态框中切换到前一张或后一张图片。以下是相应的代码更改调整：

// ...// 点击图片触发预览功能
const handleImageClick = (index: number) => {setPreviewIndex(index);
};// 关闭预览
const handleClosePreview = () => {setPreviewIndex(-1);
};// 创建预览图片路径数组
const previewImages = ocrImageList.map((image) => image.imgPath);return (<Row gutter={24}>{/* 遍历渲染图片列表 */}{ocrImageList.map((image, index) => (<Col span={4} key={image.id}>{/* 图片容器 */}<div style={{ border: '1px solid #ccc', borderRadius: '8px', padding: '16px', marginBottom: '20px' }}>{/* 图片元素 */}<imgsrc={image.imgPath}alt={image.id}style={{ width: '100%', objectFit: 'contain', cursor: 'pointer' }}onClick={() => handleImageClick(index)} // 点击图片时调用 handleImageClick 函数/></div>{/* 图片描述 */}<div style={{ textAlign: 'center' }}>{image.content}</div></Col>))}{/* 如果正在预览图片，渲染预览模态框 */}{previewIndex !== -1 && (<Lightbox// 配置预览相关属性mainSrc={previewImages[previewIndex]}nextSrc={previewImages[(previewIndex + 1) % previewImages.length]}prevSrc={previewImages[(previewIndex + previewImages.length - 1) % previewImages.length]}onCloseRequest={handleClosePreview}onMovePrevRequest={() => setPreviewIndex((previewIndex + previewImages.length - 1) % previewImages.length)}onMoveNextRequest={() => setPreviewIndex((previewIndex + 1) % previewImages.length)}/>)}</Row>
);// ...