Giter VIP home page Giter VIP logo

mainleau / react-native-image-slider-banner Goto Github PK

View Code? Open in Web Editor NEW

This project forked from mudassirraza912/react-native-image-slider-banner

0.0 0.0 0.0 8.04 MB

A simple and fully customizable React Native Component that implements Image and Banner Slider UI with animations.

Home Page: https://www.npmjs.com/package/react-native-image-slider-banner

License: MIT License

TypeScript 100.00%

react-native-image-slider-banner's Introduction

react-native-image-slider-banner

npm npm


Support ๐Ÿ’ฐ

Mudassir Raza


IOS DEMO

IOS Demo

ANDROID DEMO

Android Demo

Install

  1. First, install our library | use below npm script

    npm i react-native-image-slider-banner

    yarn add react-native-image-slider-banner

Well-done.

Usage :

list of available props for customization SliderBox:

Props Value Type Description
data Array of image path(or url) as string Set array of images path- these paths can contain http url link or local images path using require('./pathOfImage')
localImg Boolean default (false) its define whats type image urls you provide if its true it means you provide local images path
showHeader Boolean default (false) if its true its shows a header on slider
headerRightComponent React Component default (null) for displaying right component in header
headerLeftComponent React Component default (null) for displaying left component in header
headerCenterComponent React Component default (null) for displaying Center component in header
headerStyle Style object default {} for change style of header
previewImageContainerStyle Style object for change style of previewImageContainer
previewImageStyle Style object for change style of previewImage
caroselImageContainerStyle Style object for change style of caroselImageContainer
caroselImageStyle Style object for change style of caroselImage
autoPlay Boolean default (false) for auto scrolling
timer Number default 2000 timeinterval for changing slider
showIndicator Boolean default (true) for Showing indicator
activeIndicatorStyle Style object for change style of activeIndicator
inActiveIndicatorStyle Style object for change style of inActiveIndicator
indicatorContainerStyle Style object for change style of indicatorContainer
onItemChanged Callback ((itemData) => {},) when item changed its give item data in parameter
onClick Callback ((item, index) => {},) when click on any item its give item data in parameter
closeIconColor colorCode #000 Image Preview cross icon color
blurRadius Number default (50) Image Preview Background Blur Radius
preview Boolean default true when preivew is false so slider not show IMAGE PREVIEW and then onClick works

1- add below import in your code :

import { ImageSlider } from "react-native-image-slider-banner";

2- Show Simple Slider with Image Preview option enable Example

ImageCarousel

<ImageSlider 
    data={[
        {img: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ5a5uCP-n4teeW2SApcIqUrcQApev8ZVCJkA&usqp=CAU'},
        {img: 'https://thumbs.dreamstime.com/b/environment-earth-day-hands-trees-growing-seedlings-bokeh-green-background-female-hand-holding-tree-nature-field-gra-130247647.jpg'},
        {img: 'https://cdn.pixabay.com/photo/2015/04/19/08/32/marguerite-729510__340.jpg'}
    ]}
    autoPlay={false}
    onItemChanged={(item) => console.log("item", item)}
    closeIconColor="#fff"
/>

3- Show Slider with Header and onClick Example

ImageCarousel

<ImageCarousel 
    data={[
        {img: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ5a5uCP-n4teeW2SApcIqUrcQApev8ZVCJkA&usqp=CAU'},
        {img: 'https://thumbs.dreamstime.com/b/environment-earth-day-hands-trees-growing-seedlings-bokeh-green-background-female-hand-holding-tree-nature-field-gra-130247647.jpg'},
        {img: 'https://cdn.pixabay.com/photo/2015/04/19/08/32/marguerite-729510__340.jpg'}
    ]}
    showHeader
    preview={false}
    headerLeftComponent={<Icon name="arrow-back" color="#fff" size={34} onPress={() => Alert.alert("alert")} />}
    headerCenterComponent={<Text style={{ color: '#fff', fontSize: 24, fontWeight: 'bold' }}>Header</Text>}
    headerStyle={{ padding: 10, backgroundColor: 'rgba(0,0,0, 0.6)', }}
    onItemChanged={(item) => console.log("item", item)}
    caroselImageStyle={{ resizeMode: 'cover' }}
    onClick={(item, index) => { alert('hello' + index) }}
    />

4- Show Slider with Header, Children and onClick Example

ImageCarousel

 <ImageCarousel 
    data={[
        { img: require('../../assets/images/slider1.png') },
        { img: require('../../assets/images/slider2.png') },
        { img: require('../../assets/images/slider1.png') }
    ]}
    localImg
    showHeader
    preview={false}
    headerLeftComponent={<Icon name="arrow-back" color="#fff" size={34} onPress={() => Alert.alert("alert")} />}
    headerCenterComponent={<Text style={{ color: '#fff', fontSize: 24, fontWeight: 'bold' }}>Header</Text>}
    headerStyle={{ padding: 10, backgroundColor: 'rgba(0,0,0, 0.6)', }}
    onItemChanged={(item) => console.log("item", item)}
    caroselImageStyle={{ resizeMode: 'cover' }}
    onClick={(item, index) => { alert('hello' + index) }}
    >
            <View style={{alignItems: 'center'}}>
                <Text style={{color: '#000', fontSize: 24, fontWeight: 'bold'}}>Title</Text>
            </View>
    </ImageCarousel>

Contribute And Update the Library

Please subscribe and contribute with me to develop this library

License MIT

react-native-image-slider-banner's People

Contributors

ksrajath7 avatar mudassirraza912 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.