教你3分钟利用原生js实现有进度监听的文件上传预览组件

所属分类: 网络编程 / JavaScript 阅读数: 1414
收藏 0 赞 0 分享

前言

本文主要介绍如何使用原生js,通过面向对象的方式实现一个文件上传预览的组件,该组件利用FileReader来实现文件在前端的解析,预览,读取进度等功能,并对外暴露相应api来实现用户自定义的需求,比如文件上传,进度监听,自定义样式,读取成功回调等。

组件设计架构如下:

涉及的核心知识点如下:

  1. 闭包:减少变量污染,缩短变量查找范围
  2. 自执行函数
  3. file API:对文件进行读取,解析,监控文件事件
  4. DocumentFragment API:主要用来优化dom操作
  5. minix :用来实现对象混合
  6. 正则表达式:匹配文件类型
  7. class :类组件

github地址

用原生js实现具有进度监听的文件上传预览组件 (本地下载

Demo演示

使用:

<div id="test"></div>
<script src="./js/xjFile.js"></script>
<script>
 new xjFile({
  el: '#test', // 不填则直接默认挂在body上
  accept: 'image/png', // 可选
  clsName: 'xj-wrap', // 可选
  beforeUpload: function(e) { console.log(e) }, // 可选
  onProgress: function(e) { console.log(e) }, // 可选
  onLoad: function(e) { console.log(e) }, // 可选
  onError: function(e) { console.error('文件读取错误', e) } // 可选
 });
</script>

css代码:

.xj-wrap {
   position: relative;
   display: inline-block;
   border: 1px dashed #888;
   width: 200px;
   height: 200px;
   border-radius: 6px;
   overflow: hidden;
  }
  .xj-wrap::before {
   content: '+';
   font-size: 36px;
   position: absolute;
   transform: translate(-50%, -50%);
   left: 50%;
   top: 50%;
   color: #ccc;
  }
  .xj-wrap .xj-pre-img {
   width: 100%;
   height: 100%;
   background-repeat: no-repeat;
   background-position: center center;
   background-size: 100%;
  }
  .xj-file {
   position: absolute;
   left: 0;
   right: 0;
   bottom: 0;
   top: 0;
   opacity: 0;
   cursor: pointer;
  }

js代码:

(function(win, doc){
 function xjFile(opt) {
  var defaultOption = {
   el: doc.body,
   accept: '*', // 格式按照'image/jpg,image/gif'传
   clsName: 'xj-wrap',
   beforeUpload: function(e) { console.log(e) },
   onProgress: function(e) { console.log(e) },
   onLoad: function(e) { console.log(e) },
   onError: function(e) { console.error('文件读取错误', e) }
  };

  // 获取dom
  if(opt.el) {
   opt.el = typeof opt.el === 'object' ? opt.el : document.querySelector(opt.el);
  }

  this.opt = minix(defaultOption, opt);
  this.value = '';
  this.init();
 }

 xjFile.prototype.init = function() {
  this.render();
  this.watch();
 }

 xjFile.prototype.render = function() {
  var fragment = document.createDocumentFragment(),
   file = document.createElement('input'),
   imgBox = document.createElement('div');
  file.type = 'file';
  file.accept = this.opt.accept || '*';
  file.className = 'xj-file';
  imgBox.className = 'xj-pre-img';
  // 插入fragment
  fragment.appendChild(file);
  fragment.appendChild(imgBox);
  // 给包裹组件设置class
  this.opt.el.className = this.opt.clsName;
  this.opt.el.appendChild(fragment);
 }

 xjFile.prototype.watch = function() {
  var ipt = this.opt.el.querySelector('.xj-file');
  var _this = this;
  ipt.addEventListener('change', (e) => {
   var file = ipt.files[0];

   // 给组件赋值
   _this.value = file;

   var fileReader = new FileReader();

   // 读取文件开始时触发
   fileReader.onloadstart = function(e) {
    if(_this.opt.accept !== '*' && _this.opt.accept.indexOf(file.type.toLowerCase()) === -1) {
     fileReader.abort();
     _this.opt.beforeUpload(file, e);
     console.error('文件格式有误', file.type.toLowerCase());
    }
   }

   // 读取完成触发的事件
   fileReader.onload = (e) => {
    var imgBox = this.opt.el.querySelector('.xj-pre-img');
    if(isImage(file.type)) {
     imgBox.innerHTML = '';
     imgBox.style.backgroundImage = 'url(' + fileReader.result + ')';
    } else {
     imgBox.innerHTML = fileReader.result;
    }
    
    imgBox.title = file.name;

    this.opt.onLoad(e);
   }

   // 文件读取出错事件
   fileReader.onerror = (e) => {
    this.opt.onError(e);
   }

   // 文件读取进度事件
   fileReader.onprogress = (e) => {
    this.opt.onProgress(e);
   }

   isImage(file.type) ? fileReader.readAsDataURL(file) : fileReader.readAsText(file);
   
  }, false);
 }

 // 清除ipt和组件的值,支持链式调用
 xjFile.prototype.clearFile = function() {
  this.opt.el.querySelector('.xj-file').value = '';
  this.value = '';
  return this
 }

 // 简单对象混合
 function minix(source, target) {
  for(var key in target) {
   source[key] = target[key];
  }
  return source
 }

 // 检测图片类型
 function isImage(type) {
  var reg = /(image\/jpeg|image\/jpg|image\/gif|image\/png)/gi;
  return reg.test(type)
 }

 // 将方法挂载到window上
 win.xjFile = xjFile;

})(window, document);

class版(后期规划)

class版的也很简单,大致框架如下,感兴趣的朋友可以实现一下呦~

class XjFile {
 constructor(opt) {

 }

 init() {

 }

 watch() {

 }

 render() {

 }

 clearFile() {

 }

 minix(source, target) {
  
 }

 isImage(type) {
  
 }
}

总结

该组件仍有需要完善的地方,在后期使用中,会慢慢更新,优化,欢迎大家提出宝贵的建议。

好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对脚本之家的支持。

更多精彩内容其他人还在看

jQuery LigerUI 使用教程表格篇(1)

ligerGrid是ligerui系列插件的核心控件,用户可以快速地创建一个美观,而且功能强大的表格,支持排序、分页、多表头、固定列等等
收藏 0 赞 0 分享

JavaScript中常用的运算符小结

JavaScript中常用的运算符小结,需要的朋友可以参考下。
收藏 0 赞 0 分享

深入理解JavaScript系列(13) This? Yes,this!

在这篇文章里,我们将讨论跟执行上下文直接相关的更多细节。讨论的主题就是this关键字。实践证明,这个主题很难,在不同执行上下文中this的确定经常会发生问题
收藏 0 赞 0 分享

javascript (用setTimeout而非setInterval)

javascript (用setTimeout而非setInterval)如果用setInterval 可能出现 下次调用会在前一次调用前调用
收藏 0 赞 0 分享

JavaScript中两个感叹号的作用说明

用两个感叹号的作用就在于,如果明确设置了o中flag的值(非null/undefined/0""/等值),自然test就会取跟o.flag一样的值;如果没有设置,test就会默认为false,而不是null或undefined
收藏 0 赞 0 分享

javascript写的简单的计算器,内容很多,方法实用,推荐

最近用javascript写了一个简单的计算器,自己测试感觉还好,代码都给了注释,非常不错,推荐大家学习。
收藏 0 赞 0 分享

js的表单操作 简单计算器

javascript写的简单的加减乘除计算器,里面涉及到一些方法还是很实用的哦,新手不要错过
收藏 0 赞 0 分享

Jquery中删除元素的实现代码

empty用来删除指定元素的子元素,remove用来删除元素,或者设定细化条件执行删除
收藏 0 赞 0 分享

javaScript 利用闭包模拟对象的私有属性

JavaScript缺少块级作用域,没有private修饰符,但它具有函数作用域。作用域的好处是内部函数可以访问它们的外部函数的参数和变量(除了this和argument
收藏 0 赞 0 分享

为JavaScript类型增加方法的实现代码(增加功能)

大家在js开发过程中有些功能已经满足不了我们的需求,或没有我们需要的功能,那么我们就可以自己扩展下,个性化js
收藏 0 赞 0 分享
查看更多