roundy
Configurable react round slider. Supports touch events.
Installation
npm i roundy (or yarn add roundy)
Usage
import Roundy from 'roundy';
const {value} = this.state
<Roundy
value={value}
min={10}
max={30}
stepSize={5}
radius={100}
color='pink'
onChange={value => this.setState({value})}
onAfterChange={(value, props) => ... }
overrideStyle={ ... string template as CSS ...}
/>You can create pie round chart
<Roundy
arcSize={270}
min={10}
max={30}
rotationOffset={-45}
/>Or use roundy as a group of sliders:
import { RoundyGroup } from 'roundy'
<RoundyGroup sliders={[
{ value: 30, step: 10, id: 'mjaw', max: 50, radius: 60, color: 'blueviolet', onChange:(val, props) => console.log(props) },
{ value: 30, step: 10, max: 50, radius: 100 },
{ value: 100, step: 20, max: 200, color: 'orange', radius: 140, sliced: false, step: 1 }
]} />API
Roundy provides the following API:
| Prop | Description | Default |
|---|---|---|
| value | number: Slider value | 50 |
| min | number: Minimal value | 0 |
| max | number: Maximum value | 100 |
| stepSize | number: Step value to snap value | 0 |
| steps | number: Number of steps that will be snapable | 0 |
| radius | number: Slider radius | 100 |
| color | string: Active slider color | 'purple' |
| bgColor | string: Slider arc color | '#ccc' |
| strokeWidth | number: Slider arc width | 15 |
| thumbSize | number: Size (diameter) of thumb | 20 |
| sliced | boolean: Provide slices based on step value | true |
| onChange | function: immediate callback function (value, props) | null |
| onAfterChange | function: callback function after release (value, props) | null |
| overrideStyle | string: provide additional class style which will be injected into styled-components class | null |
| arcSize | number: Size of the arc. Default is 360, can be between 1 and 360 | 360 |
| rotationOffset | number: rotation of the whole circle. Can be between -180 and 180 | 0 |
| render | render prop function that has a signature: ({value, angle}, props) => Node | null |
Testing
TODO
Contribution
Always happy to take PRs.