FormData
1.FormData 对象的作用
- 模拟HTML表单,相当于将HTML表单映射成表单对象,自动将表单对象中的数据拼接成请求参数的格式。
- 异步上传二进制文件
2.FormData 对象的使用
- 准备 HTML 表单
<form id="form">
<input type="text" name="username" />
<input type="password" name="password" />
<input type="button"/>
</form>
- 将 HTML 表单转化为 formData 对象
var form = document.getElementById('form');
var formData = new FormData(form);
- 提交表单对象
xhr.send(formData);
注意:
- Formdata 对象不能用于 get 请求,因为对象需要被传递到 send 方法中,而 get 请求方式的请求参数只能放在请求地址的后面。
- 服务器端 bodyParser 模块不能解析 formData 对象表单数据,我们需要使用 formidable 模块进行解析。
实例:
首先:node搭建服务器(含本文所有路由)
// 引入框架express
const express = require('express');
//搭建服务器
const app = express();
//引入path模块
const path = require('path');
//引入接收复杂表单数据的模块
const formidable = require('formidable');
//静态文件访问功能
app.use(express.static(path.join(__dirname, 'public')));
//!formData对象使用方法
app.post('/formData', (req, res) => {
//创建formidable表单解析对象
const form = new formidable.IncomingForm();
//解析客户端传过来的forData对象
form.parse(req, (err, fields, files) => {
res.send(fields);
});
});
//!formData对象二进制数据上传
app.post('/upload', (req, res) => {
//创建formidable表单解析对象
const form = new formidable.IncomingForm();
//拼接上传的二进制文件路径
form.uploadDir = path.join(__dirname, 'public', 'uploads');
//保留上传文件后缀名
form.keepExtensions = true;
//解析客户端上传过来的formData对象
form.parse(req, (err, fields, files) => {
// res.send('ok');
res.send({
//将客户端传递过来的文件地址响应回客户端
path: files.attrName.path.split('public')[1]
})
})
})
//监听端口
app.listen(3000);
//控制台输出信息
console.log('服务器启动成功,端口号3000');
Ajax请求代码:
<form id="form">
<input type="text" name="username">
<input type="password" name="password">
<input type="button" value="提交" id="btn">
</form>
<script>
// 获取表单及按钮
var form = document.querySelector('#form');
var btn = document.querySelector('#btn');
//给btn添加点击事件
btn.addEventListener('click', function() {
//将普通的html表单转换成表单对象
var formData = new FormData(form);
//创建ajax对象
var xhr = new XMLHttpRequest();
//配置ajax对象(此处必须是post)
xhr.open('post', 'http://localhost:3000/formData');
//发送ajax请求
xhr.send(formData);
//监听xhr对象下的onload事件
xhr.onload = function() {
//通过对象http状态码进行判断
if (xhr.status == 200) {
console.log(xhr.responseText);
}
}
});
</script>
3.FormData 对象的实例方法
- 获取表单对象中属性的值
formData.get('key');
- 设置表单对象中属性的值
formData.set('key', 'value');
- 删除表单对象中属性的值
formData.delete('key');
- 向表单对象中追加属性值
formData.append('key', 'value');
注意:set 方法与 append 方法的区别是,在属性名已存在的情况下,set 会覆盖已有键名的值,append会保留两个值(请求参数内可查看)。
实例:
<!-- 创建普通的html表单 -->
<form id="form">
<input type="text" name="username">
<input type="password" name="password">
<input type="button" id="btn" value="提交">
</form>
<script type="text/javascript">
// 获取按钮
var btn = document.getElementById('btn');
// 获取表单
var form = document.getElementById('form');
// 为按钮添加点击事件
btn.onclick = function() {
// 将普通的html表单转换为表单对象
var formData = new FormData(form);
// console.log(formData);
/*
get('key') 获取表单对象属性的值
set('key', 'value') 设置表单对象属性的值
delete('key') 删除表单对象属性中的值
*/
console.log(formData.get('username'));
// 如果设置的表单属性存在 将会覆盖属性原有的值
formData.set('username', 'cwen');
formData.append('username', 'cwen');
// 如果设置的表单属性不存在 将会创建这个表单属性
formData.set('age', 18);
// 删除用户输入的密码
formData.delete('password');
// 创建ajax对象
var xhr = new XMLHttpRequest();
// 对ajax对象进行配置
xhr.open('post', 'http://localhost:3000/formData');
// 发送ajax请求
xhr.send(formData);
// 监听xhr对象下面的onload事件
xhr.onload = function() {
// 对象http状态码进行判断
if (xhr.status == 200) {
console.log(xhr.responseText);
}
}
// 创建空的表单对象
var f = new FormData();
f.append('sex', '男');
console.log(f.get('sex'));
}
</script>
4.FormData 二进制文件上传
<input type="file" id="file"/>
var file = document.getElementById('file')
// 当用户选择文件的时候
file.onchange = function () {
// 创建空表单对象
var formData = new FormData();
// 将用户选择的二进制文件追加到表单对象中
formData.append('attrName', this.files[0]);
// 配置ajax对象,请求方式必须为post
xhr.open('post', 'www.example.com');
xhr.send(formData);
}
5.FormData 文件上传进度展示
// 当用户选择文件的时候
file.onchange = function () {
// 文件上传过程中持续触发onprogress事件
xhr.upload.onprogress = function (ev) {
// 当前上传文件大小/文件总大小 再将结果转换为百分数
// 将结果赋值给进度条的宽度属性
bar.style.width = (ev.loaded / ev.total) * 100 + '%';
}
}
6.FormData 文件上传图片即时预览
核心:在我们将图片上传到服务器端以后,服务器端通常都会将图片地址做为响应数据传递到客户端,客户端可以从响应数据中获取图片地址,然后将图片再显示在页面中。
xhr.onload = function () {
var result = JSON.parse(xhr.responseText);
var img = document.createElement('img');
img.src = result.src;
img.onload = function () {
document.body.appendChild(this);
}
}
实例:综合4,5,6全面
<!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;
width: 300px;
height: 200px;
}
.padding img {
width: 100%;
height: 100%;
}
</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>
//获取元素
var file = document.querySelector('#file');
var bar = document.querySelector('#bar');
var box = document.querySelector('#box');
//为其添加onchange事件
file.onchange = function() {
//创建formData对象
const formData = new FormData();
//为formData追加属性
formData.append('attrName', this.files[0]);
//创建ajax对象
const xhr = new XMLHttpRequest();
//配置ajax对象
xhr.open('post', 'http://localhost:3000/upload');
//在文件上传过程中触发文件上传进度
xhr.upload.onprogress = function(e) {
// console.log(e);
// loaded当前上传大小;total文件总大小
//计算出当前进度的百分比
const result = (e.loaded / e.total) * 100 + '%';
//把计算的百分比给进度条(实现功能)
bar.style.width = result;
bar.innerHTML = result;
};
//发送请求
xhr.send(formData);
//监听服务器端返回到客户端的数据
xhr.onload = function() {
if (xhr.status == 200) {
// console.log(xhr.responseText);
//把接收到的响应转换成对象类型
const 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>
最后:输出结果与预期一致,nice。(欢迎探讨)
冲冲冲
下一篇:Ajax进阶(同源政策)