summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 9fa7b06f7cd5225929f6c360a0f43ab5016fcfdd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
# 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](http://twitter.com/mattbanks) / [kernelcreativemedia.com](http://www.kernelcreativemedia.com) / [mattbanks.me](http://www.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](http://html5boilerplate.com).

Alternatively, install with [bower](https://github.com/bower/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](https://github.com/mattbanks/jQuery.equalHeights/blob/master/example/example.html) 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

* [betweenbrain](https://github.com/betweenbrain)
* [Korri](https://github.com/Korri)
* [pafnuty](https://github.com/pafnuty)

### 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-sizing` 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](https://github.com/pafnuty))

#### Version 1.4.2

* allow multiple `data-heights` elements per page (props [Korri](https://github.com/Korri))

#### Version 1.4.1

* add bower support

#### Version 1.4

* allow auto initialization with `data-heights` and `data-targets` (props [betweenbrain](https://github.com/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