matchHeight makes the height of all selected elements exactly equal.
It handles many edge cases that cause similar plugins to fail.
See the jquery.matchHeight.js demo.
- match the heights for groups of elements automatically
- use the maximum height or define a specific target element
- anywhere on the page and anywhere in the DOM
- responsive (updates on window resize)
- row aware (handles floating elements and wrapping)
- accounts for
box-sizing
and mixedpadding
,margin
,border
values - handles images and other media (updates after loading)
- supports hidden or none-visible elements (e.g. those inside tab controls)
- throttled to balance performance and smoothness
- easily removed when needed
- maintain scroll position
- data attributes API
- callback events
- tested in IE8+, Chrome, Firefox, Chrome Android
Current version is v0.5.2
.
Use the master build for the latest features.
Please report any issues you find.
jQuery is required, so include it first.
Download jquery.matchHeight.js and include the script in your HTML file:
<script src="jquery.matchHeight.js" type="text/javascript"></script>
Or install using Bower
bower install matchHeight
$(elements).matchHeight(options);
Where options is an optional parameter.
See below for a description of the available options and defaults.
Call this on the DOM ready event (the plugin will automatically update on window load).
See below for examples or the included test.html.
Also see the Data API below for a simple, alternative inline usage.
The default options are:
$(elements).matchHeight({
byRow: true,
property: 'height',
target: null,
remove: false
});
Where:
byRow
istrue
orfalse
to enable row detectionproperty
is the CSS property name to set (e.g.'height'
or'min-height'
)target
is an optional element to use instead of the element with maximum heightremove
istrue
orfalse
to remove previous bindings instead of applying new ones
$(function() {
$('.item').matchHeight();
});
The above will set all elements with the class item
to the height of the tallest.
If the items are on multiple rows, the items of each row will be set to the tallest of that row (see byRow
).
$(function() {
$('.item').matchHeight({
target: $('.sidebar')
});
});
The above will set all elements with the class item
to the height of the first item with class sidebar
.
<div data-mh="my-group">My text</div>
<div data-mh="my-group">Some other text</div>
<div data-mh="my-other-group">Even more text</div>
<div data-mh="my-other-group">The last bit of text</div>
The above will set both elements in my-group
to the same height as each other.
It will set both elements in my-other-group
to be the same height as each other.
See the included test.html for a working example.
Use the data attribute data-mh="group-name"
where group-name
is an arbitrary string to identify which elements should be considered as a group.
All elements with the same group name will be set to the same height when the page is loaded, regardless of their position in the DOM, without any extra code required.
Note that byRow
will be enabled when using the data API, if you don't want this (or require other options) then use the alternative method above.
There are a few internal properties and functions you should know about:
$.fn.matchHeight._update()
If you need to manually trigger an update of all currently set groups, for example if you've modified some content.
Since matchHeight automatically handles updating the layout after certain window events, you can supply functions as global callbacks if you need to be notified:
$.fn.matchHeight._beforeUpdate = function(event, groups) {
// do something before any updates are applied
}
$.fn.matchHeight._afterUpdate = function(event, groups) {
// do something after all updates are applied
}
Where event
a jQuery event object (e.g. load
, resize
, orientationchange
) and groups
is a reference to $.fn.matchHeight._groups
(see below).
$.fn.matchHeight._apply(elements, options)
Use the apply function directly if you wish to avoid the automatic update functionality.
$.fn.matchHeight._throttle = 80;
By default, the _update
method is throttled to execute at a maximum rate of once every 80ms
.
Decreasing the above _throttle
property will update your layout quicker, appearing smoother during resize, at the expense of performance.
If you experience lagging or freezing during resize, you should increase the _throttle
property.
$.fn.matchHeight._maintainScroll = true;
Under certain conditions where the size of the page is dynamically changing, such as during resize or when adding new elements, browser bugs cause the page scroll position to change unexpectedly.
If you are observing this behaviour, use the above line to automatically attempt to force scroll position to be maintained (approximately). This is a global setting and by default it is false
.
$.fn.matchHeight._groups
The array that contains all element groups that have had matchHeight
applied. Used internally for automatically updating on resize events, but you may modify this array if you need to manually access any groups (e.g. if you're deleting elements).
You should ensure that there are no transitions or other animations that will delay the height changes of the elements you are matching, including any transition: all
rules. Otherwise the plugin will produce unexpected results, as animations can't be accounted for.
Some browsers do not wait for webfonts to load before firing the window load event, so if the font loads too slowly the plugin may produce unexpected results.
If this is a problem, you should call _update
once your font has loaded by using something like the webfontloader script.
If you change the content inside an element that has had matchHeight
applied, then you must manually call $.fn.matchHeight._update()
afterwards. This will update of all currently set equal heights groups.
To see what's new or changed in the latest version, see the changelog
jquery.matchHeight.js is licensed under The MIT License (MIT)
Copyright (c) 2014 Liam Brummitt
This license is also supplied with the release and source code.
As stated in the license, absolutely no warranty is provided.
Making robust, responsive equal height columns for arbitrary content is difficult or impossible to do with CSS alone (at least without hacks or trickery, in a backwards compatible way).
Note you should probably ensure your layout is still usable if JavaScript is disabled.