🔔 Alert..!! Get 2 Month Free Cloud Hosting With $200 Bonus From Digital Ocean ACTIVATE DEAL

A ReactJS Image carousel component with support for fullscreen mode with swiping and pinch-to-zoom.

Carousel React Native

Documentation

react-native-image-carousel

Image carousel with support for heading, captions, fullscreen mode, image swiping and pinch-to-zoom in fullscreen mode.

Supports both Android and iOS. Zoom feature works on iOS only.

Demo

Demo

Installation

npm install --save react-native-image-carousel

Usage

import ImageCarousel from 'react-native-image-carousel';  export default class App extends Component<any, any, any> {   _imageCarousel: ImageCarousel;    componentWillMount() {     (this: any)._renderHeader = this._renderHeader.bind(this);   }    _renderHeader(): ReactElement<any> {     return (       <TouchableWithoutFeedback onPress={this._imageCarousel.close}>         <View>           <Text style={styles.closeText}>Exit</Text>         </View>       </TouchableWithoutFeedback>     );   }    _renderFooter(): ReactElement<any> {     return (       <Text style={styles.footerText}>Footer!</Text>     );   }    _renderContent(idx: number): ReactElement<any> {     return (       <Image         style={styles.container}         source={{ uri: urls[idx] }}         resizeMode={'contain'}       />     );   }    render(): ReactElement<any> {     return (       <View style={styles.container}>         <ImageCarousel           ref={(imageCarousel: ImageCarousel) => {             this._imageCarousel = imageCarousel;           }}           renderContent={this._renderContent}           renderHeader={this._renderHeader}           renderFooter={this._renderFooter}         >           {urls.map((url: string): ReactElement<any> => (             <Image               key={url}               style={styles.image}               source={{ uri: url, height: 100 }}               resizeMode={'contain'}             />           ))}         </ImageCarousel>       </View>     );   } }

Check full example in Example folder.

Props and methods

Every prop is optional.

Name Type Description
activeProps? Object Props of each child when in fullscreen mode. (For a component to fill the screen activeProp's style must be flex: 1). This prop is ignored in case renderContent prop is provided.
activeComponents? [ReactElement<any>] Active components' bounds will be used for opening/closing fullscreen mode animations. If not provided, the immediate children are used.
zoomEnabled? boolean true by default, if false, children are not zoomable.
hideStatusBarOnOpen? boolean true by default, if false, status bar does not fade out on open.
renderContent? (idx: number) => ReactElement<any> Component to render in fullscreen mode for the given index.
renderHeader? () => ReactElement<any> Component to render at the top when in fullscreen mode.
renderFooter? () => ReactElement<any> Component to render at the bottom when in fullscreen mode.
onIdxChange? (idx: number) Fired on index change in fullscreen mode.
onOpen? () => void Fired on fullscreen mode open.
onClose? () => void Fired on fullscreen mode close.

react-native-image-carousel also provides two methods for opening and closing the fullscreen mode respectively:

open(startIdx: number), close.

License

MIT License © Anvilabs LLC


You May Also Like