【亲测免费】 Dragula 开源项目教程

2026-01-18 09:24:56作者：郦嵘贵Just

项目介绍

Dragula 是一个简单易用的 JavaScript 库，用于实现网页上的拖放功能。它支持跨容器拖放，并且提供了丰富的 API 来定制拖放行为。Dragula 的设计理念是尽可能地减少开发者的负担，让拖放功能的实现变得简单而直观。

项目快速启动

安装

你可以通过 npm 或直接下载源码的方式来安装 Dragula。

npm install dragula --save

或者直接在 HTML 文件中引入：

<link rel="stylesheet" href="dist/dragula.min.css">
<script src="dist/dragula.min.js"></script>

基本使用

以下是一个简单的示例，展示了如何在两个容器之间实现拖放功能。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Dragula 示例</title>
  <link rel="stylesheet" href="dist/dragula.min.css">
</head>
<body>
  <div id="left-container" class="container">
    <div>Item 1</div>
    <div>Item 2</div>
    <div>Item 3</div>
  </div>
  <div id="right-container" class="container">
    <div>Item 4</div>
    <div>Item 5</div>
    <div>Item 6</div>
  </div>

  <script src="dist/dragula.min.js"></script>
  <script>
    dragula([document.getElementById('left-container'), document.getElementById('right-container')]);
  </script>
</body>
</html>

应用案例和最佳实践

案例一：任务管理应用

在任务管理应用中，Dragula 可以用来实现任务的拖放排序。用户可以通过拖放任务卡片来调整任务的优先级或状态。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>任务管理应用</title>
  <link rel="stylesheet" href="dist/dragula.min.css">
  <style>
    .container {
      display: flex;
      justify-content: space-around;
    }
    .column {
      width: 30%;
      border: 1px solid #ccc;
      padding: 10px;
      min-height: 200px;
    }
  </style>
</head>
<body>
  <div class="container">
    <div id="todo" class="column">
      <h3>待办</h3>
      <div>任务 1</div>
      <div>任务 2</div>
    </div>
    <div id="in-progress" class="column">
      <h3>进行中</h3>
      <div>任务 3</div>
    </div>
    <div id="done" class="column">
      <h3>已完成</h3>
      <div>任务 4</div>
    </div>
  </div>

  <script src="dist/dragula.min.js"></script>
  <script>
    dragula([document.getElementById('todo'), document.getElementById('in-progress'), document.getElementById('done')]);
  </script>
</body>
</html>

案例二：购物车应用

在购物车应用中，Dragula 可以用来实现商品的拖放添加到购物车。用户可以通过拖放商品图片到购物车容器来添加商品。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>购物车应用</title>
  <link rel="stylesheet" href="dist/dragula.min.css">
  <style