Quicksand 技术文档

1. 安装指南

在开始使用Quicksand之前，请确保您的项目中已经包含了jQuery库（版本1.6.1及以上），因为Quicksand是建立在jQuery之上的。如果需要使用动画缓动效果，您还可以选择包含jQuery Easing插件。此外，如果需要CSS3缩放效果，您还需要包含jquery.transform2d.js。

2. 项目的使用说明

Quicksand是一个非常强大的jQuery插件，它能够以流畅的动画效果对页面上的项目进行重新排序和过滤。下面是一个基本的使用示例：

$("#content").quicksand($("#data > li"),
  {
    duration: 1000,
    easing: "swing",
    attribute: "data-id"
  }
);

对应的HTML标记可能如下所示：

<ol id="content" class="grid">
  <li data-id="red">Red</li>
  <li data-id="green">Green</li>
  <li data-id="blue">Blue</li>
  <!-- 其他列表项 -->
</ol>

<ol id="data" style="display: none;">
  <li data-id="cyan">Cyan</li>
  <li data-id="magenta">Magenta</li>
  <li data-id="yellow">Yellow</li>
  <!-- 其他列表项 -->
</ol>

请注意，您需要为每个列表项设置一个独特的属性（默认为data-id），这样插件才能在源集合和目标集合中识别相同的元素。

3. 项目API使用文档

以下是Quicksand的一些主要配置选项：

• duration：动画效果的持续时间（毫秒）。
• easing：动画的缓动效果。
• attribute：用于识别源和目标集合中相同元素的属性。
• adjustHeight：容器高度的调整方式。
• adjustWidth：容器宽度的调整方式。
• useScaling：是否使用CSS3缩放效果。
• enhancement：在新建元素上执行自定义视觉增强的函数。

您还可以提供一个回调函数，以便在动画完成后执行。

4. 项目安装方式

由于Quicksand是一个jQuery插件，您可以通过以下步骤将其集成到您的项目中：

1. 确保您的页面中已经引入了jQuery库。
2. 下载Quicksand插件并将其包含在您的项目中。
3. 根据需要引入任何可选的依赖库，如jQuery Easing和jquery.transform2d.js。
4. 在您的JavaScript代码中使用Quicksand，如上述使用说明中所示。

这样，您就可以开始在项目中使用Quicksand来创建流畅的动画效果了。