How to use react-native-interactive-image-gallery with Expo?

It requires native linking for iOS, which may not be compatible with Expo's managed workflow; you might need to eject or use a bare workflow for full functionality, as manual installation steps are outlined.

Does this library support pinch-to-zoom for images?

No, the README doesn't mention pinch-to-zoom or advanced gestures; it focuses on navigation and tilt animations, so it's best for basic interactive browsing without detailed zoom controls.

How to customize the close button in the gallery?

Use the 'closeText' prop in the ImageBrowser component to change the button text, as specified in the API documentation for straightforward UI adjustments.

React native interactive image gallery vs react-native-image-viewer which is better?

This library excels in smooth animations and tilt effects but lacks advanced features; react-native-image-viewer might offer more gestures like pinch-to-zoom—choose based on your need for animations versus broader functionality.

How to handle performance with a large number of images?

The library requires thumbnails in the image source to aid performance, but there's no built-in lazy loading or optimization mentioned; you may need to manage large sets externally or implement custom caching.

Can I add videos to the gallery?

No, it's designed for images only, with no support for video playback or other media types in the features or props listed in the README.

Is this library actively maintained?

Based on the acknowledgement from a 2017 talk and no recent update mentions, maintenance might be limited; check GitHub for latest commits or issues before relying on it for long-term projects.

Open-Awesome

react-native-interactive-image-gallery

MITJavaScriptv0.1.1

A React Native component for displaying interactive image galleries with tilt animations and detailed info overlays.

GitHub

114 stars16 forks0 contributors

What is react-native-interactive-image-gallery?

react-native-interactive-image-gallery is a React Native component library designed for displaying interactive image galleries in mobile applications. It solves the need for a customizable, animated gallery component that works across both iOS and Android, providing features like tilt animations and detailed image info overlays.

Target Audience

React Native developers building mobile apps that require image galleries, such as photo apps, e-commerce product displays, or media-rich applications.

Value Proposition

Developers choose this library for its smooth animations, cross-platform compatibility, and ease of integration, offering a more engaging alternative to basic image viewers without extensive custom development.

Overview

🖼 A React Native component to display a gallery of images.

Use Cases

Best For

Building photo gallery apps with interactive browsing
Displaying product images in e-commerce mobile apps
Creating media-rich applications with image collections
Implementing animated image viewers in React Native projects
Adding tilt animation effects to image galleries on iOS
Developing cross-platform apps with consistent gallery experiences

Not Ideal For

Projects requiring advanced gestures like pinch-to-zoom or video playback
Teams using Expo or preferring zero-config native module installation
Apps demanding fully consistent features across iOS and Android (e.g., tilt animations only on iOS)
Large-scale applications needing robust community support and frequent updates

Pros & Cons

Pros

Smooth Interactive Animations

Includes experimental tilt animations on iOS, inspired by practical hacks for delightful user experiences, as acknowledged in the README.

Cross-Platform Consistency

Works on both iOS and Android with similar behavior, demonstrated in the provided GIFs showing consistent gallery navigation.

Easy Integration

Uses a simple ImageBrowser component with minimal mandatory props like an images array, making it quick to set up for basic galleries.

Customizable Info Overlays

Allows styling of title and description overlays through infoTitleStyles and infoDescriptionStyles props for tailored UI presentation.

Cons

iOS-Only Experimental Features

Tilt animations are experimental and exclusive to iOS, reducing cross-platform parity and limiting feature consistency.

Complex iOS Setup

Requires manual linking in Xcode for iOS installation, which can be error-prone and time-consuming compared to auto-linked libraries.

Limited Customization Depth

The API offers few props, lacking support for advanced features like custom gestures, loading states, or deep animation controls beyond the basics.

Frequently Asked Questions

Related Projects

react-native-camera

A Camera component for React Native. Also supports barcode scanning!

Stars9,630

Forks3,503

Last commit3 years ago

react-native-video

A <Video /> component for react-native

Stars7,716

Forks3,027

Last commit6 days ago

react-native-track-player

The best audio player for React Native. Built on the New Architecture — Android Auto, caching, preloading, background playback, and more.

Stars3,707

Forks1,198

Last commit1 month ago

react-native-sound

React Native module for playing sound clips

Stars2,916

Forks783

Last commit6 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub