0.0.1 • Published 5 years ago

athinodoros v0.0.1

Weekly downloads
5
License
-
Repository
github
Last release
5 years ago

React Native Sliding panel (up and down) - Android and IOS

An Awesome fully Customizable library of react native for sliding panels purely implemented in Javascript. Works exceptionally well on android and ios.

Alt text

Features (What makes this library different)

Easily Assemble itself into your react native project

One library for both sliding up and sliding down panels.

Customizable Animatable and Draggable.

Extremely simple usage and implementation.

Provides maximum methods for dealing with every scenarios in sliding panels.

Constantly updating and improvizing to provide best experience to all the developers.

Support

We will be always available to hear every possible issue and to fix every reported bug. You can even directly report the issue/concern/query/suggestion at abhijeetashapure@gmail.com

Installation

npm install react-native-sliding-up-down-panels --save

Copy and paste into the terminal in your project directory. For more information on npm install, please visit their official page

Note : We will soon provide the installation using yarn

Minimal Example

Before start please note :

  1. Always Put flex: 1 on the root container component style in which you are using < SlidingPanel />.
  2. Always use prop headerLayoutHeight to mention the height of the sliding panel header.
import React, { Component } from 'react';
import {
  StyleSheet,
  Text,
  View,
  Dimensions,
} from 'react-native';
const { width, height } = Dimensions.get('window');

import SlidingPanel from 'react-native-sliding-up-down-panels';


export default class App extends Component {
  render() {
    return (
      <View style={styles.container}>                      
        
        <View style={styles.bodyViewStyle}>
          <Text>Hello My World</Text>
        </View>
        
        <SlidingPanel
            headerLayoutHeight = {100}
            headerLayout = { () =>
                <View style={styles.headerLayoutStyle}>
                  <Text style={styles.commonTextStyle}>My Awesome sliding panel</Text>
                </View>
            }
            slidingPanelLayout = { () =>
                <View style={styles.slidingPanelLayoutStyle}>
                  <Text style={styles.commonTextStyle}>The best thing about me is you</Text>
                </View>
            }
        />
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
  },
  bodyViewStyle: {
    flex: 1,
    justifyContent: 'center', 
    alignItems: 'center',
  },
  headerLayoutStyle: {
    width, 
    height: 100, 
    backgroundColor: 'orange', 
    justifyContent: 'center', 
    alignItems: 'center',
  },
  slidingPanelLayoutStyle: {
    width, 
    height, 
    backgroundColor: '#7E52A0', 
    justifyContent: 'center', 
    alignItems: 'center',
  },
  commonTextStyle: {
    color: 'white', 
    fontSize: 18,
  },
});

If you are wrapping header layout inside a view, please make sure the height of that view is equal to headerLayoutHeight prop.

Props

PropertyTypeDescriptionPlatform
headerLayoutHeightnumberHeader height of sliding panelandroid, ios
headerLayoutfunctionHeader Layout of sliding panelandroid, ios
slidingPanelLayoutfunctionPanel Layout of sliding panelandroid, ios
AnimationSpeednumberAnimation speed, (in millisecond)android, ios
slidingPanelLayoutHeightnumberPanel height of sliding panelandroid, ios
panelPositionstring"top" or "bottom"android, ios
visibleboooleanto show/hide sliding panelandroid, ios
allowDraggingboooleanallow sliding panel to dragandroid, ios
allowAnimationboooleanallow sliding panel to animateandroid, ios
onDragStartfunction(event, gestureState)returns event, gestureStateandroid, ios
onDragStopfunction(event, gestureState)returns event, gestureStateandroid, ios
onDragfunction(event, gestureState)returns event, gestureStateandroid, ios
onAnimationStartfunctiontriggers when panel animation startsandroid, ios
onAnimationStopfunctiontriggers when panel animation stopsandroid, ios

Methods

Method NameDescriptionPlatform
onRequestStartpanel animation starts, sliding panel opensandroid, ios
onRequestClosepanel animation stops, sliding panel stopsandroid, ios

What's next (Our promise)

In the next version, We will upgrade library to the following features.

  • Installation using yarn.
  • Sliding the panel upto a particular height.
  • Left and Right sliding panels
  • Drop down panels, (Wooo!!)
  • Bug fixes