Skip to content

alantoa/react-native-awesome-slider

Repository files navigation

React Native Awesome Slider

Reanimated v2 version npm npm Documentation

A high-performance slider component built with Reanimated v2 and React Native Gesture Handler.


Features

Core Features

  • Discrete sliding
  • Continuous sliding
  • Step control
  • Snapping behavior

Interaction

  • Scrubbing control
  • Haptic feedback

Customization

  • Custom thumb
  • Custom bubble tooltip
  • Custom mark
  • Customizable appearance

Use Cases

  • Media Player Controls (video/audio progress, volume, playback speed)
  • Financial Trading Tools (position size, leverage ratio)
  • General Purpose (numeric value adjustment, settings configuration)

Installation

First, install and configure Reanimated v2 and react-native-gesture-handler

For react-native-gesture-handler version >= 2:

yarn add react-native-awesome-slider

For version < 2:

yarn add react-native-awesome-slider@1

Basic Usage

import { useSharedValue } from 'react-native-reanimated';
import { Slider } from 'react-native-awesome-slider';

export const Example = () => {
  const progress = useSharedValue(30);
  const min = useSharedValue(0);
  const max = useSharedValue(100);
  return <Slider progress={progress} minimumValue={min} maximumValue={max} />;
};

Documentation

For complete component props and advanced usage, visit our official documentation.

License

MIT © Alan Toa