/responsive-elements

Element queries don't exist yet for CSS3, but this plugin allows you to do just that with jQuery.

Primary LanguageJavaScriptMIT LicenseMIT

#responsiveElement 1.0.0

Element queries don't exist yet for CSS3, but this plugin allows you to do just that with jQuery.

This plugin changes the class of an element depending on its width. By changing the class like this, you can now use CSS to manipulate and alter the contents of the element.

For the complete how-to's, go to the responsiveElement documentation

##Installation

###Step 1: Link Required Files

The jQuery library needs to be loaded first, then this plugin.

<!-- jQuery library (served from Google) -->
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<!-- responsiveElement Javascript file -->
<script src="/js/jquery.responsiveElement.min.js"></script>

###Step 2: Create HTML Markup

Locate the element you want made responsive and add add any class name you want to it. For this example, we will make it "responsive".

<div class="responsive">
  The content of my div is here
</div>

###Step 3: Call responsiveElement

$(document).ready(function(){
  $('.responsive').responsiveElement();
});

That's it!

There are a couple options that can be applied to customize it. You can also apply this to multiple elements on the page at a time, all with different options!

##Configuration Options

rules Rules that are applied to the element in question. The default widths are based off of Twitter Bootstrap 8 column widths.

default: [
  '750,responsive-lg',
  '617,responsive-md',
  '470,responsive-sm',
  '0,responsive-xs'
]

The format of the each element in the default array is "minimum pixel width, class to be applied". So if the width of <div class="responsive"> is 750 pixels or larger, then the element will become <div class="responsive responsive-lg">.

See the example.html file for a couple examples.

Have fun!

License

responsiveElement.js is open-sourced software licensed under the MIT license