# React Spinners [![npm version](https://badge.fury.io/js/react-spinners.svg)][npm_url] [![downloads](https://img.shields.io/npm/dt/react-spinners.svg)][npm_url] [![license](https://img.shields.io/npm/l/react-spinners.svg)][npm_url] [![Coverage Status](https://coveralls.io/repos/github/davidhu2000/react-spinners/badge.svg?branch=main)](https://coveralls.io/github/davidhu2000/react-spinners?branch=master) ![Dependency Count](https://badgen.net/bundlephobia/dependency-count/react-spinners) ![Types Included](https://badgen.net/npm/types/react-spinners) ![Tree Shaking Supported](https://badgen.net/bundlephobia/tree-shaking/react-spinners) [npm_url]: https://www.npmjs.org/package/react-spinners A collection of loading spinners with React.js based on [Halogen](https://github.com/yuanyan/halogen). This package is bootstraped using [react-npm-boilerplate](https://github.com/juliancwirko/react-npm-boilerplate) ## Demo [Demo Page](https://www.davidhu.io/react-spinners) [Storybook](https://www.davidhu.io/react-spinners/storybook/) ## Installation With Yarn: ```bash yarn add react-spinners ``` With npm: ```bash npm install --save react-spinners ``` ## Usage Each loader has their own default properties. You can overwrite the defaults by passing props into the loaders. Each loader accepts a `loading` prop as a boolean. The loader will render `null` if `loading` is `false`. ### Example ```tsx import { useState, CSSProperties } from "react"; import ClipLoader from "react-spinners/ClipLoader"; const override: CSSProperties = { display: "block", margin: "0 auto", borderColor: "red", }; function App() { let [loading, setLoading] = useState(true); let [color, setColor] = useState("#ffffff"); return (

setColor(input.target.value)} placeholder="Color of the loader" />

); } export default App; ```

Example using React Class

```tsx import React from "react"; import ClipLoader from "react-spinners/ClipLoader"; const override: React.CSSProperties = { display: "block", margin: "0 auto", borderColor: "red", }; class AwesomeComponent extends React.Component { constructor(props) { super(props); this.state = { loading: true, }; } render() { return (

); } } ```

## Available Loaders, PropTypes, and Default Values Common default props for all loaders: ``` loading: true; color: "#000000"; cssOverride: {} speedMultiplier: 1; ``` All valid HTML props such as `aria-*` and `data-*` props are fully supported. ### `color` prop `color` prop accepts a color hash in the format of `#XXXXXX` or `#XXX`. It also accepts basic colors listed below: > maroon, red, orange, yellow, olive, green, purple, white, > fuchsia, lime, teal, aqua, blue, navy, black, gray, silver ### `cssOverride` prop The `cssOverride` prop is an object of camelCase styles used to create inline styles on the loaders. Any html css property is valid here. ### `size`, `height`, `width`, and `radius` props The input to these props can be _number_ or _string_. - If value is number, the loader will default to css unit `px`. - If value is string, the loader will verify the unit against valid css units. - If unit is valid, return the original value - If unit is invalid, output warning console log and default to `px`. The table below has the default values for each loader. | Loader | size | height | width | radius | margin | | ----------------: | :--: | :----: | :---: | :----: | :----: | | BarLoader | | `4` | `100` | | | BeatLoader | `15` | | | | `2` | | BounceLoader | `60` | | | | | CircleLoader | `50` | | | | | ClimbingBoxLoader | `15` | | | | | ClipLoader | `35` | | | | | ClockLoader | `50` | | | | | DotLoader | `60` | | | | `2` | | FadeLoader | | `15` | `5` | `2` | `2` | | GridLoader | `15` | | | | | HashLoader | `50` | | | | `2` | | MoonLoader | `60` | | | | `2` | | PacmanLoader | `25` | | | | `2` | | PropagateLoader | `15` | | | | | PuffLoader | `60` | | | | | PulseLoader | `15` | | | | `2` | | RingLoader | `60` | | | | `2` | | RiseLoader | `15` | | | | `2` | | RotateLoader | `15` | | | | `2` | | ScaleLoader | | `35` | `4` | `2` | `2` | | SyncLoader | `15` | | | | `2` |

			Stars	Issues	Version	Updated	Created	Size
	react-block-ui		301	11	1.3.6	2 years ago	8 years ago
	react-spinners		3,055	15	0.14.1	3 months ago	7 years ago

react-block-ui vs react-spinners

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Sick of boring JavaScript newsletters?

Downloads in past