Ajax上传文件进度条Codular

作者: 我等他
来源: 51数据库
2021-09-03

现在,人们喜欢在浏览网页时做一些其他事情而不离开该网页,这通常是通过ajax来实现.大多数情况,人们使用jquery来实现,但是随着浏览器的进步,人们比不需要这么做.这里我们将介绍如何在不离开页面的情况下将文件上传到服务器，我们将使用与我们之前的文章中使用的相同的后端php代码. 该脚本将上传文件至服务器,同时显示上传进度,并最终返回上传文件的链接地址.在某些情况下,你可能想要返回上传文件的id或者其他的应用信息. note: 该代码不支持较老的ie浏览器,通过can i use我们只支持ie10+

let's code

我们将从html结构开始，然后是javascript，然后我将给您提供php代码，这部分改编于之前教程 - 对php代码将不会有太多的解释。

html

我们只需要使用两个输入框，一个是文件类型file，另一个只是一个按钮button,以便我们可以监听到它被点击发送文件上传请求。我们还将有一个div，我们改变宽度以突出显示上传的状态。

如下所示:

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>js file upload with progress</title>
  <style>
  .container {
    width: 500px;
    margin: 0 auto;
  }
  .progress_outer {
    border: 1px solid #000;
  }
  .progress {
    width: 20%;
    background: #dedede;
    height: 20px; 
  }
  </style>
</head>
<body>
  <div class='container'>
    <p>
      select file: <input type='file' id='_file'> <input type='button' id='_submit' value='upload!'>
    </p>
    <div class='progress_outer'>
      <div id='_progress' class='progress'></div>
    </div>
  </div>
  <script src='upload.js'></script>
</body>
</html>

你将看到我们写了一点进度条样式,并在底部加入脚本文件来处理文件上传以及进度条展示.

javascript

首先, 我们需要拿到我们将要使用的标签,他们已经用id标记上.

var _submit = document.getelementbyid('_submit'), 
_file = document.getelementbyid('_file'), 
_progress = document.getelementbyid('_progress');

下一步,给_submit添加点击事件,用以上传我们选择的文件.为此,我们将使用addeventlistener方法,点击按钮后让其调用upload方法.

_submit.addeventlistener('click', upload);

现在我们可以继续处理上传,有以下几步:

检查被选中的文件
动态创建要发送的文件数据
通过js创建xmlhttprequest
上传文件

检查被选中的文件

我们的文件输入框_file有一个查询被选中文件队列的参数files-如果你设置了multiple参数将可以选多个文件.我们做简单的检查判断,如果该数组长度大于0,则继续,否则直接返回.

if(_file.files.length === 0){
  return;
}

现在,我们能确保已选择一个文件,我们将假定有一个文件,请记着数组的索引以0开头.

动态创建要发送的文件数据

为此,我们需要使用formdata,并将数据加入其中.下一步,我们可以在第3步生成的request中发送我们的formdata.我们使用的append方法,第一个参数与输入框的name属性相似,第二个参数是值value. 这里,我们将value设为我们选择的第一个文件.

var data = new formdata();
data.append('selectedfile', _file.files[0]);

当稍后向服务端发送数据时,我们将使用它.

通过上传脚本创建xmlhttprequest

这部分是非常基础的，我们将创建一个新的xmlhttprequest，并设置一些设置。首先我们将修改onreadystatechange的值来定义请求状态改变时的回调函数.该方法将会在状态改变时检查readystate,确保该值是我们想要的-在这个例子中就是4,代表请求完成.

第二步,我们将在upload属性上添加progress事件.这样我们能得到上传进度用来更新进度条.

var request = new xmlhttprequest();
request.onreadystatechange = function(){
  if(request.readystate == 4){
    try {
      var resp = json.parse(request.response);
    } catch (e){
      var resp = {
        status: 'error',
        data: 'unknown error occurred: [' + request.responsetext + ']'
      };
    }
    console.log(resp.status + ': ' + resp.data);
  }
};

当请求成功后,我们用try ... catch包裹解析返回值的过程,若解析失败,我们将创建我们自己的返回对象来使得后面的代码能不报错.可以自行决定如何处理返回值,这里我们只是将其输出至控制台.

现在我们来处理进度条:

request.upload.addeventlistener('progress', function(e){
  _progress.style.width = math.ceil(e.loaded/e.total) * 100 + '%';
}, false);

这里有一点点复杂,我们监听一个事件,该事件对象有两个我们比较关注的属性,loaded和total.loaded表示已经上传到服务器端的数值,total表示要发送的总数值,我们可以根据这两个值计算一个百分比,来设置进度条的宽度.

note: 这里没有加入任何动画特效,但你可以根据需要自定义动画效果.

上传文件

现在我们可以发送请求，我们将通过post请求到一个名为upload.php的文件，并使用send（）方法，参数为data，这样我们就可以发送数据:

request.open('post', 'upload.php');
request.send(data);

下面给出完整的javascript代码:

var _submit = document.getelementbyid('_submit'), 
_file = document.getelementbyid('_file'), 
_progress = document.getelementbyid('_progress');
var upload = function(){
  if(_file.files.length === 0){
    return;
  }
  var data = new formdata();
  data.append('selectedfile', _file.files[0]);
  var request = new xmlhttprequest();
  request.onreadystatechange = function(){
    if(request.readystate == 4){
      try {
        var resp = json.parse(request.response);
      } catch (e){
        var resp = {
          status: 'error',
          data: 'unknown error occurred: [' + request.responsetext + ']'
        };
      }
      console.log(resp.status + ': ' + resp.data);
    }
  };
  request.upload.addeventlistener('progress', function(e){
    _progress.style.width = math.ceil(e.loaded/e.total) * 100 + '%';
  }, false);
  request.open('post', 'upload.php');
  request.send(data);
}
_submit.addeventlistener('click', upload);

现在到了php...

php

这是我们使用的代码,你将注意到一些区别,主要是我们用最上面的json方法来返回值都作为json格式输出.这个php与之前文章中的代码相同,这也就意味着该方法只适用于小于500kb的png图片.此外,成功信息将返回已上传文件的路径:

<?php
// output json
function outputjson($msg, $status = 'error'){
  header('content-type: application/json');
  die(json_encode(array(
    'data' => $msg,
    'status' => $status
  )));
}
// check for errors
if($_files['selectedfile']['error'] > 0){
  outputjson('an error ocurred when uploading.');
}
if(!getimagesize($_files['selectedfile']['tmp_name'])){
  outputjson('please ensure you are uploading an image.');
}
// check filetype
if($_files['selectedfile']['type'] != 'image/png'){
  outputjson('unsupported filetype uploaded.');
}
// check filesize
if($_files['selectedfile']['size'] > 500000){
  outputjson('file uploaded exceeds maximum upload size.');
}
// check if the file exists
if(file_exists('upload/' . $_files['selectedfile']['name'])){
  outputjson('file with that name already exists.');
}
// upload file
if(!move_uploaded_file($_files['selectedfile']['tmp_name'], 'upload/' . $_files['selectedfile']['name'])){
  outputjson('error uploading file - check destination is writeable.');
}
// success!
outputjson('file uploaded successfully to "' . 'upload/' . $_files['selectedfile']['name'] . '".', 'success');

如果将所有内容都放在一起，您应该可以将文件上传到您期望的位置，并在浏览器的控制台内成功返回。

结束语

还有一些比较容易而又有效的方式来增强用户体验.通过将文件队列的多个文件加入到formdata,可以实现多文件上传. 有一点要说明,如果你是在本地做测试,你可能没办法看到进度条逐步变化,这取决于你本地机器的上传速度,我建议在服务器上使用较大的png文件做测试.

以上所述是小编给大家介绍的ajax上传文件进度条codular，希望对大家有所帮助