0.0.2 • Published 7 years ago

react-native-stepper v0.0.2

Weekly downloads
4
License
MIT
Repository
github
Last release
7 years ago

react-native-stepper

Platform npm version npm version License

screenshot

A super simple react-native stepper implementation. Check out the props below for customization.

This package was inspired in react-native-simple-stepper develop by Brian.

Motivation

This is my first package with react-native and i need a stepper implementation that i could use any type of component as a stepper button.

Installation

npm i react-native-stepper --save

Usage

import Stepper from 'react-native-stepper'

//...

render() {
  return (

      //...

      <Stepper
        initValue={duration}
        minValue={0}
        stepValue={1}
        style={stepperStyle}
        decreaseComponent={(<Icon family="Ionicons" name="remove" style={stepperStyle.iconStyle} />)}
        increaseComponent={(<Icon family="Ionicons" name="add" style={stepperStyle.iconStyle} />)}
        valueChanged={(value) => this.onChangeDurationFilter(value)}
      />

      //...

  )
}

onChangeDurationFilter(value) {
  // ... update your app state here
}

//...

Attention !!!

I do not provide any style or default component for decrease and increase buttons, you must provide both. To implement your style you must follow the schema below.

const stepperStyle = StyleSheet.create({
  containerStyle: {
    flexDirection: 'row'
  },
  decreaseButtonStyle: {
    padding: 0,
    borderWidth: 2,
    borderRightWidth: 1,
    borderColor: 'red',
    borderTopLeftRadius: 4,
    borderBottomLeftRadius: 4
  },
  increaseButtonStyle: {
    padding: 0,
    borderWidth: 2,
    borderLeftWidth: 1,
    borderColor: 'red',
    borderTopRightRadius: 4,
    borderBottomRightRadius: 4
  }
});

Demo

screenshot

Props

NameTypeDescriptionDefault
initValueNumberInitial value.0
minValueNumberThe minimum value that stepper counter can achieve.-
maxValueNumberThe maximum value that stepper counter can achieve.-
maxValueNumberThe max value that stepper counter can achieve.1
decreaseComponentComponentComponent that will be rendered as decrease button<Text>-</Text>
increaseComponentComponentComponent that will be rendered as increase button<Text>-</Text>
styleStyleSheet ObjectStyle that will be applied in your stepper component-
valueChangedFunctionFires when the value changes and the value will be passed down for processing like display or calculations.FALSE
minMessageString or FunctionMessage fired when stepper achieve the minimum valuenull
maxMessageString or FunctionMessage fired when stepper achieve the maximum valuenull
ignoreMinValidationBoolean!!!FALSE
ignoreMaxValidationBoolean!!!FALSE