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

Package detail

ngx-shimmer-loading

ahmedbeheiry2.8kMIT1.0.0TypeScript support: included

Facebook-style shimmer loading placeholder for Angular 15+. Simple, customizable, and easy to use in any Angular project.

shimmer, loading, placeholder, angular, angular shimmer, angular loading, ngx, skeleton screen

readme

Shimmer Loading for Angular 15+ Apps

Facebook shimmer loading effect for Angular 15+ apps. It's a fancy way to tell your users that there's something loading.

ngx-shimmer-loading is simple and easy to use. It also comes with the two directions

See Demo page.

Table of contents

Features

  • <input checked="" disabled="" type="checkbox"> Easy and simple to use.
  • <input checked="" disabled="" type="checkbox"> Easy to setup.
  • <input checked="" disabled="" type="checkbox"> No Dependencies.
  • <input checked="" disabled="" type="checkbox"> Fancy Animations.

Getting started

Step 1: Install ngx-shimmer-loading:

NPM

npm i --save ngx-shimmer-loading

Step 2: Import the NgxShimmerLoadingModule into your module:

import { NgxShimmerLoadingModule } from  'ngx-shimmer-loading';
@NgModule({
  ...
  imports: [ NgxShimmerLoadingModule ],
  ...
})
export class AppModule {}

Step 3: Use the ngx-shimmer-loading component:

<ngx-shimmer-loading></ngx-shimmer-loading>

You can customize it with different inputs - check API for more details.

Example:

<ngx-shimmer-loading [shape]="'square'" [width]="'70px'"></ngx-shimmer-loading>

API

Inputs

Input Type Default Required Description
shape 'circle' OR 'square' OR 'rect' rect no Set shimmer shape.
width string '80%' no Set shimmer width. In case of shape is 'circle' or 'square' use width with px unit.
height string '12px' no Set shimmer height. In case of shape is 'circle' or 'square' shimmer height will equal shimmer width.
borderRadius string '5px' no Set shimmer border radius. In case of shape is 'circle' borderRadius equals '50%'
direction 'ltr' OR 'rtl' 'ltr' no Set shimmer direction.

Custom Styles

If you are not happy with default styles you can easily override them with your styles like that:

.shimmer-loading .ngx-shimmer {
  // Your styles go here...
}

Note that: shimmer effect animation here depends on css linear-gradient property so, if you want to change its color you can edit it or you can unset it and change its background-color value if you don't want the shimmer effect animation.

Contributing

Contributions are welcome. You can start by looking at issues with label Help wanted or creating new Issue with proposal or bug report.