Skip to content
forked from kudago/waterfall

Waterfall layout. Extremely fast lightweight version of fluid columns masonry layout of isotope.

Notifications You must be signed in to change notification settings

antulik/waterfall

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jQuery.waterfall + modification by antulik

  • It provides functionality for column based layout.
  • It's Pinterest-like layout with fluid width of columns.
  • Fast, tiny, reliable and free alternative to isotope masonry column shift layout.
  • This is a fork of dfcreative/waterfall version. In this version you can easily build custom responsive layouts and replace CSS media queries.

Getting started

Requires jQuery or Zepro.js

(Optional) Global default configuration.

// add this before library is loaded
window.waterfall = {
  // ...
};

Add waterfall script to your page

<script src="/jquery.waterfall.js"></script>

Now you can start using it:

<div class='waterfall'>
    <div>One</div>
    <div>Two</div>
    <div>Three</div>
</div>

Customise layout

with html data-* attributes

container

  • data-max-cols - maximum number of columns allowed (default=null)
  • data-col-min-width - minimum width of each column (default=300)

element

  • data-span - number of columns to span the element (default=1)
    • allowed values: all or any Number
  • data-column - specific column to place the element in (default=any)
    • allowed values: any,left,right,first,last or any Number

Advanced usage & Responsive layout

data-span and data-column can have multiple values separated by ,(comma):

  • data-span='1,all' - span=all when number of columns is 2, otherwise span=1
  • data-column='right,any,any' - column=any when number of columns is 2 or 3, otherwise column=right

Syntax

data-span|data-column=default,2 columns,3 columns,4 columns, ...

For example when the current number of columns in the layout is 2, then value from 2 columns will be used. If it is missing or blank then default value will be used.

About

Waterfall layout. Extremely fast lightweight version of fluid columns masonry layout of isotope.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%