JavaScript实现文件的拖拽上传功能

 更新时间:2024年02月26日 08:29:28   作者:程序员大澈  
文件上传,可以说是我们在项目中最常用的功能之一,文件上传一般有两种形式:点击上传和拖拽上传,而上传的内容,又大体包括:文件和文件夹,本文给大家介绍了JavaScript实现文件的拖拽上传功能的方法,需要的朋友可以参考下

1. 需求分析

文件上传,可以说是我们在项目中最常用的功能之一。

文件上传一般有两种形式:点击上传和拖拽上传。而上传的内容,又大体包括:文件和文件夹。

在项目中,我们一般都会直接选择使用UI库提供的上传组件,简单配置一下必要的属性,就实现了文件上传功能,至于组件底层实现的原理,是丝毫不知。

所以今天,针对文件和文件夹的拖拽上传功能,我整理了一下具体的实现,很简单一起瞧瞧。

2. 问题实现

先普及一下元素拖拽的几个API知识点,再放上文件拖拽上传的实现代码,并做简单的描述,最后做小结。

2.1 拖拽的6个API

元素拖拽的6个API分别是:dragenter、dragover、drop 以及 dragstart、drag、dragend。

ondragstart 事件:该事件在拖动操作开始时触发,即拖动操作的起点。通常在该事件的处理函数中设置拖动的数据和效果。

drag 事件:该事件在元素正在被拖动时持续触发,即在拖动过程中。可以在该事件的处理函数中执行一些实时的操作,例如更新元素的位置或显示一些效果。

dragend 事件:该事件在拖动操作结束时触发,即拖动操作的终点。通常在该事件的处理函数中执行一些清理操作或其他逻辑。

这三个事件通常用于控制拖动元素起始、过程和结束阶段的行为。

ondragenter 事件:该事件在拖动元素进入目标元素的范围时触发。可以在该事件的处理函数中执行一些显示效果或状态改变等操作。

ondragover 事件:该事件在拖动元素在目标元素上移动时持续触发,即在拖动元素在目标元素上悬停期间。通常需要阻止默认的拖放行为,以便允许在目标元素上释放。

ondrop 事件:该事件在拖动元素在目标元素上释放时触发。可以在该事件的处理函数中获取拖动的数据并执行相应的操作。

这三个事件通常用于控制目标元素在接受拖动元素时的行为。

2.2 文件拖拽上传实现

元素拖拽的6个API,这里我们只需要使用dragoverdrop这两个,就能实现文件拖拽上传。

下面简单描述一下实现过程,具体细节大家看代码就好,原理很简单。

先获取页面中的 DropFrame 元素,再为其添加两个事件监听器。

dragover 事件监听器:当有元素拖拽到 DropFrame 区域时触发,用于指定拖放操作的效果。这里必须阻止事件默认行为,否则文件是拖不上去的,会被浏览器所阻止。

drop 事件监听器:当在 DropFrame 区域释放拖拽的元素时触发,用于处理拖放完成后的操作。内部通过遍历 e.dataTransfer.items ,判断文件或文件夹,文件就直接获取File对象,文件夹则递归获取内部文件的File对象,最后依次单独上传服务器。

完整实现代码如下,复制即可使用。

<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title></title>
    <style>
        #DropFrame {
            width: 360px;
            height: 120px;
            background-color: #b8deff;
            border: solid 1px #3470ff;
        }
    </style>
</head>

<body>
    <!-- 拖拽区域 -->
    <div id="DropFrame">文件拖到这里上传</div>
</body>

<script>
    let dropFrame = document.getElementById('DropFrame');

    // 拖动元素在目标元素上悬停期间
    dropFrame.addEventListener('dragover', (e) => {
        // 阻止默认事件和冒泡 必须写
        e.stopPropagation();
        e.preventDefault();
    });

    // 拖动元素在目标元素上释放时触发
    dropFrame.addEventListener('drop', (e) => {
        // 阻止默认事件和冒泡 必须写
        e.stopPropagation();
        e.preventDefault();

        // 文件上传处理逻辑
        let items = e.dataTransfer.items;

        for (const item of items) {
            // 提取Entry对象
            const entry = item.webkitGetAsEntry();

            if (entry.isFile) {
                // 处理文件,拿到File文件
                entry.file((file) => {
                    console.log(file, 'file');

                    // 上传文件到服务器
                    // var formData = new FormData();
                    // formData.append('file', file);
                    // axios.post('/upload', formData, {})
                })

            } else {
                // 处理文件夹,拿到FileEntry对象
                const reader = entry.createReader()
                reader.readEntries((entries) => {
                    reHandleFile(entries)
                })
            }
        }

    });

    // 如果文件夹是多级,则递归读取
    const reHandleFile = (entries) => {
        for (const entry of entries) {
            if (entry.isFile) {
                // 处理文件,拿到File文件
                entry.file((file) => {
                    console.log(file, 'file');
                    // 上传文件到服务器
                    // var formData = new FormData();
                    // formData.append('file', file);
                    // axios.post('/upload', formData, {})
                })
            } else {
                // 处理文件夹,拿到FileEntry对象
                const reader = entry.createReader()
                reader.readEntries((entries) => {
                    // 递归
                    reHandleFile(entries)
                })
            }
        }
    }
</script>
</html>

2.3 小结

本文简单介绍了,元素拖拽的6个API,以及文件拖拽上传的实现过程。

元素拖拽的6个API,这里我们只需要使用dragoverdrop这两个,就能实现文件拖拽上传。

值得注意的是,必须阻止事件默认行为,否则文件是拖不上去的,会被浏览器所阻止。

结语

到此这篇关于JavaScript实现文件的拖拽上传功能的文章就介绍到这了,更多相关JavaScript文件拖拽上传内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JS的空值合并运算符(??)的使用

    JS的空值合并运算符(??)的使用

    空值合并运算符是一个逻辑运算符,当左侧的操作数为null或undefined时,会返回右侧操作数,否则返回左侧操作数,本文就来详细的介绍一下如何使用
    2023-12-12
  • javascript 选择文件夹对话框(web)

    javascript 选择文件夹对话框(web)

    web程序开发中经常会遇见选择文件夹的时候,这对于web程序员是一件麻烦的事情,由于本地安全限制JS不能访问本地文件,所以选择文件夹一般都避而不谈,笔者在写一个程序的时候也遇见了同样的问题,开始尝试使用JS来遍历文件,结果都没有成功
    2009-07-07
  • js实现网页随机验证码

    js实现网页随机验证码

    这篇文章主要为大家详细介绍了js实现网页随机验证码,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-10-10
  • 微信小程序实现发送验证码按钮效果

    微信小程序实现发送验证码按钮效果

    这篇文章主要为大家详细介绍了微信小程序实现发送验证码按钮效果,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-12-12
  • JavaScript中的稀疏数组与密集数组[译]

    JavaScript中的稀疏数组与密集数组[译]

    一般来说,JavaScript中的数组是稀疏的,也就是说,数组中的元素之间可以有空隙,因为一个数组其实就是一个键值映射.本文解释了如何创建稀疏数组和不稀疏的数组
    2012-09-09
  • JavaScript寄生组合式继承实例详解

    JavaScript寄生组合式继承实例详解

    这篇文章主要介绍了JavaScript寄生组合式继承,结合实例形式详细分析了寄生组合式继承原理、实现方法与相关注意事项,需要的朋友可以参考下
    2018-01-01
  • javascript函数定义的几种区别小结

    javascript函数定义的几种区别小结

    本篇文章主要是对javascript函数定义的几种区别进行了详细的总结介绍,需要的朋友可以过来参考下,希望对大家有所帮助
    2014-01-01
  • Javascript自定义事件详解

    Javascript自定义事件详解

    这篇文章主要介绍了Javascript自定义事件,本质就是观察者模式,好处就是将绑定事件和触发事件相互隔离开等等,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-01-01
  • javascript 将共享属性迁移到原型中去的实现方法

    javascript 将共享属性迁移到原型中去的实现方法

    下面小编就为大家带来一篇javascript 将共享属性迁移到原型中去的实现方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-08-08
  • Node.js:Windows7下搭建的Node.js服务(来玩玩服务器端的javascript吧,这可不是前端js插件)

    Node.js:Windows7下搭建的Node.js服务(来玩玩服务器端的javascript吧,这可不是前端js插件

    什么是Node.js?还服务器端javascript?对于这个概念我在这篇文章不做解释,可以自己去搜索了解下,服务器端js不是新技术,只是最近的node.js的火爆让他爆发了,我会在以后的文章里解释什么是node.js。
    2011-06-06

最新评论