1.0.0 • Published 5 years ago

rn-animated-progress-circle v1.0.0

Weekly downloads
59
License
MIT
Repository
github
Last release
5 years ago

React Native Animated Progress Circle

Currently working on both Android and iOS on version 0.57 of react-native and up with the addition of support for overflow style property on Android

Props

PROPTYPEDESCRIPTION
valueNumber / Animated.ValueNumber between 0-1 which indicates the total progress of the circle. Default value is 0. Also accepts an Animated.Value (to be interpolated 0-1) if you wish to handle the timing of the animation outside of the component.
sizeNumberSets the size of the progress circle. Default size is 64.
thicknessNumberSets the thickness of the progress circle. Default thickness is 7
colorStringSets the color of the complete portion of the progress circle. Default color is #7e42ed.
unfilledColorStringSets the color of the incomplete portion of the progress circle. Default unfilledColor is transparent.
styleObjectAny arbitrary styles you want to pass to the component.
childrenReactNodeAny children you want to appear in the center of the progress circle.
animationMethodStringAnimation method to be used. Takes one of the following strings: timing, spring, bounce, decay. Setting this value will animate the component. Please note that this prop will have no effect if you choose to pass in an Animated.Value instead of a Number to the value prop.
animationConfigObjectConfiguration object to set animation parameters. See configuration docs for timing, spring, bounce, and decay. useNativeDriver is set to true by default. Please note that this prop will have no effect if you choose to pass in an Animated.Value instead of a Number to the value prop.
shouldAnimateFirstValueBooleanIndicates whether the initial value passed to the value prop should animate in or not. Defaults to false. If set to true, you should specify how you want the progress circle to animate via animationMethod and animationConfig props. Please note that this prop will have no effect if you choose to pass in an Animated.Value instead of a Number to the value prop.
onChangeFunctionCallback function which gets called when the value prop changes.
onChangeAnimationEndFunctionCallback function which gets called when the animation that occurs after the value prop changes is complete. Please note that this prop will have no effect if you choose to pass in an Animated.Value instead of a Number to the value prop.

Examples

Animated.spring to animate value changes with Text as children

animated gif of progress circle changing to different percentages of completion

source

A PieChart component that takes an array of objects as data: { color: String, value: Number }

a colourful pie chart with six slices

source