npm 包 jquery.shapeshift 使用教程

简介

jquery.shapeshift 是一个基于 jQuery 的网格布局插件,可以轻松地创建可拖动、可调整大小的网格布局,适用于前端开发中的各种场景。本文将对该插件进行详细的使用教程,并提供示例代码以供参考。

安装

使用 npm 进行安装:

- --- ------- ----------------- ------

引入

在 HTML 文件中引入 jQuery 和 jquery.shapeshift

------- -----------------------------------------------------------
------- -----------------------------------------------------------------------

使用

基本使用

在 HTML 中创建一个容器,并添加多个子元素:

---- ---------------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
------

使用 jQuery 对容器进行初始化:

------------ -
  -----------------------------
---

运行效果如下图所示:

选项设置

可以通过传递选项对象来自定义插件的行为。以下是一些常用的选项:

  • selector:指定子元素选择器;
  • minColumns:最小列数;
  • maxColumns:最大列数;
  • autoHeight:自动设置容器高度;
  • animateOnInit:初始化时是否使用动画效果。
------------ -
  ----------------------------
    --------- -------
    ----------- --
    ----------- --
    ----------- -----
    -------------- ----
  ---
---

事件监听

插件提供了多个事件,可以方便地对布局进行控制。以下是一些常用的事件:

  • ss-added:添加新元素后触发;
  • ss-removed:删除元素后触发;
  • ss-shuffled:重新排序后触发;
  • ss-transformed:变换元素大小后触发。
------------ -
  ----------------------------
    -- ---
    ------- ---------- -
      ---------------- ------- ---------
    --
    --------- ---------- -
      ------------------- -----------
    --
    ----------- ---------- -
      --------------------- -----------
    -
  ---
---

示例代码

完整的示例代码如下:

--------- -----
------
------
  ----- ----------------
  ------------- ---------- ------------
  ------- -----------------------------------------------------------
  ------- -----------------------------------------------------------------------
  -------
    ---------- -
      ------- ---- -----
      ------ ------
      ------- --- ----- -----
      ----------------- --------
    -
    ---- -
      -------- -----
      ------- --- ----- -----
      ----------------- -----
    -
  --------
-------
------

---- ---------------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
  ---- --------------- -------
------

--------
  ------------ -
    ----------------------------
      --------- -------
      ----------- --
      ----------- --
      ----------- -----
      -------------- -----
      ------- ---------- -
        ---------------- ------- ---------
      --
      --------- ---------- -
        -----------

- ----------------------------------------------------------- --------
---------------------------------------------------------------------------------------