高度可定制的jQuery瀑布流网格布局插件_jQuery之家-自由分享jQuery、html5、css3的插件库

简要教程

stackgrid.adem.js是一款简单且高度可定制的 jQuery 瀑布流网格布局插件。通过该瀑布流网格插件你可以动态添加和删除各种尺寸的图片，定义图片宽度，设置网格的列数，或使用流式布局方式，甚至还可以通过URL动态添加图片。

使用方法

使用该瀑布流布局插件之前要先引入jQuery和stackgrid.adem.js文件。

<script src="jquery.min.js"></script>
<script src="stackgrid.adem.js"></script>

HTML结构

该瀑布流网格布局插件使用的是嵌套<div>的HTML结构。

<div id="grid-container">
  <div class="grid-item">...</div>
  <div class="grid-item">...</div>
  <div class="grid-item">...</div>
</div>

初始化插件

在确保所有内容都被加载之后，可以通过下面的方法来初始化该瀑布流网格布局插件。一定要确保所有的内容都被加载，这样可以使stackgrid计算出正确的高度。

// Create a stackgrid object.
var stackgrid = new $.stackgrid;
var options = {
  column_width: 320
};

// Wrap the initializer inside window on load to
// make sure to wait until all the grid contents are loaded.
var $window = $(window);
$window.on('load', function(){

  // Initialize stackgrid!
  // The first two arguments are for the container selector and the item selector.
  stackgrid.initialize('#grid-container', '.grid-item', options);

});

添加新的网格

该瀑布流网格布局插件允许你动态的添加新的网格。并且这个过程不需要重新绘制所有的网格。

// Create new grid-item.
item = $("<div class=\"grid-item\"> I'm a new grid item. </div>");
// Append it to the grid-container.
item.appendTo("#grid-container");
// *** If the new content has image(s), make sure it's loaded first before appending!
// Append to stackgrid!
stackgrid.append(item);

重新排列网格

// Restack the grid to apply your config changes.
stackgrid.config.is_fluid = false;
stackgrid.restack();

// Certain changes require you to reset the grid.
// These are changes that affect the dimensions of the grid-item or
// if you remove any of the items.
stackgrid.config.column_width = 400;
stackgrid.reset();
stackgrid.restack();

配置参数

下面是该瀑布流网格布局的可用配置参数。

// The values shown here are the default ones.
stackgrid.config = {

  // Your column width.
  column_width: 320,

  // Adjust spacing in-between grid-items.
  gutter: 20,

  // Set this as true to let stackgrid automatically
  // determine the number of columns based on the
  // viewport's width.
  is_fluid: true,

  // Set this as true to sort the grid in an vertically optimal way.
  is_optimized: true,

  // If is_fluid is false, it will
  // use this as the default number of columns.
  number_of_columns: 4,

  // Timeout delay to call the resize complete function.
  resize_delay: 300,

  // You can customize when and how each item is moved!
  // Make sure to use jQuery stop() function if you decide to
  // animate it.
  // Where you place the callback determines
  // when the next move operation is called.
  move: function(element, left, top, callback) {
    element.css({
      left: left,
      top: top
    )};
    callback();
  },

  // This function is used to scale the container containing
  // the grid-items.
  // The callback function starts the move operations.
  scale: function(element, width, height, callback) {
    element.css({
      height: height,
      width: width
    });
    callback();
  }
};