/jQuery.equalHeights

Simple equal heights jQuery plugin

Primary LanguageHTML

jQuery Simple Equal Heights

Version 1.5.2

Summary

Simple jQuery plugin to equalize heights of multiple elements on a page.

Author

Matt Banks ( @mattbanks / kernelcreativemedia.com / mattbanks.me )

Usage

Include jquery.equalheights.min.js after calling jQuery in the footer. Alternatively, include in your plugins.js file if using HTML5 Boilerplate.

Alternatively, install with bower:

bower install jquery.equalheights

Auto Initialize

Add data-equal="MYELEMENTS" to the parent container, where MYELEMENTS is div, section, li, whatever you'd like. See the example for more information.

Manually Initialize

$('.yourelements').equalHeights();

Select whatever elements need equal height.

Caveats

If using @font-face or Google Web Fonts, you may need to wrap the function call in a setTimeout for 100ms-200ms (jQuery.height() needs to fire after the font is rendered to properly calculate the height).

Requirements/Browsers

Tested with jQuery 1.7.x.

Works in IE6+, Chrome 14+, Safari 4+, Firefox 3.0+, Opera 10+.

Examples

See example.html in examples folder.

Contributors

Changelog

Version 1.5.2

  • version bump for bower

Version 1.5.1

  • fix bug with $.height() in jQuery 1.8+ with double padding when box-siding is set to border-box

Version 1.5.0

  • added Grunt for linting and minification
  • change auto-initialization to use a single data attribute (props pafnuty)

Version 1.4.2

  • allow multiple data-heights elements per page (props Korri)

Version 1.4.1

  • add bower support

Version 1.4

  • allow auto initialization with data-heights and data-targets (props betweenbrain)

Version 1.3

  • properly return the jQuery object to allow chaining

Version 1.2

  • properly cache $(this) since it's called twice in the main function
  • calculate height by innerheight() instead of height() to include any padding

Version 1.1

  • cleaned up function call
  • updated example.html to properly validate

Version 1.0

  • initial version