Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/desandro/masonry
:love_hotel: Cascading grid layout plugin
https://github.com/desandro/masonry
Last synced: 18 days ago
JSON representation
:love_hotel: Cascading grid layout plugin
- Host: GitHub
- URL: https://github.com/desandro/masonry
- Owner: desandro
- Created: 2009-11-21T21:04:56.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2024-06-07T12:22:03.000Z (6 months ago)
- Last Synced: 2024-11-21T11:38:49.865Z (22 days ago)
- Language: HTML
- Homepage: https://masonry.desandro.com
- Size: 1.41 MB
- Stars: 16,450
- Watchers: 459
- Forks: 2,104
- Open Issues: 84
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
Awesome Lists containing this project
- stars - desandro/masonry
- awesome - desandro/masonry - :love\_hotel: Cascading grid layout plugin (HTML)
- awesome-frontend-libraries - masonry-layout
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](https://masonry.desandro.com) for complete docs and demos.
## Install
### Download
+ [masonry.pkgd.js](https://unpkg.com/masonry-layout@4/dist/masonry.pkgd.js) un-minified, or
+ [masonry.pkgd.min.js](https://unpkg.com/masonry-layout@4/dist/masonry.pkgd.min.js) minified
### CDN
Link directly to Masonry files on [unpkg](https://unpkg.com/).
``` html
```
### Package managers
[npm](https://www.npmjs.com/package/masonry-layout): `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](https://metafizzy.co).
## 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](http://desandro.mit-license.org). Have at it.
* * *
Made by David DeSandro