Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oblador/react-native-progress
Progress indicators and spinners for React Native
https://github.com/oblador/react-native-progress
Last synced: about 1 month ago
JSON representation
Progress indicators and spinners for React Native
- Host: GitHub
- URL: https://github.com/oblador/react-native-progress
- Owner: oblador
- License: mit
- Created: 2015-11-01T05:07:41.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-02-05T10:46:07.000Z (7 months ago)
- Last Synced: 2024-08-12T22:06:57.370Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 923 KB
- Stars: 3,610
- Watchers: 41
- Forks: 512
- Open Issues: 122
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-react-native - react-native-progress ★2069 - Progress indicators and spinners for React Native using ReactART. (Components / UI)
- awesome-react-native - react-native-progress ★2069 - Progress indicators and spinners for React Native using ReactART. (Components / UI)
- awesome-reactnative-ui - react-native-progress - 8d01-11e5-9ec0-5e175a837c62.gif)| (Others)
- awesome-reactnative-ui - react-native-progress - 8d01-11e5-9ec0-5e175a837c62.gif)| (Others)
- awesome - react-native-progress - Progress indicators and spinners for React Native using ReactART (JavaScript)
- awesome-react-native - react-native-progress ★2069 - Progress indicators and spinners for React Native using ReactART. (Components / UI)
- awesome-react-native-ui - react-native-progress ★593 - Progress indicators and spinners for React Native using ReactART. (Components / UI)
- awesome-react-native - react-native-progress ★2069 - Progress indicators and spinners for React Native using ReactART. (Components / UI)
README
# react-native-progress
Progress indicators and spinners for React Native using React Native SVG.
## Installation
`$ npm install react-native-progress --save`
### React Native SVG based components
To use the `Pie` or `Circle` components, you need to install [React Native SVG](https://github.com/react-native-svg/react-native-svg) in your project.
## Usage
_Note: If you don't want the React Native SVG based components and it's dependencies, do a deep require instead: `import ProgressBar from 'react-native-progress/Bar';`._
```js
import * as Progress from 'react-native-progress';
```
### Properties for all progress components
| Prop | Description | Default |
| ------------------------------------ | ---------------------------------------------------------------------------- | ---------------------- |
| **`animated`** | Whether or not to animate changes to `progress`. | `true` |
| **`indeterminate`** | If set to true, the indicator will spin and `progress` prop will be ignored. | `false` |
| **`indeterminateAnimationDuration`** | Sets animation duration in milliseconds when indeterminate is set. | `1000` |
| **`progress`** | Progress of whatever the indicator is indicating. A number between 0 and 1. | `0` |
| **`color`** | Fill color of the indicator. | `rgba(0, 122, 255, 1)` |
| **`unfilledColor`** | Color of the remaining progress. | _None_ |
| **`borderWidth`** | Width of outer border, set to `0` to remove. | `1` |
| **`borderColor`** | Color of outer border. | `color` |
### `Progress.Bar`
All of the props under _Properties_ in addition to the following:
| Prop | Description | Default |
| --------------------- | ------------------------------------------------------------------------------ | ------------------- |
| **`width`** | Full width of the progress bar, set to `null` to use automatic flexbox sizing. | `150` |
| **`height`** | Height of the progress bar. | `6` |
| **`borderRadius`** | Rounding of corners, set to `0` to disable. | `4` |
| **`useNativeDriver`** | Use native driver for the animations. | `false` |
| **`animationConfig`** | Config that is passed into the `Animated` function. | `{ bounciness: 0 }` |
| **`animationType`** | Animation type to animate the progress, one of: `decay`, `timing`, `spring`. | `spring` |
### `Progress.Circle`
All of the props under _Properties_ in addition to the following:
| Prop | Description | Default |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **`size`** | Diameter of the circle. | `40` |
| **`endAngle`** | Determines the endAngle of the circle. A number between `0` and `1`. The final endAngle would be the number multiplied by 2π | `0.9` |
| **`thickness`** | Thickness of the inner circle. | `3` |
| **`showsText`** | Whether or not to show a text representation of current progress. | `false` |
| **`formatText(progress)`** | A function returning a string to be displayed for the textual representation. | _See source_ |
| **`textStyle`** | Styles for progress text, defaults to a same `color` as circle and `fontSize` proportional to `size` prop. | _None_ |
| **`allowFontScaling`** | Whether or not to respect device font scale setting. | _true_ |
| **`direction`** | Direction of the circle `clockwise` or `counter-clockwise`. | `clockwise` |
| **`strokeCap`** | Stroke Cap style for the circle `butt`, `square` or `round`. | `butt` |
| **`fill`** | Fill color of the inner circle. | None (transparent) |
### `Progress.Pie`
All of the props under _Properties_ in addition to the following:
| Prop | Description | Default |
| ---------- | -------------------- | ------- |
| **`size`** | Diameter of the pie. | `40` |
### `Progress.CircleSnail`
| Prop | Description | Default |
| ---------------------- | --------------------------------------------------------------- | ---------------------- |
| **`animating`** | If the circle should animate. | `true` |
| **`hidesWhenStopped`** | If the circle should be removed when not animating. | `false` |
| **`size`** | Diameter of the circle. | `40` |
| **`color`** | Color of the circle, use an array of colors for rainbow effect. | `rgba(0, 122, 255, 1)` |
| **`thickness`** | Thickness of the circle. | `3` |
| **`duration`** | Duration of animation. | `1000` |
| **`spinDuration`** | Duration of spin (orbit) animation. | `5000` |
| **`strokeCap`** | Stroke Cap style for the circle `butt`, `square` or `round`. | `round` |
## Examples
- [`Example` project bundled with this module](https://github.com/oblador/react-native-progress/tree/master/Example)
- [react-native-image-progress](https://github.com/oblador/react-native-image-progress)
## [Changelog](https://github.com/oblador/react-native-progress/releases)
## Thanks
To [Mandarin Drummond](https://github.com/MandarinConLaBarba) for giving me the NPM name.
## License
[MIT License](http://opensource.org/licenses/mit-license.html). © Joel Arvidsson 2015-