react-native-images-preview

Introducing an image preview built with pure JavaScript and leveraging React Native Reanimated and GesturesHandler, enabling full-screen image previewing and zooming via double-tap and pinch gestures for effortless integration into applications.

Our library is designed to be highly customizable, allowing developers to tailor it to their specific needs, such as changing the colors, styles, and other visual elements. Whether you're an Android or iOS user, our library is compatible with both platform, guaranteeing optimal performance.

🎬 Preview

Simple	SwipeDown Close

DoubleTap Zoom	Pinch Zoom

Quick Access

• Installation
• Usage and Examples
• Properties
• Example Code
• License

Getting Started 🔧

Here's how to get started with react-native-images-preview in your React Native project:

Installation

1. Install the package

Using npm:

1npm install react-native-images-preview react-native-reanimated react-native-gesture-handler

Using yarn:

1yarn add react-native-images-preview react-native-reanimated react-native-gesture-handler

2. Install cocoapods in the ios project

1cd ios && pod install

Note: Make sure to add Reanimated's babel plugin to yourbabel.config.js

1module.exports = {
2      ...
3      plugins: [
4          ...
5          'react-native-reanimated/plugin',
6      ],
7  };

Note: For React Native 0.61 or greater, add react-native-gesture-handler in index.js file.

1import 'react-native-gesture-handler';

Know more about react-native-reanimated and react-native-gesture-handler

Usage

1import React from 'react';
2import { StyleSheet, View } from 'react-native';
3import { ImagePreview } from 'react-native-images-preview';
4import { images } from './assets';
5
6const App = () => {
7  return (
8    <View style={styles.screen}>
9      <ImagePreview
10        imageSource={images.forest}
11        imageStyle={styles.imageStyle}
12      />
13    </View>
14  );
15};
16
17export default App;
18
19const styles = StyleSheet.create({
20  screen: {
21    flex: 1,
22    justifyContent: 'center',
23    alignItems: 'center',
24  },
25  imageStyle: {
26    height: 150,
27    width: 250,
28  },
29});

🎬 Preview

Properties

Props	Default	Type	Description
imageSource	-	ImageSourcePropType	Source of image
imageStyle	-	StyleProp<ImageStyle>	Styling of image
imageProps	-	ImageProps	Provide image props
swipeDownCloseEnabled	true	boolean	Enable/Disable swipe down to close modal
doubleTapZoomEnabled	true	boolean	Enable/Disable double tap to zoom
pinchZoomEnabled	true	boolean	Enable/Disable pinch to zoom
renderHeader	-	function	Call back function to render custom header and provide close() in argument
renderFooter	-	function	Call back function to render custom footer and provide close() in argument
renderImageLoader	-	function	Call back function to render custom image loader
errorImageSource	-	ImageSourcePropType	Source of error image
imageLoaderProps	-	ActivityIndicatorProps	Provide ActivityIndicator props

Know more about ImageProps, ActivityIndicatorProps

Example

A full working example project is here Example

1yarn
2yarn example ios   // For ios
3yarn example android   // For Android

Find this library useful? ❤️

Support it by joining stargazers for this repository.⭐

Bugs / Feature requests / Feedbacks

For bugs, feature requests, and discussion please use GitHub Issues, GitHub New Feature, GitHub Feedback

🤝 How to Contribute

We'd love to have you improve this library or fix a problem 💪 Check out our Contributing Guide for ideas on contributing.

Awesome Mobile Libraries

• Check out our other available awesome mobile libraries

License

• MIT License