background-image-fade-in v0.4.4

Background image fade in

Fades in background with use of ::before + :before. Supports ES6 modules (import), CommonJS (require), and browser (script tag) use. For browser use: use the bundle within the browser folder--using the function backgroundImageFadeIn.

• Browser support:
  • Full support: IE10+ and all other major vendors
  • Graceful support: IE9 (image will not fade in, but will not load choppy--either)
  • No support: IE8 and older

How to use

HTML

<div class="featured__image" data-src="imageone.png">
<div class="featured__image" data-src="imagetwo.png">
...
<div class="featured__image" data-src="imagefive.png">

Javascript

var BackgroundImageFadeIn = require('background-image-fade-in')
BackgroundImageFadeIn('.featured__image', 1000)

or

HTML

<div class="featured__image" data-src="imageone.png">
<div class="featured__image" data-src="imagetwo.png">
...
<div class="featured__image" data-src="imagefive.png">

Javascript

import BackgroundImageFadeIn from 'background-image-fade-in'
BackgroundImageFadeIn('.featured__image', 1000)

extra

Pass CSS string or Javascript style object

import BackgroundImageFadeIn from 'background-image-fade-in'
BackgroundImageFadeIn('.featured__image', 1000, { backgroundColor: 'purple' })

import BackgroundImageFadeIn from 'background-image-fade-in'
BackgroundImageFadeIn('.featured__image', 1000, 'background-color: purple;')

Available parameters

• Selector required
  • type: string
• Animation duration milliseconds
  • default: 1000
  • type: int
• CSS string/Javascript style object for ::before/:before
  • default: 'background-size: cover; background-position: center center;'
  • typeL string or object
• CSS string/Javascript style object for container
  • default: 'position: absolute; top: 0; left: 0; width: 100%; height: 100%; z-index: 1;'
  • type: string or object
• CSS kyeframe string/object
  • default: 'from { opacity: 0; } to { opacity: 1; }'
  • type: string or object