Skip to content

WrathChaos/react-native-counter-input

Repository files navigation

React Native Counter Input

Counter Input with fully customizable options for React Native

npm version npm Platform - Android and iOS License: MIT styled with prettier

React Native Counter Input React Native Counter Input

React Native Counter Input

Installation

Add the dependency:

npm i react-native-counter-input

Peer Dependencies

IMPORTANT! You need install them
"@freakycoder/react-native-bounceable": ">= 0.1.1",

Usage

Import

import CounterInput from "react-native-counter-input";

Fundamental Usage

<CounterInput
  onChange={(counter) => {
    console.log("onChange Counter:", counter);
  }}
/>

Configuration - Props

Property Type Default Description
style style default change/override the main container style
horizontal boolean false make the button horizontal design
initial number 0 set the initial value for the counter input
onChange function undefined set your own logic for onChange method, it triggers on any change
onChangeText function undefined it triggers when the TextInput changes
onIncreasePress function undefined it triggers when the increase button is pressed
onDecreasePress function undefined it triggers when the decrease button is pressed
backgroundColor string #fff change the CounterInput's background color
min number undefined set a minimum input value
max number undefined set a maximum input value
reverseCounterButtons boolean false reverse the counter buttons
increaseButtonBackgroundColor string #0b349a change the CounterInput's active increase button background color
decreaseButtonBackgroundColor string #0b349a change the CounterInput's active decrease button background color
ImageComponent component Image set your own Image component instead of default RN Image component such as; FastImage

Future Plans

  • LICENSE
  • Horizontal Feature
  • Animation
  • Reverse Horizontal +/- Buttons Option
  • Write an article about the lib on Medium

Credits

Heavily Inspired by Enes Kargıcı, thank you so much!

Author

FreakyCoder, [email protected]

License

React Native Counter Input is available under the MIT license. See the LICENSE file for more info.