MiniMasonry.js

Minimalist dependancy free Masonry layout library

Download

MiniMasonry is a lightweight (1kb Gzipped) dependancy free Masonry layout. It will compute elements position in Javascript and update their positions using CSS's transform attribute. This means positioning does not trigger browser layout and use the device's GPU. This also allow's CSS animation during element positioning.

MiniMasonry is responsive, you give it a target width and it will adjust columns number and elements width. MiniMasonry will increase element width (until another column can fit in the layout) but will never reduce the target width.

Installation

Just include the minified version of MiniMasonry.js on your website :

<script src="minimasonry/build/minimasonry.min.js"></script>

Usage

To use MiniMasonry you should have a container relatively positioned with your elements as children. Those children elements must be absolutely positioned.

Then you can initialize MiniMasonry :

var masonry = new MiniMasonry({
    container: '.container'
}); 

Parameters

Here is the list of available parameters :

Name Default value Description
baseWidth 255 Target width of elements
container Null Container selector. Required
gutter 10 Width / height of gutter between elements
minify true Whether or not MiniMasonry place elements on shortest column or keep exact order of list

API

Here is the list of available APIs :

Name Description
layout() If list has changed, trigger a relayout of the masonry

MiniMasonry will add a "resize" event listener on the window to redraw the masonry on resize. This listener is throttled to 66ms (15fps).

Example

Default parameters :

var exampleDefault = new MiniMasonry({
    container: '.example_default'
});
1
2
3
4
5
6

Minify parameter set to false :

var exampleMinify = new MiniMasonry({
    container: '.example_minify',
    minify: false
});
1
2
3
4
5
6

Gutter an baseWidth :

var exampleSize = new MiniMasonry({
    container: '.example_size',
    gutter: 40,
    basewidth: 350
});
1
2
3
4
5
6