desandro /masonry

:love_hotel: Cascading grid layout plugin

★ 16,681⑂ 2,061👁 449⑃ 55● 1,137▤ 22
HTMLCreated 2009-11-21masonry.desandro.com
More from this author
Download: v4.2.2 - float position valuesv4.2.2 ↓4.2.22018-07-04
+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 DeSandro

Top issues

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON