ngx-loading-bar
TypeScript icon, indicating that this package has built-in type declarations

0.0.9 • Public • Published

ngx-loading-bar

Simple loading bar on the top of your page to indicate page loading loading.

Installation

  1. Install npm module:

    npm install ngx-loading-bar --save

  2. If you are using system.js you may want to add this into map and package config:

    {
        "map": {
            "ngx-loading-bar": "node_modules/ngx-loading-bar"
        },
        "packages": {
            "ngx-loading-bar": { "main": "index.js", "defaultExtension": "js" }
        }
    }

Usage

Import LoadingBarModule and put loading bar component to the top of your page, most probably near the main header.

<loading-bar color="#FF0000" [height]="3" [animationTime]="0.3" [runInterval]="100" [progress]="0"></loading-bar>
  • progress is overall loading progress
  • color color of the loading bar
  • height height of the loading bar
  • animationTime css animation time in ms
  • runInterval interval during which loading will increase its percents

You can also use LoadingBarService service to control your loading bar progress - start and stop loading.

Sample

import {Component} from "@angular/core";
import {LoadingBarModule, LoadingBarService} from "ngx-loading-bar";
 
@Component({
    selector: "app",
    template: `
<div class="container">
    <loading-bar #loadingBar [height]="height" [color]="color" [runInterval]="runInterval"></loading-bar>
 
    <br/>
    <br/>
    <button (click)="loadingBar.start()">start</button><br/>
    <button (click)="loadingBar.stop()">stop</button><br/>
    <button (click)="loadingBar.reset()">reset</button><br/>
    <button (click)="loadingBar.complete()">complete</button><br/>
 
    <br/>
    change height: <input [(ngModel)]="height"><br/>
    change color: <input [(ngModel)]="color"><br/>
    run interval: <input [(ngModel)]="runInterval"><br/>
    <br/>
 
    <button (click)="emitStart()">dispatch start event using service</button>
    <button (click)="emitStop()">dispatch stop event using service</button>
    <button (click)="emitReset()">dispatch reset event using service</button>
    <button (click)="emitComplete()">dispatch complete event using service</button>
 
</div>
`
})
export class Sample1App  {
 
    height = 2;
    color = "#4092F1";
    runInterval = 300;
 
    constructor(private loadingBarService: LoadingBarService) {
    }
 
    emitStart() {
        this.loadingBarService.start();
    }
 
    emitStop() {
        this.loadingBarService.stop();
    }
 
    emitReset() {
        this.loadingBarService.reset();
    }
 
    emitComplete() {
        this.loadingBarService.complete();
    }
 
}
 
@NgModule({
    imports: [
        // ...
        LoadingBarModule
    ],
    declarations: [
        App
    ],
    bootstrap: [
        App
    ]
})
export class AppModule {
 
}

Take a look on samples in ./sample for more examples of usages.

Readme

Keywords

none

Package Sidebar

Install

npm i ngx-loading-bar

Weekly Downloads

124

Version

0.0.9

License

MIT

Last publish

Collaborators

  • pleerock