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.

1<script src="https://unpkg.com/masonry-layout@4/dist/masonry.pkgd.js"></script>
2<!-- or -->
3<script src="https://unpkg.com/masonry-layout@4/dist/masonry.pkgd.min.js"></script>

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

1$('.grid').masonry({
2  // options...
3  itemSelector: '.grid-item',
4  columnWidth: 200
5});

With vanilla JavaScript

1// vanilla JS
2// init with element
3var grid = document.querySelector('.grid');
4var msnry = new Masonry( grid, {
5  // options...
6  itemSelector: '.grid-item',
7  columnWidth: 200
8});
9
10// init with selector
11var msnry = new Masonry( '.grid', {
12  // options...
13});

With HTML

Add a data-masonry attribute to your element. Options can be set in JSON in the value.

1<div class="grid" data-masonry='{ "itemSelector": ".grid-item", "columnWidth": 200 }'>
2  <div class="grid-item"></div>
3  <div class="grid-item"></div>
4  ...
5</div>

License

Masonry is released under the MIT license. Have at it.

---

Made by David DeSandro