基于Node的React图片上传组件实现实例代码
前端之家收集整理的这篇文章主要介绍了
基于Node的React图片上传组件实现实例代码,
前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
写在前面
红旗不倒,誓把JavaScript进行到底!今天介绍我的开源项目 Royal 里的图片上传组件的前后端实现原理(React + Node),花了一些时间,希望对你有所帮助。
前端实现
遵循React 组件化的思想,我把图片上传做成了一个独立的组件(没有其他依赖),直接import即可。
//......
render() {
return (
)
}
uri 参数是必须传的,是图片上传的后端接口地址,接口怎么写下面会讲到。
组件render部分需要体现三个功能:
- 图片选取(dialog窗口)
- 可拖拽功能(拖拽容器)
- 可预览(预览列表)
- 上传按钮 (button)
- 上传完成图片地址和链接 (信息列表)
主render函数
Box">
this.handleChange(v)}
type="file"
size={this.state.size}
name="fileSelect"
accept="image/*"
multiple={this.state.multiple} />
this.handleDragHover(e)}
onDragLeave={(e)=>this.handleDragHover(e)}
onDrop={(e)=>this.handleDrop(e)}
className="upload-drag-area">
或者将图片拖到此处
{ this._renderPreview(); // 渲染
图片预览列表 }
)
}
渲染图片预览列表
{
return (
{item.name}
{this.state.progress[idx]}
)
})
} else {
return null
}
}
渲染图片上传信息列表
{
return (
上传成功,图片地址是:
);
})
} else {
return null;
}
}
前端要实现图片上传的原理就是通过构建FormData对象,把文件对象append()到该对象,然后挂载在XMLHttpRequest对象上 send() 到服务端。
获取文件对象需要借助 input 输入框的 change 事件来获取 句柄参数 e
this.handleChange(e)}
然后做以下处理:
图片类型的
文件
files = files.filter(function (file) {
return /image/i.test(file.type)
})
这时 files 就是 我们需要的文件对象组成的数组,把它 concat 到原有的 files里。
如此,接下来的操作 就可以 通过 this.state.files 取到当前已选中的 图片文件。
利用Promise处理异步上传
文件上传对于浏览器来说是异步的,为了处理 接下来的多图上传,这里引入了 Promise来处理异步操作:
{
let xhr = new XMLHttpRequest()
if (xhr.upload) {
//
上传中
xhr.upload.addEventListener("progress",(e) => {
// 处理
上传进度
this.handleProgress(file,e.loaded,e.total,idx);
},false)
//
文件上传成功或是失败
xhr.onreadystatechange = (e) => {
if (xhr.readyState === 4) {
if (xhr.status === 200) {
//
上传成功操作
this.handleSuccess(file,xhr.responseText)
// 把该
文件从
上传队列中
删除
this.handleDeleteFile(file)
resolve(xhr.responseText);
} else {
//
上传出错处理
this.handleFailure(file,xhr.responseText)
reject(xhr.responseText);
}
}
}
// 开始
上传
xhr.open("POST",this.state.uri,true)
let form = new FormData()
form.append("filedata",file)
xhr.send(form)
})
}
利用XMLHttpRequest对象发异步请求的好处是可以 计算请求处理的进度,这是fetch所不具备的。
我们可以为 xhr.upload 对象的 progress 事件添加事件监听:
{
// 处理
上传进度
this.handleProgress(file,i);
},false)
说明:idx参数是纪录多图上传队列的索引
显示
}
拖拽文件对于HTML5来说其实非常简单,因为它自带的几个事件监听机制可以直接做这类处理。主要用到的是下面三个:
this.handleDragHover(e)}
onDragLeave={(e)=>this.handleDragHover(e)}
onDrop={(e)=>this.handleDrop(e)}
取消拖拽时的浏览器行为:
处理拖拽进来的文件:
获取
文件列表对象
let files = e.target.files || e.dataTransfer.files
let count = this.state.multiple ? files.length : 1
for (let i = 0; i < count; i++) {
files[i].thumb = URL.createObjectURL(files[i])
}
// 转换为真正的数组
files = Array.prototype.slice.call(files,0)
// 过滤非
图片类型的
文件
files = files.filter(function (file) {
return /image/i.test(file.type)
})
this.setState({files: this.state.files.concat(files)})
}
支持多图上传我们需要在组件调用处设置属性:
上传
size = { 50 } // 一次最大
上传数量(虽没有上限,为保证服务端正常,建议50以下)
然后我们可以使用 Promise.all() 处理异步操作队列:
this.upload(file,idx))
Promise.all(_promises).then( (res) => {
// 全部
上传完成
this.handleComplete()
}).catch( (err) => { console.log(err) })
}
好了,前端工作已经完成,接下来就是Node的工作了。
后端实现
为了方便,后端采用的是express框架来快速搭建Http服务和路由。具体项目见我的github node-image-upload。逻辑虽然简单,但还是有几个可圈可点的地方:
本项目后端采用的是express,我们可以通过 res.header() 设置 请求的 “允许源” 来允许跨域调用:
设置为 * 说明允许任何 访问源,不太安全。建议设置成 你需要的 二级域名,如 jafeney.com。
除了 “允许源” ,其他还有 “允许头” 、”允许域”、 “允许方法”、”文本类型” 等。常用的设置如下:
ES6下的Ajax请求
ES6风格下的Ajax请求和ES5不太一样,在正式的请求发出之前都会先发一个 类型为 OPTIONS的请求 作为试探,只有当该请求通过以后,正式的请求才能发向服务端。
所以服务端路由 我们还需要 处理这样一个 请求:
注意:该请求同样需要设置跨域。
处理上传的图片引人了multiparty模块,用法很简单:
上传的
图片*/
router.post('/upload',function(req,next) {
//
生成multiparty对象,并配置
上传目标路径
var form = new multiparty.Form({uploadDir: './public/file/'});
//
上传完成后处理
form.parse(req,function(err,fields,files) {
var filesTmp = JSON.stringify(files,null,2);
var relPath = '';
if (err) {
// 保存失败
console.log('Parse error: ' + err);
} else {
//
图片保存成功!
console.log('Parse Files: ' + filesTmp);
//
图片处理
processImg(files);
}
});
});
Node处理图片需要引入 gm 模块,它需要用 npm 来安装:
BUG说明
注意:node的图形操作gm模块前使用必须 先安装 imagemagick 和 graphicsmagick,Linux (ubuntu)上使用apt-get 安装:
MacOS上可以用 Homebrew 直接安装:
预设尺寸
有些时候除了原图,我们可能需要把原图等比例缩小作为预览图或者缩略图。这个异步操作还是用Promise来实现:
为了方便排序和管理图片,我们按照 “年月日 + 时间戳 + 尺寸” 来命名图片:
至于图片尺寸 使用 gm的 size() 方法来获取,处理方式如下:
重命名
fs.rename(uploadedPath,function(err) {
if (err) {
reject(err)
} else {
console.log('rename ok!');
}
});
});
总结
对于大前端的工作,理解图片上传的前后端原理仅仅是浅层的。我们的口号是 “把JavaScript进行到底!”,现在无论是 ReactNative的移动端开发,还是NodeJS的后端开发,前端工程师可以做的工作早已不仅仅是局限于web页面,它已经渗透到了互联网应用层面的方方面面,或许,叫 全栈工程师 更为贴切吧。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程之家。