prscX / react-native-fluidic-slider

React Native: Native Fluidic Slider
Apache License 2.0
196 stars 20 forks source link
android ios react-native

PRs Welcome

ReactNative: Native Fluidic Slider (Android/iOS): Deprecated Due to time constraint, this library is deprecated and not maintained anymore, You can still use this library. If this project has helped you out, please support us with a star 🌟

This library is a React Native bridge around native fluid slider libraries. It allows you select value from a range of values:

📖 Getting started

$ npm install react-native-fluidic-slider --save

$ react-native link react-native-fluidic-slider

buildscript {
    repositories {
        google()
        maven { url "https://maven.google.com" }
        jcenter()
        ...
    }
}

allprojects {
    repositories {
        google()
        mavenLocal()
        maven { url 'https://jitpack.io' }
        maven {
            url 'https://maven.google.com/'
            name 'Google'
        }
        jcenter()
        ...
    }
}

Note: Android SDK 27 > is supported

💻 Usage

import { RNFluidicSlider } from 'react-native-fluidic-slider'

<RNFluidicSlider></RNFluidicSlider>

💡 Props

Prop Type Default Note
min number 0 Specify min range value of the slider
max number 100 Specify max range value of the slider
initialPosition number - 0 to 1 .5 Specify initial position of slider indicator
barColor string: HEX_COLOR #6168e7 Specify bar color
bubbleColor string: HEX_COLOR #FFFFFF Specify bubble color
barTextColor string: HEX_COLOR #FFFFFF Specify bar text color
bubbleTextColor string: HEX_COLOR #000000 Specify bubble text color
beginTracking func (position) Specify callback function for begin tracking
endTracking func (position) Specify callback function for end tracking

Note:

  • Initial Position: Sepcify initial position in fraction from 0 to 1
  • beginTracking & endTracking: It will provide fraction value of position ranging from 0 to 1. Please use below formulate to calculate numerical value of selected position: min + ((max - min) * position)

✨ Credits

🤔 How to contribute

Have an idea? Found a bug? Please raise to ISSUES. Contributions are welcome and are greatly appreciated! Every little bit helps, and credit will always be given.

💫 Where is this library used?

If you are using this library in one of your projects, add it in this list below. ✨

📜 License

This library is provided under the Apache 2 License.

RNFluidicSlider @ prscX

💖 Support my projects

I open-source almost everything I can, and I try to reply everyone needing help using these projects. Obviously, this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).

However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it: