【亲测免费】 使用 `react-viewer` 实现大图预览教程

1. 项目介绍

react-viewer 是一个基于 Viewer.js 封装的 React 组件，它允许你在你的 React 应用程序中轻松实现大图预览功能，支持图片的旋转、缩放和其他交互操作。该项目由 infeng 开发并维护，可在 GitHub 上找到源码和最新的更新：https://github.com/infeng/react-viewer.git

2. 项目快速启动

安装

首先确保你已经安装了 Node.js 和 npm。然后，在你的项目中使用下面的命令安装 react-viewer：

npm install react-viewer

示例用法

在你的 React 组件中导入 react-viewer 并进行使用：

import React, { useState } from 'react';
import Viewer from 'react-viewer';

const MyComponent = () => {
  const [visible, setVisible] = useState(false);
  
  const images = [
    { src: 'path/to/your/image.jpg', alt: 'Image 1' },
    // Add more images as needed...
  ];

  return (
    <>
      <button onClick={() => setVisible(true)}>Preview Image</button>
      {visible && (
        <Viewer
          onClose={() => setVisible(false)}
          images={images}
        />
      )}
    </>
  );
};

export default MyComponent;

这会在按钮点击时打开图片预览窗口。

3. 应用案例和最佳实践

• 图片列表预览：如果你需要预览一组图片，可以将所有图片的 src 存储在一个数组中，并将其传递给 Viewer 组件的 images 属性。
• 自定义工具栏：通过设置 toolbar 属性，你可以控制展示哪些工具栏元素或提供自己的自定义工具栏组件。
• 初始化配置：利用 options 属性，你可以调整 Viewer.js 的配置，比如设置初始放大倍数、禁用某些操作等。
• 响应式设计：结合 CSS Grid 或 Flexbox，让预览窗口适应不同设备的屏幕尺寸。

4. 典型生态项目

react-viewer 通常与其他前端库一起使用，例如：

• Formik：用于表单管理，当提交表单时触发图片上传并预览。
• Redux：用于全局状态管理，存储图片列表并在多个组件间共享。
• Material UI：提供样式和组件，与 react-viewer 结合构建美观的界面。
• Gatsby 或 Next.js：作为静态站点生成器或服务器渲染框架，构建富媒体的静态网站。

相关项目

• react-native-image-viewer：专门针对 React Native 的图片预览组件，支持类似的功能。
• react-file-viewer：除了图片外还支持多种文件类型的预览，如 PDF、Word 文档等。

---

以上内容为你介绍了 react-viewer 的基本用法、最佳实践和相关生态项目。更多详细信息，请参考项目的官方文档：https://github.com/infeng/react-viewer/blob/master/README.md。