react-img-view
MIT 协议 · 支持 React 18 与 19 · 无运行时依赖
Headless、可组合的 React 图片预览组件
缩放、拖拽、双指捏合、旋转、适应窗口与 1:1 都由库处理；默认界面开箱即用，而它完全由对外导出的部件拼成——任何一处都能换成你自己的。
npm install react-img-view点开任意一张：滚轮对着光标缩放，拖拽平移，方向键翻页。
接入：支持多种接入方式
支持单图、多图、函数式调用。界面可选：CSS 预设、shadcn 源码，或者完全自己拼。
定制：通过组合式设计实现高度定制化
工具栏、按钮、标题都能替换、增删、重新排列，也能换成你自己设计系统里的组件。
手势：支持捏合、拖拽与滚轮缩放
双指缩放、拖拽平移、滚轮对准光标缩放，放大后拖到边缘会直接翻到下一张。下滑关闭只认触摸和手写笔，鼠标不会误关。
动画：开合过程流畅自然
打开时从缩略图长成大图，关闭时按原路缩回，全程连贯不卡顿。