react-svg-pan-zoom vs react-zoom-pan-pinch
React Libraries for Zooming and Panning SVGs
react-svg-pan-zoomreact-zoom-pan-pinchSimilar Packages:

React Libraries for Zooming and Panning SVGs

Both 'react-svg-pan-zoom' and 'react-zoom-pan-pinch' are libraries designed to facilitate zooming and panning functionalities in React applications, particularly for SVG elements. They provide developers with tools to create interactive visualizations, allowing users to explore large datasets or detailed graphics by zooming in and out or panning across the view. While they share similar purposes, they differ in their implementation, features, and ease of use, catering to different project requirements and developer preferences.

Npm Package Weekly Downloads Trend

3 Years

Github Stars Ranking

Stat Detail

Package
Downloads
Stars
Size
Issues
Publish
License
react-svg-pan-zoom06961.02 MB412 years agoMIT
react-zoom-pan-pinch01,856664 kB1205 days agoMIT

Feature Comparison: react-svg-pan-zoom vs react-zoom-pan-pinch

Ease of Use

  • react-svg-pan-zoom:

    This library is designed for simplicity, making it easy to implement zoom and pan functionalities with minimal setup. It provides a straightforward API that allows developers to quickly integrate it into their projects without extensive configuration or learning curve.

  • react-zoom-pan-pinch:

    While also user-friendly, this library offers a more complex API that provides greater flexibility and customization options. It may require a bit more time to understand and implement effectively, especially for advanced features.

Touch Support

  • react-svg-pan-zoom:

    This package includes basic touch support, allowing users to zoom and pan using touch gestures on mobile devices, but it may not be as robust as other libraries in handling complex touch interactions.

  • react-zoom-pan-pinch:

    This library excels in touch support, offering comprehensive pinch-to-zoom and swipe gestures, making it ideal for mobile applications where touch interactions are essential.

Customization

  • react-svg-pan-zoom:

    Customization options are somewhat limited, focusing on providing essential zoom and pan functionalities without extensive configuration. It is best for projects that do not require deep customization.

  • react-zoom-pan-pinch:

    This library provides extensive customization options, allowing developers to fine-tune zoom levels, panning behavior, and interaction settings, making it suitable for applications that require a tailored user experience.

Performance

  • react-svg-pan-zoom:

    Performance is generally good for standard use cases, but may encounter issues with very large SVGs or complex graphics due to its straightforward implementation.

  • react-zoom-pan-pinch:

    This library is optimized for performance, handling larger datasets and complex graphics more efficiently, which is crucial for applications that require smooth interactions even with heavy content.

Community and Support

  • react-svg-pan-zoom:

    This library has a smaller community compared to others, which may result in fewer resources and examples available for troubleshooting or advanced use cases.

  • react-zoom-pan-pinch:

    With a larger community and more active development, this library benefits from a wealth of resources, documentation, and community support, making it easier to find help and examples.

How to Choose: react-svg-pan-zoom vs react-zoom-pan-pinch

  • react-svg-pan-zoom:

    Choose 'react-svg-pan-zoom' if you need a straightforward solution for zooming and panning SVG elements with a focus on simplicity and ease of integration. It is particularly useful for applications that require basic zooming and panning functionalities without extensive customization.

  • react-zoom-pan-pinch:

    Choose 'react-zoom-pan-pinch' if you require more advanced features such as touch gestures, pinch-to-zoom functionality, or a more customizable zooming experience. This library is better suited for applications that demand a richer interaction model and more control over the zooming and panning behavior.

README for react-svg-pan-zoom

react-svg-pan-zoom

react-svg-pan-zoom is a React component that adds pan and zoom features to the SVG images. It helps to display big SVG images in a small space.

chrvadala Test npm Downloads Donate

react-svg-pan-zoom

Live Demo

available at http://chrvadala.github.io/react-svg-pan-zoom/

Features

This component can work in four different modes depending on the selected tool:

  • With the tool pan the user can move the image and drag it around within the viewer, but can't interact with SVG child elements.
  • With the tool zoom the user can scale the image either with a point click or selecting a region to zoom the specified area, but can't interact with SVG child elements.
  • With the tool none the user can interact with SVG child elements and trigger events.
  • With the tool auto the user can interact with SVG child elements, perform pan (dragging the image), zoom in (double click), zoom out (double click + shift).

Documentation

Install

NPM

npm install --save react-svg-pan-zoom

YARN

yarn add react-svg-pan-zoom

UMD

<script src="https://unpkg.com/prop-types@15/prop-types.js"></script>
<script src="https://unpkg.com/react-svg-pan-zoom@3"></script>

Usage examples

Changelog

  • v2.0 - Project refactor. Follow this guide for migration instructions.
  • v2.1 - Adds setPointOnViewerCenter, reset methods and className, style props
  • v2.2 - Introduces tool auto, improves default toolbar
  • v2.3 - Adds touch events support
  • v2.4 - Adds es:next support, deploy new website
  • v2.5 - Adds preventPanOutside and scaleFactor props
  • v2.6 - Introduces transformation-matrix that reduces bundle size thanks to three shaking, Fixes pan limit behaviour, Replaces toolbar links with buttons, minor improvements
  • v2.7 - Adds miniature feature, Adds PropTypes support
  • v2.8 - Adds storybook demo, Remove bower support, Adds pinch to zoom feature, Fixes miniature size
  • v2.9 - Reinvents miniature and introduce props miniatureBackground, miniatureHeight, Minor improvements & fix
  • v2.10 - Introduces prop disableDoubleClickZoomWithToolAuto
  • v2.11 - Improves docs, updates deps
  • v2.12 - Exports miniature to allow customization
  • v2.13 - Fixes resize issues (#58), Upgrades deps
  • v2.14 - Introduces prop scaleFactorOnWheel, Upgrades deps
  • v2.15 - Improves autopan feature (#71), adds scaleFactorMax, scaleFactorMin props (#71), Upgrades deps
  • v2.16 - Adds onPan and onZoom callbacks, Upgrade deps, Fixes boundaries feature
  • v2.17 - Upgrades deps
  • v2.18 - Introduces toolbarProps.SVGAlignX and toolbarProps.SVGAlignY props. Adds alignment configuration in fitToViewer(SVGAlignX = "left", SVGAlignY = "top") method (#120). Upgrades deps.
  • v3.0 - Upgrades to babel 7 and storybook 4; Introduces <UncontrolledReactSVGPanZoom /> component and makes <ReactSVGPanZoom> a stateless component (except for some optimizations); Moves props related to miniature and toolbar, respectively into the miniatureProp and toolbarProp props. Migration guide is available here.
  • v3.1 - Upgrades to storybook 5 and transformation-matrix 2; Fixes some Babel configuration issues
  • v3.2 - Upgrades deps
  • v3.3 - Adds SVG viewbox prop support #150
  • v3.4 - Upgrades deps and increases code quality (fixing eslint warnings)
  • v3.5 - Handles wheel event as passive #158, upgrades deps
  • v3.6 - Adds some unit tests, Fixes #161, upgrades deps
  • v3.7 - Adds some more unit tests, upgrades deps
  • v3.8 - Adds cover option on fitToViewer method #167, adds activeToolColor property #168, upgrades deps
  • v3.9 - Exports toolbar icons and buttons #192
  • 3.10 - Upgrades deps; Migrates to React 17 and Storybook 6; Updates examples and docs to React hooks
  • 3.11 - Migrates from yarn to npm; Makes use of chrvadala/github-actions; Updates deps;
  • 3.12 - Migrates to gh-sponsor; Improves docs; Deprecates v1 migration guide; Upgrades deps;
  • 3.13 - Fixes migration doc #218; Removes deprecated defaultProps; Migrates to Storybook 8; Upgrades deps; Upgrades gh-actions;

Some projects using react-svg-pan-zoom

Contributors