资讯

历史

科技

环境与自然

成长

游戏

财经

文学与艺术

美食

健康

家居

文化

情感

汽车

三农

军事

旅行

运动

教育

生活

星座命理

Draggable Element

创作时间:

作者:

@小白创作中心

Draggable Element

引用

CSDN

https://blog.csdn.net/mmc123125/article/details/144661416

在现代 Web 应用中，拖拽功能（Drag and Drop）是用户体验中不可或缺的一部分。它可以为用户提供更加直观和交互的操作体验，例如：拖动文件到上传区域、在列表中移动项目、调整元素大小等。在这篇文章中，我们将介绍如何使用 JavaScript 和 HTML5 的原生 API 来实现拖拽功能。

1. 什么是拖拽功能？

拖拽功能允许用户通过鼠标或触控操作在界面上移动页面元素。这种交互方式通常用于以下场景：

文件上传：将文件从桌面拖到浏览器上传区。
列表排序：允许用户拖动列表中的项来改变顺序。
窗口布局：调整面板、卡片、对话框等的顺序或位置。

HTML5 引入了新的拖拽 API，使得实现这一功能变得更加简单和灵活。借助这些 API，我们可以实现更加丰富的交互。

2. HTML5 提供的拖拽 API

HTML5 为我们提供了一组新的原生 API，主要包括以下几个部分：

draggable 属性：指示某个元素是否可以被拖拽。
dragstart 事件：当拖动操作开始时触发。
dragover 事件：当拖动的元素被拖动到另一个可放置的元素上时触发。
drop 事件：当拖动的元素放到目标位置时触发。
dragend 事件：当拖动操作结束时触发。

我们可以通过这些事件和属性来控制拖拽的过程。

3. 创建可拖拽的元素

在 HTML 中，我们可以通过设置 draggable="true" 属性来使元素变得可拖拽。然后，使用 JavaScript 来处理拖拽相关的事件。

示例：可拖拽的元素

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Draggable Element</title>
</head>
<body>
  <!-- 可拖拽的元素 -->
  <div id="dragme" draggable="true" style="width: 100px; height: 100px; background-color: lightblue; text-align: center; line-height: 100px;">
    Drag me!
  </div>
  <script>
    // 获取拖拽的元素
    const dragElement = document.getElementById('dragme');
    // 监听 dragstart 事件，当拖拽操作开始时
    dragElement.addEventListener('dragstart', (event) => {
      console.log('Drag started');
      // 设置拖拽时的数据，传递一个简单的文本
      event.dataTransfer.setData('text/plain', 'Dragged!');
    });
    // 监听 dragend 事件，拖拽结束时
    dragElement.addEventListener('dragend', (event) => {
      console.log('Drag ended');
    });
  </script>
</body>
</html>

在这个简单的示例中，div 元素被设置为可拖拽。当拖动开始时，dragstart 事件会被触发，并且我们通过 dataTransfer.setData 方法将一些数据传递到拖动操作中。

4. 实现拖拽操作的步骤

为了实现完整的拖拽功能，我们通常需要执行以下几个步骤：

标记可拖拽元素：通过设置 draggable="true" 属性。
监听 dragstart 事件：当拖拽操作开始时，可以处理一些初始化工作，比如设置拖拽数据。
监听 dragover 事件：让目标元素知道当前的拖拽操作，并允许元素接受放置。
监听 drop 事件：当拖拽的元素被放置到目标元素时，我们需要在这个事件中处理相应的操作。
监听 dragend 事件：操作结束后执行一些清理工作。

5. 实际案例：实现一个拖拽排序的列表

让我们通过一个具体的例子来演示如何使用这些 API 实现一个拖拽排序的列表。这个例子中的列表项可以被拖拽到不同的位置，从而重新排序。

HTML 结构

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Drag and Drop List</title>
  <style>
    #sortable {
      list-style-type: none;
      padding: 0;
    }
    #sortable li {
      background-color: lightcoral;
      padding: 20px;
      margin: 5px;
      cursor: move;
    }
  </style>
</head>
<body>
  <h2>Drag and Drop List</h2>
  <!-- 可拖拽的列表 -->
  <ul id="sortable">
    <li draggable="true">Item 1</li>
    <li draggable="true">Item 2</li>
    <li draggable="true">Item 3</li>
    <li draggable="true">Item 4</li>
    <li draggable="true">Item 5</li>
  </ul>
  <script>
    const sortableList = document.getElementById('sortable');
    let draggedItem = null;
    // 监听 dragstart 事件，当拖拽操作开始时
    sortableList.addEventListener('dragstart', (event) => {
      draggedItem = event.target;
      event.target.style.opacity = 0.5; // 设置拖拽时的透明度
    });
    // 监听 dragover 事件，允许拖拽到目标元素
    sortableList.addEventListener('dragover', (event) => {
      event.preventDefault(); // 阻止默认行为
      const target = event.target;
      if (target && target !== draggedItem && target.nodeName === 'LI') {
        const rect = target.getBoundingClientRect();
        const offset = event.clientY - rect.top;
        if (offset < rect.height / 2) {
          target.style.borderTop = '2px solid blue'; // 显示提示
          target.style.borderBottom = '';
        } else {
          target.style.borderTop = '';
          target.style.borderBottom = '2px solid blue'; // 显示提示
        }
      }
    });
    // 监听 drop 事件，放置拖拽项
    sortableList.addEventListener('drop', (event) => {
      event.preventDefault(); // 阻止默认行为
      const target = event.target;
      if (target && target !== draggedItem && target.nodeName === 'LI') {
        const rect = target.getBoundingClientRect();
        const offset = event.clientY - rect.top;
        if (offset < rect.height / 2) {
          sortableList.insertBefore(draggedItem, target); // 放置到目标项之前
        } else {
          sortableList.insertBefore(draggedItem, target.nextSibling); // 放置到目标项之后
        }
      }
      draggedItem.style.opacity = 1; // 重置透明度
      draggedItem.style.borderTop = '';
      draggedItem.style.borderBottom = '';
    });
    // 监听 dragend 事件，拖拽操作结束时
    sortableList.addEventListener('dragend', (event) => {
      event.target.style.opacity = 1; // 重置透明度
    });
  </script>
</body>
</html>

代码讲解：

HTML 结构：我们创建了一个包含多个 li 元素的列表，每个列表项都设置了 draggable="true"，使其可以被拖拽。
拖拽事件监听：

dragstart：标记拖拽开始，并修改被拖拽项的样式，使其变为半透明。
dragover：在目标元素上方拖动时，判断拖拽项的位置，动态更新目标项的边框，提示用户可以放置元素。
drop：将拖拽项放置到新的位置，调整列表的顺序。
dragend：重置拖拽项的样式，恢复其原始状态。

6. 总结

本文介绍了如何在 Web 应用中实现拖拽功能。通过利用 HTML5 的原生拖拽 API，我们可以实现各种交互功能，如拖动列表项、拖动文件等。通过组合 dragstart、dragover、drop 和 dragend 事件，我们可以构建出完整的拖拽交互系统。希望本教程能帮助你在项目中使用拖拽功能，为用户提供更加直观和便捷的操作体验。