Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/metafizzy/packery
:bento: Gapless, draggable grid layouts
https://github.com/metafizzy/packery
Last synced: 25 days ago
JSON representation
:bento: Gapless, draggable grid layouts
- Host: GitHub
- URL: https://github.com/metafizzy/packery
- Owner: metafizzy
- Created: 2012-11-09T13:23:57.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2021-06-11T19:26:12.000Z (over 3 years ago)
- Last Synced: 2024-05-17T16:49:23.386Z (6 months ago)
- Language: JavaScript
- Homepage: https://packery.metafizzy.co
- Size: 731 KB
- Stars: 4,095
- Watchers: 98
- Forks: 316
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
Awesome Lists containing this project
- awesome-starred - metafizzy/packery - :bento: Gapless, draggable grid layouts (others)
README
# Packery
_Bin-packing layout library_
See [packery.metafizzy.co](https://packery.metafizzy.co) for complete docs and demos
## Install
### Download
+ [packery.pkgd.js](https://unpkg.com/[email protected]/dist/packery.pkgd.js) un-minified, or
+ [packery.pkgd.min.js](https://unpkg.com/[email protected]/dist/packery.pkgd.min.js) minified
### CDN
Link directly to Packery files on [unpkg](https://unpkg.com).
``` html
```
### Package managers
Bower: `bower install packery --save`
[npm](https://www.npmjs.com/package/packery): `npm install packery --save`
## License
### Commercial 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](https://packery.metafizzy.co/#commercial-license)
### Open source license
If you are creating an open source application under a license compatible with the [GNU GPL license v3](https://www.gnu.org/licenses/gpl-3.0.html), you may use Packery under the terms of the GPLv3.
[Read more about Packery's license](https://packery.metafizzy.co/packery.html).
## Initialize
With jQuery
``` js
$('.grid').packery({
// options...
itemSelector: '.grid-item'
});
```
With vanilla JavaScript
``` js
// vanilla JS
var grid = document.querySelector('.grid');
// initialize with element
var pckry = new Packery( grid, {
// options...
itemSelector: '.grid-item'
});
// initialize with selector string
var pckry = new Packery('.grid', {
// options...
});
```
With HTML
Add a `data-packery` attribute to your element. Options can be set in JSON in the value.
``` html
...
```
---
By [Metafizzy](http://metafizzy.co)