progress-hud
v1.3.2
Published
React Native wrapper for SVProgressHUD library on iOS and KProgressHUD library on Android.
Downloads
452
Maintainers
Readme
progress-hud
progress-hud
is a Native Module for react-native that uses SVProgressHUD on iOS and KProgressHUD on Android.
Getting started
$ npm install progress-hud --save
$ yarn add progress-hud
Mostly automatic installation
RN < 60 Only
$ react-native link progress-hud
NOTE
- if RN < 0.60
$ npm install [email protected]
Manual installation
iOS
In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
Go to
node_modules
➜progress-hud
and addRNProgressHud.xcodeproj
In XCode, in the project navigator, select your project. Add
libRNProgressHud.a
to your project'sBuild Phases
➜Link Binary With Libraries
Run your project (
Cmd+R
)<
Android
- Open up
android/app/src/main/java/[...]/MainActivity.java
Add
import com.progresshud.RNProgressHudPackage;
to the imports at the top of the fileAdd
new RNProgressHudPackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:
include ':progress-hud'
project(':progress-hud').projectDir = new File(rootProject.projectDir, '../node_modules/progress-hud/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:
implementation project(':progress-hud')
iOS Dependency Installation:
Important: This package depends on SVProgressHUD library. Please make sure you also install SVProgressHUD
Follow the installation instructions and install before trying to run your project with the progress-hud package installed.
Usage
import RNProgressHud from 'progress-hud';
Showing a loading spinner with message:
// Where you want to display the spinner
RNProgressHud.showWithStatus("Loading...");
Showing a loading spinner with message and mask type:
// To use one of the pre-defined styles for background color:
const ProgressHUDMaskType = RNProgressHud.ProgressHUDMaskType;
RNProgressHud.showWithStatus("Loading...", ProgressHUDMaskType.Clear);
Show circular progress view:
// Input progress parameter must be a double or float with a range of 0.0 to 1.0 representing 0% and 100%.
// This will not automatically dismiss spinner unless progress reaches 100%. Otherwise, dismiss() must be called explicitly.
RNProgressHud.showProgressWithStatus(0.25, "Downloading data...");
Dismiss:
RNProgressHud.dismiss();
Dismiss with a delay (in seconds):
RNProgressHud.dismissWithDelay(1.0); // Dismisses after one second.