ngx-loading-spinner
v13.0.2
Published
ngx-loading-spinner is following simplistic approach to showcase your asychronous events in latest Angular Framework.
Downloads
24
Readme
ngx-loading-spinner
ngx-loading-spinner is following simplistic approach to showcase your asychronous events in latest Angular Framework.
Also provides custom templating & loading text inputs.
Default Spinner Example
Custom Template Example
Installation
npm i ngx-loading-spinner --save
Description
You can override the css for your customized spinner.
You can also configure your own threshold to show spinner only for more expensive processes!
Supports All Major Angular Versions
New Updates
#loading-spinner-text / .loading-spinner-text
: Both id and class attributes given to spinner text component to customize the loading text css
[timeout] The time after which spinner will be hidden. Default is 5000 ms
Resolved issues related to templates and loading text.
Usage
Import module to your application master module
import { NgxLoadingSpinnerModule } from 'ngx-loading-spinner';
@NgModule({
declarations: [
...
],
imports: [
NgxLoadingSpinnerModule.forRoot()
],
exports: [
NgxLoadingSpinnerComponent
]
})
Include spinner component to your root level component.
<ngx-loading-spinner> </ngx-loading-spinner>
Import
NgxLoadingSpinnerService
to the component where you want to show the spinner.
import { NgxLoadingSpinnerService } from 'ngx-loading-spinner';
Inject dependancy
constructor(
private spinnerService: NgxLoadingSpinnerService
) { }
Use
show()
method to display the loading spinner.
this.spinnerService.show();
Use
hide()
method to hide the loading spinner once the processing is done.
this.spinnerService.hide();
Example
this.spinnerService.show();
this.http.get(GLOBAL['CONFIG_URL'])
.subscribe(data => {
this.spinnerService.hide();
});
Custom template
[template] : Accepts HTML which generates the loading spinner. You can apply additional css to design your own spinner, or can just pass *.gif image to show the loading spinner.
[loadingText] : Accepts a string to display the text while the loading process.
[zIndex] : Accepts a z-index css property for loading text.
[threshold] : Accepts time in milliseconds for threshold through which you can conditionally show the spinner only for expensive calls. Default is 500 ms.
[timeout] : Accepts time in milliseconds to hide the spinner automatically. Default is 5000 ms.
default [loadingText] text would be blank.
app.component.html : both are optional if not provided default would be shown.
<ngx-loading-spinner [threshold]="2000" [timeout]="4000" [template]="template" [loadingText]="'Please wait...'" [zIndex]="9999"></ngx-loading-spinner>
[threshold]="2000" : This will show the loading bar for the only processes which will take time more 2 secs.
app.component.ts
template: string =`<img src="http://pa1.narvii.com/5722/2c617cd9674417d272084884b61e4bb7dd5f0b15_hq.gif" />`
License
MIT © Amit Mahida