Zoom component on React Native + react-native-reanimated + react-native-gesture-handler
- You can zoom any View, Image or whatever
- Can be used in FlatList (see Preview below)
- Double tap to zoom in or zoom out
- Automatically bounces to borders when paning outside of container and leaving the touch
iOS preview
1.mp4
Android preview
Android.mp4
Install the library using either Yarn:
yarn add react-native-zoom-reanimated
or npm:
npm install --save react-native-zoom-reanimated
dependency | required version |
---|---|
react-native-reanimated | >= 2.0.0 |
react-native-gesture-handler | >= * |
import Zoom from 'react-native-zoom-reanimated'
import Zoom from 'react-native-zoom-reanimated'
...
<Zoom>
<Image
source={{ uri: ... }}
resizeMode='contain'
style={{
width: deviceWidth,
height: imageHeight * deviceWidth / imageWidth,
}}
/>
</Zoom>
...
Name | Type | Required | Description |
---|---|---|---|
style | StyleProp<ViewStyle> |
No | Container style |
contentContainerStyle | StyleProp<ViewStyle> |
No | Content container style |
animationFunction | function | No | Animation function from react-native-reanimated . Default: withTiming . For example, you can use withSpring instead: https://docs.swmansion.com/react-native-reanimated/docs/api/animations/withSpring |
animationConfig | object | No | Config for animation function from react-native-reanimated . For example, avaiable options for withSpring animation: https://docs.swmansion.com/react-native-reanimated/docs/api/animations/withSpring#options-object |
doubleTapConfig | { defaultScale?: number, minZoomScale?: number, maxZoomScale?: number } | No | Config for zoom on double tap. defaultScale - if you want to have fixed zoom on double tap, or calculated based on dimensions then leave it as it is. minZoomScale and maxZoomScale define range with min zoom & max zoom on double tap |
The library is released under the MIT licence. For more information see LICENSE
.
- document useZoomGesture
- add examples of usage Zoom (with or without different configs), useZoomGesture with react-native app code
- add examples of list of images with FlatList
- make list component with https://github.com/callstack/react-native-pager-view and export it for galleries usecase