packery's Introduction

Packery

Bin-packing layout library

See packery.metafizzy.co for complete docs and demos

Install

Download

packery.pkgd.js un-minified, or
packery.pkgd.min.js minified

CDN

Link directly to Packery files on cdnjs.

<script src="https://cdnjs.cloudflare.com/ajax/libs/packery/1.4.3/packery.pkgd.js"></script>
<!-- or -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/packery/1.4.3/packery.pkgd.min.js"></script>

Package managers

Bower: bower install packery --save

npm: npm install packery --save

License

Commerical license

If you want to use Packery to develop commercial sites, themes, projects, and applications, the Commercial license is the appropriate license. With this option, your source code is kept proprietary. Purchase a Packery Commercial License at packery.metafizzy.co

Open source license

If you are creating an open source application under a license compatible with the GNU GPL license v3, you may use Packery under the terms of the GPLv3.

Initialize

With jQuery

$('.grid').packery({
  // options...
  itemSelector: '.grid-item'
});

With vanilla JavaScript

// vanilla JS
var grid = document.querySelector('.grid');
var pckry = new Packery( grid, {
  // options...
  itemSelector: '.grid-item'
});

With HTML

Add a class of js-packery to your element. Options can be set in JSON in data-packery-options.

<div class="grid js-packery"
  data-packery-options='{ "itemSelector": ".grid-item" }'>
  <div class="grid-item"></div>
  <div class="grid-item"></div>
  ...
</div>