1.0.0 • Published 8 months ago

scremer-shimmer v1.0.0

Weekly downloads
-
License
MIT
Repository
-
Last release
8 months ago

Scremer Shimmer for Angular 16+ Apps

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

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

scremer-shimmer is designed to work seamlessly with the latest Angular versions, ensuring a smooth loading experience for your applications.

Table of contents

Features

  • Easy and simple to use.
  • Easy to setup.
  • No Dependencies.
  • Fancy Animations.

Getting started

Step 1: Install scremer-shimmer:

NPM

npm i --save scremer-shimmer

Step 2: Import the ScremerShimmerModule into your module:

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

Step 3: Use the scremer-shimmer component:

<scremer-shimmer></scremer-shimmer>

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

Example:

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

API

Inputs

InputTypeDefaultRequiredDescription
shape'circle' OR 'square' OR 'rect'rectnoSet shimmer shape.
widthstring'80%'noSet shimmer width. In case of shape is 'circle' or 'square' use width with px unit.
heightstring'12px'noSet shimmer height. In case of shape is 'circle' or 'square' shimmer height will equal shimmer width.
borderRadiusstring'5px'noSet shimmer border radius. In case of shape is 'circle' borderRadius equals '50%'
direction'ltr' OR 'rtl''ltr'noSet shimmer direction.

Custom Styles

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

.shimmer-loading .scremer-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.

Credits

This library is inspired by the work of Ahmed Beheiry. We extend our gratitude to Ahmed for his contributions and innovative ideas in the field of front-end development.

AuthorE-mailURLGit Repository
[Ahmed Beheiry][ahmed_beheiry@yahoo.com ][http://ahmedbeheiry.me/ ][https://ahmedbeheiry.github.io/ngx-shimmer-loading/ ]