Skip to content

Single Element Spinner Angular component with customization option

License

Notifications You must be signed in to change notification settings

rahulbhooteshwar/ngx-busy-loader

Repository files navigation

ngx-busy-loader

Configurable spinner component library for Angular apps

Hello, Devs!

ngx-busy-loader is a component library to fulfill all your need of various types of busy load indicators in your application.

Go ahead and use our collection of some amazingly cool loaders.

Links

Getting Started

ngx-busy-loader contains various types of spinner that can be used with a number of configurable options like size, color, overlay and overlayColor

Installation Instructions

Install ngx-busy-loader from npm

npm install ngx-busy-loader --save

You will not need anything other than this

Usage

In your App Module
import { SpinnerModule } from 'ngx-busy-loader';

@NgModule({  
    ....  
    imports: [SpinnerModule,.....],  
    .....  
})
Use one of the following components as shown:
<ngx-spinner-circle-gradient></ngx-spinner-circle-gradient>
<ngx-spinner-circle-gradient-slow></ngx-spinner-circle-gradient-slow>
<ngx-spinner-circle-solid></ngx-spinner-circle-solid>
<ngx-spinner-circle-dotted-gradient></ngx-spinner-circle-dotted-gradient>
<ngx-spinner-circle-dotted-gradient-slow></ngx-spinner-circle-dotted-gradient-slow>
<ngx-spinner-single-dotted-line></ngx-spinner-single-dotted-line>
<ngx-spinner-lines-vertical></ngx-spinner-lines-vertical>  
> Options

You can pass input properties for customization, as shown below:

<ngx-spinner-lines-vertical
[color]="'some_color_or_hash'"
[size]="'some_size_from_available_ones'"></ngx-spinner-lines-vertical>

Available Sizes: xl, lg, md, sm, xs

You can pass dynamic values as input binding as well.

Full Page Overlay:

You can also use any of the busy load indicators as full page overlay indicator. This is useful when required to disable any user acttion while waiting for any process to complete.

Using as overlay spinner

<ngx-spinner-lines-vertical
[overlay]="true"
[color]="'some_color_or_hash'"
[size]="'some_size'"></ngx-spinner-lines-vertical>

Optionally, you can pass overlay color for background:

<ngx-spinner-lines-vertical
[overlay]="true"
[overlayColor]="'#24292e08'"
[color]="'some_color_or_hash'"
[size]="'some_size'"></ngx-spinner-lines-vertical>

Try to use some transparent overlay color for better user experience.

Browser Support

ngx-busy-loader is well verified on all modern browsers using Browser Stack. Using browserstack we make sure cross browser compatibility of the module, so that it works seamlessly on all supported browsers. Browserstack has helped us in identifying issues at very early stage.

Browser Stack

About

Single Element Spinner Angular component with customization option

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published