Sunday, March 16, 2014

ChickenDinner.js – jQuery Plugin to Load Images Randomly

ChickenDinner is a stupid little Jquery plugin that will randomly load images from a client-side array. See it in action at:

That Sounds Dumb

No, you're dumb. I mean, it makes sense if you are looking to present visitors with a unique experience each time they hit you up. Think banners and heroes. Basically, I wanted to do this on a recent project, and figured someone somewhere might like to do something similar, so here we are.

How's it Work Then?

Easy peasy. You can either apply it directly to a img tag, or as a css background-image (don't forget to include Jquery champ).

On an img tag

First, add your image tag with a unique class. Pereferably, you'd leave the src blank (href="#") or add a fallback for the no js, "but that won't validate" punks - a sexy ass fadeIn animation prevents the image from popping through before the script fires (usually). Either way, to always maintain the parent div's height, might wanna rock an intrinsic ratio move.
 /*Blank src*/
 <img class="js-chickendinner" src="#" alt="">

 /*With fallback for no-js losers*/
 <img class="js-chickendinner" src="images/banner1.png" alt="">

Now just initialize the badboy with your class, include the path to your images (defualt path is 'images/'), give 'er a common alt name, and list the images to swap, like so:
      path: '',
      altTag: 'Banner Image',
      TheImages: ['ban1.png', 'ban2.png', 'ban3.png', 'ban4.png']

As a CSS background-image

To rock out with random background-images, first add a div with a unique class that you wanna target. Since this will work via inline css, you can also include the inline styles to serve as fallback.
/* Blank src */
  <div class="js-chickendinner-bg"> <!--Joey Content was here--> </div>

  /* With a fallback */
  <div class="js-chickendinner-bg" style="background-image: url("../images/banner1.png"> <!--Joey Content was here--> </div>

Initialize it, but this time add the option cssBG with the value of 'True'. ChickenDinner will then inject the background-image attribute via an inline style, so make sure to style up your div as you normally would for background images.
        path: 'images/',
        TheImages: ['banner2.png', 'banner3.png', 'banner4.png', 'banner5.png']


An option with a numeric value (milliseconds) that Fades your images in all sexy like. Again, if you include a fallback image this prevents it from blipping through before the script fires.

Defaults / Options

pathpath to images'images/'
TheImagesImages to be randomly selected['banner2.png', 'banner3.png']
cssBGTo employ css background-imageTrue
altTagGlobal img alt'Banner Image'
fadeInTimeMilliseconds fade in time2000
Source: github

No comments:

Post a Comment