Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

react-native-indicators

n4kz75.2kBSD-3-Clause0.17.0TypeScript support: definitely-typed

Activity indicator collection

react, react-component, react-native, ios, android, activity, indicator, spinner, pacman, material

readme

react-native-indicators

npm license travis

Activity indicator collection for React Native

example

Features

  • Easy to use
  • Consistent look and feel on iOS and Android
  • Can be used as drop-in replacement for ActivityIndicator
  • Configurable appearance and animation
  • Configurable indicator size
  • Native driver based animation
  • Pure javascript implementation
  • Compatible with RN 0.45+, for older versions use 0.14.0

Installation

npm install --save react-native-indicators

Usage

import React, { Component } from 'react';
import {
  BallIndicator,
  BarIndicator,
  DotIndicator,
  MaterialIndicator,
  PacmanIndicator,
  PulseIndicator,
  SkypeIndicator,
  UIActivityIndicator,
  WaveIndicator,
} from 'react-native-indicators';

class Example extends Component {
  render() {
    return (
      <DotIndicator color='white' />
    );
  }
}

Common properties

name description type default
animationEasing Animation easing function Function Easing.linear
animationDuration Animation duration in ms Number 1200
animating Animation toggle Boolean true
interaction Animation is interaction Boolean true
hidesWhenStopped Hide when not animating Boolean true

BallIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 8
size Base component size Number 40

BarIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 3
size Base component size Number 40

DotIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 4
size Base component size Number 16

MaterialIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
size Base component size Number 40
trackWidth Indicator track width Number size / 10

PacmanIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
size Base component size Number 48

PulseIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
size Base component size Number 40

SkypeIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 5
size Base component size Number 40
minScale Minimum component scale Number 0.2
maxScale Maximum component scale Number 1.0

UIActivityIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 12
size Base component size Number 40

WaveIndicator properties

name description type default
color Component color String rgb(0, 0, 0)
count Component count Number 4
size Base component size Number 40
waveFactor Wave base number Number 0.54
waveMode Wave appearance String fill

Possible values for waveMode are fill and outline

Example

git clone https://github.com/n4kz/react-native-indicators
cd react-native-indicators/example
npm install
npm run ios # or npm run android

BSD License

Copyright 2017-2019 Alexander Nazarov. All rights reserved.

changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.17.0 - 2019-10-16

Changed

  • PacmanIndicator animation

0.16.0 - 2019-10-01

Added

  • hidesWhenStopped prop

Changed

  • MaterialIndicator animation

0.15.0 - 2019-09-28

Added

  • trackWidth prop for MaterialIndicator
  • Animation state restoration for Indicator component

0.14.0 - 2019-09-26

Fixed

  • WaveIndicator glitch on Android
  • Deprecation warnings for React component lifecycle methods