FormData 对象的作用
- 模拟HTML表单, 相当于将HTML表单映射成表单对象, 自动将表单对象中的数据拼接成请求参数的格式。
- 异步上传二进制文件
FormData 对象的使用
- 准备HTML表单
<form id="form">
<input type="text" name="username">
<input type="password" name="password">
<input type="button" value="提交" id="btn">
</form>
- 将HTML表单转化为 FormData对象
var form = document.getElementById('form')
var formData = new FormData(form)
- 提交表单
xhr.send(formData)
注意:
- FormData 对象不能用于
get请求
, 因为对象需要被传递到 send方法中, 而 get 请求方式的请求参数只能放在请求地址的后面。- 服务器端 body-parser 模块不能解析 FormData 对象表单数据, 我们需要使用fomidable 模块进行解析
FormData 对象的实例方法
- 获取表单对象中的属性的值
formData.get('key')
- 设置表单对象中属性的值
formData.set('key', 'value')
- 删除表单对象中属性的值
formData.delete('key')
- 向表单对象中追加属性值
formData.append('key', 'value')
注意:
set 方法
与append方法
的区别是, 在属性名已存在的情况下,set
会覆盖已有键名的值,append
会保留两个值
- 练习代码
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
<form id="form">
<input type="text" name="username">
<input type="password" name="password">
<input type="button" value="提交" id="btn">
</form>
<script>
var btn = document.getElementById('btn')
var form = document.getElementById('form')
btn.onclick = function () {
// 将普通的html表单转换为表单对象
var formData = new FormData(form)
console.log(formData.get('username'))
// 如果设置的表单属性存在 将会覆盖属性原有的值
formData.set('username', 'admin')
formData.append('username', 'zhangsan')
// 如果设置的编导属性不存在 将会创建这个表单属性
formData.set('age', 100)
// 删除用户输入的密码
formData.delete('password')
// 创建ajax对象
var xhr = new XMLHttpRequest()
xhr.open('post', 'http://localhost:3000/formData')
xhr.send(formData)
// 监听xhr对象下面的onload事件
xhr.onload = function () {
if (xhr.status === 200) {
console.log(xhr.responseText)
}
}
// 创建空的表单对象
var f = new FormData()
f.append('sex', '男')
console.log(f.get('sex'))
}
</script>
</body>
</html>
FormData 二进制文件上传/ 文件上传进度展示/文件上传图片即时预览
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<link rel="stylesheet" href="/assets/bootstrap/dist/css/bootstrap.min.css">
<style type="text/css">
.container {
padding-top: 60px;
}
.padding {
padding: 5px 0 20px 0;
}
</style>
</head>
<body>
<div class="container">
<div class="form-group">
<label>请选择文件</label>
<input type="file" id="file">
<div class="padding" id="box">
<!--<img src="" class="img-rounded img-responsive">-->
</div>
<div class="progress">
<div class="progress-bar" style="width: 0%;" id="bar">0%</div>
</div>
</div>
</div>
<script type="text/javascript">
// 获取文件选择控件
var file = document.getElementById('file');
// 获取进度条元素
var bar = document.getElementById('bar');
// 获取图片容器
var box = document.getElementById('box');
// 为文件选择控件添加onchanges事件
// 在用户选择文件时触发
file.onchange = function () {
// 创建空的formData表单对象
var formData = new FormData();
// 将用户选择的文件追加到formData表单对象中
formData.append('attrName', this.files[0]);
// 创建ajax对象
var xhr = new XMLHttpRequest();
// 对ajax对象进行配置
xhr.open('post', 'http://localhost:3000/upload');
// 在文件上传的过程中持续触发
xhr.upload.onprogress = function (ev) {
// ev.loaded 文件已经上传了多少
// ev.total 上传文件的总大小
var result = (ev.loaded / ev.total) * 100 + '%';
// 设置进度条的宽度
bar.style.width = result;
// 将百分比显示在进度条中
bar.innerHTML = result;
}
// 发送ajax请求
xhr.send(formData);
// 监听服务器端响应给客户端的数据
xhr.onload = function () {
// 如果服务器端返回的http状态码为200
// 说明请求是成功的
if (xhr.status == 200) {
// 将服务器端返回的数据显示在控制台中
var result = JSON.parse(xhr.responseText);
// 动态创建img标签
var img = document.createElement('img');
// 给图片标签设置src属性
img.src = result.path;
// 当图片加载完成以后
img.onload = function () {
// 将图片显示在页面中
box.appendChild(img);
}
}
}
}
</script>
</body>
</html>
- 服务端代码
const express = require('express')
const path = require('path')
const formidable = require('formidable')
const app = express()
app.use(express.static(path.join(__dirname, 'public')))
app.post('/formData', (req, res) => {
// 创建formidable表单解析对象
const form = new formidable.IncomingForm()
// 解析客户端传递过来的FormData对象
form.parse(req, (err, fields, files) => {
res.send(fields)
})
})
// 实现文件上传的路由
app.post('/upload', (req, res) => {
// 创建formidable表单解析对象
const form = new formidable.IncomingForm();
// 设置客户端上传文件的存储路径
form.uploadDir = path.join(__dirname, 'public', 'upload');
// 保留上传文件的后缀名字
form.keepExtensions = true;
// 解析客户端传递过来的FormData对象
form.parse(req, (err, fields, files) => {
// 将客户端传递过来的文件地址响应到客户端
res.send({
path: files.attrName.path.split('public')[1]
});
});
});
app.listen(3000, () => console.log('Server is running...'))