npm 包 stump-sortable 使用教程

在前端开发中,我们经常需要实现对某些元素进行排序的需求,例如拖拽进行排序。在实现这样的需求时,我们可以使用一些现成的工具库来提高开发效率。其中一款较为优秀的库就是 stump-sortable,它是一款基于 jQuery 的拖拽排序插件,具有功能丰富、使用简便等特点,可以满足绝大多数需求。

安装

stump-sortable 可以通过 npm 包的方式进行安装,只需在项目中执行下列命令即可:

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

引入

安装完成后,我们需要在项目代码中引入该库,代码如下:

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

如果你使用的是 Script 标签引入,可以按照下列方式进行:

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

如何使用

该插件提供了两种使用方式:基本使用和高级使用。接下来我们将一一进行介绍。

基本使用

首先,我们需要在 HTML 中定义一个可排序的列表。例如:

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

然后,我们只需要在 JavaScript 中进行如下调用:

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

这样就可以实现对该列表的拖拽排序了。

高级使用

对于一些特殊的需求,我们需要对排序过程进行一些额外的操作,在这种情况下,我们可以使用高级用法来实现。例如,在排序时,需要在后台记录排序的结果,我们可以通过回调函数来实现此需求,代码如下:

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

在高级用法中,我们可以设置以下参数:

  • axis: 拖拽方向,取值可以是 'x' 或 'y'。
  • handle: 拖拽时使用的句柄。
  • connectWith: 多个可排序的列表之间的连接。
  • placeholder: 占位符元素的 DOM 样式。
  • forceHelperSize: 强制使用助手的大小来继承排序元素的大小。
  • forcePlaceholderSize: 强制使用占位符的大小来继承排序元素的大小。
  • tolerance: 容忍度,取值可以是 'intersect'、'pointer' 或 'touch'。
  • dropOnEmpty: 允许空位置开关。
  • cursor: 拖拽时使用的鼠标样式。
  • opacity: 拖拽时元素透明度。
  • scroll: 自动滚动开关。
  • scrollSensitivity: 滚动灵敏度。
  • scrollSpeed: 滚动速度。
  • appendTo: 排序容器的选择器。
  • zIndex: 兼容旧浏览器的 zIndex 值。
  • delay: 拖拽时延迟。
  • disabled: 禁用开关。
  • items: 排序项目的选择器。
  • helper: 助手元素的 DOM 样式。
  • opacity: 元素拖拽时的透明度。
  • revert: 元素释放时的动画效果。
  • scroll: 滚动容器的选择器。
  • scrollSensitivity: 容器滚动的灵敏度。
  • scrollSpeed: 容器滚动的速度。
  • tolerance: 拖拽灵敏度。
  • zIndex: 拖拽元素的 zIndex。
  • start: 拖拽开始时的回调函数。
  • stop: 拖拽停止时的回调函数。
  • update: 拖拽排序结束后的回调函数。

示例代码

下面是一个完整的示例代码,供大家参考:

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

总结

使用 stump-sortable 可以很方便地实现对某些元素进行排序的需求,在实现过程中,只需进行简单的配置即可,大幅提高开发效率。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/6005671381e8991b448e360f


猜你喜欢

  • npm 包 amx-ftp 使用教程

    amx-ftp 是一个基于 Node.js 的 FTP 客户端,可以用于上传、下载以及删除 FTP 服务器上的文件和文件夹。在前端开发中,经常需要用到上传和下载文件的操作,而 amx-ftp 可以很方...

    3 年前
  • npm 包 ndepcmp 使用教程

    前言 在前端开发中,使用 npm 管理依赖包已经成为事实上的标准。但是,在项目中使用的依赖包可能会存在冗余和重复,这会增加代码库的体积和加载时间。如何检测和清理这些冗余的依赖包是一个很有必要的技能。

    3 年前
  • npm 包 homebridge-plantower 使用教程

    在智能家居设备的潮流中,室内空气质量监测器越来越受欢迎。而在室内空气质量监测器中,Plantower 空气质量监测器是广受欢迎的一种。借助于 npm 包 homebridge-plantower,我们...

    3 年前
  • npm 包 buche-tools 使用教程

    前言 前端开发中,我们经常需要生成一些报告、文档或简单的交互式演示。为了方便实现这些功能,npm 包 buche-tools 提供了一种快速简便的方式。 在本文中,我们将介绍 buche-tools ...

    3 年前
  • npm 包 jquery-slim-webpack 使用教程

    前言 NPM 是一个非常流行的包管理器,可以用于管理 JavaScript 库和工具。其中一个常用的 JavaScript 库是 jQuery,它提供了一组优秀的 API,可以轻松地完成 DOM 操作...

    3 年前
  • npm 包 fist-js 使用教程

    在前端开发中,为了提高开发效率和满足特定场景的需求,我们通常会使用很多第三方库。而这些第三方库通常会以 npm 包的形式发行,方便我们通过 npm 安装和使用。今天我们将介绍一个 npm 包——fis...

    3 年前
  • npm 包 vsc-convert-ftp 使用教程

    前言 在前端开发过程中,经常需要将本地代码上传至服务器上。这时候通常需要通过 FTP 软件将本地代码上传至服务器,但是这种方式可能会比较麻烦,并且需要手动操作。为了提高效率,我们可以使用 npm 包 ...

    3 年前
  • npm 包 react-native-search-bar-tst 使用教程

    react-native-search-bar-tst 是一个 React Native 的搜索组件库,它提供了一个可定制的搜索条,具有高度的灵活性和用户友好性,允许您轻松地集成到您的应用程序中。

    3 年前
  • npm 包 xceling-session 使用教程

    在前端开发中,session 是非常重要的一个概念,它用以保存客户端与服务器交互过程中需要存储的会话数据。常常我们会使用一些 npm 包来帮助我们管理 session,xceling-session ...

    3 年前
  • npm 包 freewind-cli 使用教程

    前言 在现代前端开发中,npm 包的重要性不言而喻。除了常用的一些基础库,还有一些常常用到的工具包,比如 freewind-cli。 freewind-cli 是一个命令行工具,简化了前端开发中的许多...

    3 年前
  • npm 包 @gitpad/rlist-view 使用教程

    介绍 @gitpad/rlist-view 是一个基于 React 的组件库,它提供了一种类似瀑布流的列表展示方式,支持可加载更多、滚动加载等功能。同时,它还提供了丰富的配置选项,以及灵活的扩展方式,...

    3 年前
  • npm 包 gm-react-comp 使用教程

    简介 npm 包 gm-react-comp 是一个 React 组件库,提供了许多常用的 UI 组件,如按钮、输入框、下拉列表等。同时,它还包含了一些功能强大的组件,如表格、图表等,可以用于快速开发...

    3 年前
  • npm 包 hapi-router-cors 使用教程

    在网页开发中,跨域问题是一直存在的难题之一,而 hapi-router-cors 是一款用于解决后端 API 跨域问题的 npm 包。在本文中,我们将详细介绍 hapi-router-cors 的使用...

    3 年前
  • NPM包hapi-ip-limit使用教程

    在 Web 开发和应用程序设计中,有时需要限制客户端接口请求频率和访问次数。这需要使用第三方工具来控制攻击风险和保护用户安全。在npm上,有一个叫做hapi-ip-limit的包,它可以很好地解决这个...

    3 年前
  • npm 包 leasot-to-readme 使用教程

    随着前端开发的不断发展,代码维护与更新变得越来越困难。好的代码注释能够有效地提高代码可读性和可维护性。因此,开发者们都愿意在代码中加入注释。但是,当代码量较大时,注释也可能变得无法管理。

    3 年前
  • 前端必备工具:npm 包 pretty-heap-used 使用教程

    在前端开发中,我们常常需要关注应用的内存使用情况,及时发现和解决内存泄漏等问题。而在 Node.js 环境中,有一个非常实用的 npm 包——pretty-heap-used,可以帮助我们更直观地了解...

    3 年前
  • npm 包 node-red-contrib-b3ts-bms 使用教程

    #npm 包 node-red-contrib-b3ts-bms 使用教程 ##介绍 node-red-contrib-b3ts-bms 是一个 Node-RED 的扩展包。

    3 年前
  • npm 包 timers.js 使用教程

    在前端开发中,我们常常需要借助计时器来实现各种定时任务。timers.js 是一个基于 Node.js 的 npm 包,它提供了一系列常用的计时器方法,使得定时任务的编写变得更加简单和方便。

    3 年前
  • npm 包 test_with_ava 使用教程

    在前端开发中,我们常常需要对代码进行测试,以保证代码的稳定性和可靠性。然而,测试代码的编写和维护都是一项费时费力的工作。为了解决这个问题,社区中涌现了很多优秀的测试框架,其中就包括本文介绍的 npm ...

    3 年前
  • npm 包 wordize 使用教程

    前言 在前端开发中,经常需要使用字符串转换或解析功能,如将下划线命名法转换为驼峰命名法。为了提高开发效率,我们需要运用更高效的方式实现这些功能。这里介绍一款 NPM 包 wordize,它可以帮助我们...

    3 年前

相关推荐

    暂无文章