Go to file
Kegan Myers d13d7c8bb7 Merge branch 'jonathan-fielding/master' 2015-08-27 14:24:58 -05:00
.gitiginore update gitignore for npm 2015-01-07 15:05:20 -06:00
Gruntfile.js Add Gruntfile 2015-01-07 15:04:29 -06:00
LICENSE.md initial commit 2015-01-06 23:20:47 -06:00
README.md update readme 2015-01-10 02:50:31 -06:00
bower.json Made compatible with different module loaders 2015-07-31 12:13:29 +01:00
index.html initial commit 2015-01-06 23:20:47 -06:00
package.json Made compatible with different module loaders 2015-07-31 12:13:29 +01:00
tile.js Made compatible with different module loaders 2015-07-31 12:13:29 +01:00
tile.min.js update minified version 2015-08-27 14:23:18 -05:00

README.md

TileFlooring.js

You want a masonry-style layout? You got it.

I got sick of isotope/masonry, so decided to write this. Right now it takes a very simple approach and is a little limited in what it can do.

This simply figures out how many columns to make, and then puts things into those columns.

Usage

var floor = new TileFloor(myDivElement, {
    elementSelector: ".item",
    columns: {
        maxWidth: 200,
        maxCount: 5
    }
});

And now you have 5 columns that are each a maximum of 200px wide. If you only have 620px to work with, you get 4 columns, 600 gets 3, etc.

TileFlooring.js automatically responds to width changes through a combination of CSS, styles, and javascript, but only needs to run intensive javascript if the number of columns is changed, everything else is done by styles!

Features

  • You can now add elements to an existing floor, simply floor.pushElement(someElement);
  • You can tell a floor to rebuild itself by simply calling floor.flow(), this will not detect any element changes.

Limitations

TileFlooring does not (and will not) work on browsers that do not have proper HTML5 support, sorry. Not worth the trouble or cruft.

TileFlooring.js is a young project and not all features are implemented yet. There are plans to add more options to the column layout, the ability to actually destroy a floor, and more layout options.

Contributing

Just send a PR, as long as you're cool with publishing your code under the BSD license.