desandro /masonry
:love_hotel: Cascading grid layout plugin
★ 16,681⑂ 2,061👁 449⑃ 55● 1,137▤ 22
More from this author
+1
Daily
16,681
stars
2,061
forks
449
watchers
55
prs
1,137
issues
22
releases
README
Masonry
_Cascading grid layout library_
Masonry works by placing elements in optimal position based on available vertical space, sort of like a mason fitting stones in a wall. You’ve probably seen it in use all over the Internet.
See masonry.desandro.com for complete docs and demos.
Install
Download
+ masonry.pkgd.js un-minified, or
+ masonry.pkgd.min.js minified
CDN
Link directly to Masonry files on unpkg.
html
Package managers
npm: npm install masonry-layout --save
Bower: bower install masonry-layout --save
Support Masonry development
Masonry has been actively maintained and improved upon for 8 years, with 900 GitHub issues closed. Please consider supporting its development by purchasing a license for one of Metafizzy's commercial libraries.
Initialize
With jQuery
js
$('.grid').masonry({
// options...
itemSelector: '.grid-item',
columnWidth: 200
});
With vanilla JavaScript
js
// vanilla JS
// init with element
var grid = document.querySelector('.grid');
var msnry = new Masonry( grid, {
// options...
itemSelector: '.grid-item',
columnWidth: 200
});
// init with selector
var msnry = new Masonry( '.grid', {
// options...
});
With HTML
Add a data-masonry attribute to your element. Options can be set in JSON in the value.
html
...
License
Masonry is released under the MIT license. Have at it.
Made by David DeSandroTop issues
#795Fix 1px column gaps. Use percent values in internally17 comments · 2015-12-18#1147Overlapping Images - Bootstrap User10 comments · 2021-03-10#1063Issues with bootstrap 48 comments · 2018-07-31#1189Please fix overlapping images on lazy load, I am using Lozad.js for lazy loading,7 comments · 2023-05-19#1114why does masonry randomly swaps items between them7 comments · 2019-10-07#1100Masonry for VueJS7 comments · 2019-06-29#1057masonry calculate right 0% only on FireFox6 comments · 2018-07-18#1006Percentage width does not work well with gutter6 comments · 2017-10-14
Latest release
v4.2.2 - float position values v4.2.2 2018-07-04⬆️ update dependencies + outlayer v2.1.1. Use float values for positioning, rather than intergers 795 + fizzy-ui-utils v2.0.7 + get-size v2.0.3