LoadingScreen

This gem allow to load a simple loading screen on any page that you want.

Installation

Add this line to your application's Gemfile:

for the latest development branch

gem 'loading_screen', git: https://github.com/Mujadded/loading_screen.git

for the stable branch

gem 'loading_screen', '~> 0.2.3'

And then execute:

$ bundle install

Usage

Gem has dependency on jquery so if not already added, please add

//= require jquery

and then this line in application.js

//= require loading_screen

After that add this line in application.css

 *= require loading_screen

Using available CSS animations

We are all set, to use it with default rotating_square animation in any view file ( for e.g.: index.html.erb) just add:

<%= loading_screen %>

or

<%= loading_screen style: :default %>

There are also other loading animation available for you to choose from just add style option, like:

<%= loading_screen style: :double_bounce %>

<%= loading_screen style: :rectangle_bounce %>

<%= loading_screen style: :wandering_cubes %>

<%= loading_screen style: :cube_grid %>

<%= loading_screen style: :dotted_spinner %>

<%= loading_screen style: :dotted_line %>

Other animations will be available shortly...

Using custom gif images

if you want to add custom gif as the loading screen just download a gif and put it inside the assets/images/ and add gif option:

<%= loading_screen gif: 'your gif file name witout ".gif" ' %>

And you are done. Enjoy

Using custom colors

You can change the background color and the loader color ( color for only css animation loader, gif's color depends on the image ) by adding background option and color option:

<%= loading_screen color: 'red', background: 'green' %>

Color format like hash, rgb, rgba, etc all css color format are acceptable

Development

Currently only fullscreen loading animation is supported. Div based loading animation feature will be added soon.

Contributing

Bug reports and pull requests are welcome. So fork the repo and create a pull :).

License

The gem is available as open source under the terms of the MIT License.