andresribeiro / react-native-reanimated-image-viewer

A image viewer for React Native created with Reanimated
MIT License
142 stars 8 forks source link
image-viewer image-viewing react-native reanimated

A image viewer for React Native created with Reanimated

Features ✨

https://user-images.githubusercontent.com/63297375/210002857-2ab01afa-420a-40c9-9f4c-5df4c2a40a2b.mp4

About 🗞️

Uses Reanimated and Gesture Handler under the hood. Created for my social network app, Rybun.

Installation ⚙️

yarn add react-native-reanimated-image-viewer

You will need Reanimated and Gesture Handler installed in your project.

Usage 🔨

Import the ImageViewer into a new screen. You can also use a Modal, but you will need to configure the Gesture Handler on Android.

Example

import ImageViewer from "react-native-reanimated-image-viewer";
import { GestureHandlerRootView } from "react-native-gesture-handler";

export default function App() {
  const imageUrl = "https://images.pexels.com/photos/994605/pexels-photo-994605.jpeg?auto=compress&cs=tinysrgb&w=2726&h=2047&dpr=1"

  return (
    <GestureHandlerRootView style={{flex: 1}}>
      <ImageViewer
        imageUrl={imageUrl} width={2726} height={2047} onRequestClose={() => {}}
      />
    </GestureHandlerRootView>
  );
}

Props ✍️

Property Default Type Required
imageUrl undefined string true
width undefined number true
height undefined number true
onRequestClose undefined () => unknown true
onSingleTap undefined () => unknown false