本文首发于公众号《前端全栈开发者》关注这个脱发、摆摊、卖货、持续学习的程序员，第一时间阅读最新文章，会优先两天发表新文章。关注即可领取大礼包，准能为你节省不少钱！

上传文件的能力是许多web和移动应用的关键需求，从将照片上传到社交媒体上到将简历发布到工作门户网站上，文件上传无处不在。

作为一名web开发人员，我们一定知道html提供了原生文件上传的支持，并借助于javascript的一点帮助。在html5中，file api被添加到dom中。利用它，我们可以读取 filelist 和其中的 file 对象，这就解决了文件的多种用例，即在本地加载文件或通过网络发送到服务器进行处理等。

在本文中，我们将讨论html文件上传支持的10种用法，希望你觉得它有用。

在任何时候，如果您想使用这些文件上传功能，都可以在这里找到：

html文件上传演示：
https://html-file-upload.netlify.app/

该演示的源代码在我的github存储库中，✋请随时关注我，并通过示例不断更新代码，如果您觉得有用，请给一个⭐。

源代码仓库：
https://github.com/atapas/html-file-upload

1.单个文件上传

我们可以将输入类型指定为 file，以在web应用程序中使用文件上传器功能。

<input type="file" id="file-uploader">

输入文件类型使用户可以通过按钮上传一个或多个文件，默认情况下，它允许使用操作系统的本地文件浏览器上传单个文件。

上传成功后，file api 可以使用简单的javascript代码读取 file 对象。要读取 file 对象，我们需要监听文件上传器的 change 事件。

首先，通过id获取文件上传器实例

const fileuploader = document.getelementbyid('file-uploader');

然后添加一个 change 事件侦听器，以在上传完成后读取文件对象，我们从 event.target.files 属性获取上传的文件信息。

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
});

在浏览器控制台中观察输出，注意 filelist 数组中的 file 对象拥有上传文件的所有元数据信息。

下面是相同示例的代码页，供您进一步研究

codepen：https://codepen.io/atapas/pen/rnloyrm

<div>
  <h1>单个文件上传</h1>
  <input type="file" id="file-uploader">
  <p>上传文件，并在浏览器控制台中查看输出。</p>
  <p id="feedback"></p>
</div>

const fileuploader = document.getelementbyid('file-uploader');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
  
  const feedback = document.getelementbyid('feedback');
  const msg = `file ${files[0].name} uploaded successfully!`;
  feedback.innerhtml = msg;
});

2.多文件上传

我们可以一次上传多个文件。为此，我们只需要在输入文件标签中添加一个名为 multiple 的属性即可。

<input type="file" id="file-uploader" multiple />

现在，文件浏览器将允许您上传一个或多个要上传的文件。就像前面的例子一样，你可以添加一个 change 事件处理程序来捕获上传文件的信息。您是否注意到 filelist 是一个数组？对，对于多个文件上传，数组将具有以下信息：

下面是codepen链接，用于探索多个文件上传。

codepen：https://codepen.io/atapas/pen/mweamyp

<div>
  <h1>多文件上传</h1>
  <input type="file" id="file-uploader" multiple>
  <p>上传多个文件并在浏览器控制台中查看输出</p>
  <p id="feedback"></p>
</div>

const fileuploader = document.getelementbyid('file-uploader');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
  
  // show the upload feedback
  const feedback = document.getelementbyid('feedback');
  const msg = `${files.length} file(s) uploaded successfully!`;
            feedback.innerhtml = msg;
});

3.了解文件元数据

每当我们上传一个文件时，file 对象都有元数据信息，如文件名、大小、最后更新时间、类型等，此信息对于进一步的验证和决策很有用。

// 通过id获取文件上传者
const fileuploader = document.getelementbyid('file-uploader');

// 监听 change 事件并读取元数据
fileuploader.addeventlistener('change', (event) => {
  // 获取filelist数组
  const files = event.target.files;

  // 循环浏览文件并获取元数据
  for (const file of files) {
    const name = file.name;
    const type = file.type ? file.type: 'na';
    const size = file.size;
    const lastmodified = file.lastmodified;
    console.log({ file, name, type, size, lastmodified });
  }
});

这是单个文件上传的输出：

使用此codepen进行进一步探索

codepen：https://codepen.io/atapas/pen/gomarjv

<div>
  <h1>read file metadata</h1>
  <input type="file" id="file-uploader">
  <p id="feedback"></p>
</div>

const fileuploader = document.getelementbyid('file-uploader');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
  
  for (const file of files) {
    const name = file.name;
    const type = file.type ? file.type : 'na';
    const size = file.size;
    const lastmodified = file.lastmodified;
    console.log({file, name, type, size, lastmodified});
    
    const feedback = document.getelementbyid('feedback');
    const msg = ` file name: ${name} <br/>
              file size: ${size} <br/>
              file type: ${type} <br/>
              file last modified: ${new date(lastmodified)}`;
              
    feedback.innerhtml = msg;
  }
});

4.了解文件 accept属性

我们可以使用 accept 属性来限制要上传的文件的类型，您可能希望在用户上传个人资料图片时，只显示允许浏览png格式图片类型。

<input type="file" id="file-uploader" accept=".jpg, .png" multiple>

在上面的代码中，文件浏览器将只允许扩展名为 jpg 和 png 的文件。

请注意，在这种情况下，文件浏览器会自动将文件选择类型设置为自定义而不是全部。但是，如果需要，您始终可以将其更改回所有文件。

使用此codepen探索 accept 属性

codepen：https://codepen.io/atapas/pen/ojxymrp

<div>
  <h1>只能选择.png和.jpg文件</h1>
  <input type="file" id="file-uploader" accept=".jpg, .png" multiple>
  <p>upload files and see the output in browser console</p>
</div>

const fileuploader = document.getelementbyid('file-uploader');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
});

5.管理文件内容

您可以在成功上传文件后显示文件内容。对于个人资料图片，如果上传后不立即向用户展示上传的图片，会造成混乱。

我们可以使用 filereader 对象将文件转换为二进制字符串。然后添加 load 事件侦听器，以在成功上传文件时获取二进制字符串。

// 获取filereader的实例
const reader = new filereader();

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  const file = files[0];

  // 上传后获取文件对象并读取
  // 数据作为url二进制字符串
  reader.readasdataurl(file);

  // 加载后，对字符串进行处理
  reader.addeventlistener('load', (event) => {
    // 在这里我们创建一个图像标签并添加图片
    const img = document.createelement('img');
    imagegrid.appendchild(img);
    img.src = event.target.result;
    img.alt = file.name;
  });
});

尝试在下面的codepen中选择一个图像文件，然后查看其渲染。

codepen：https://codepen.io/atapas/pen/zybvdjz

<div>
  <h1>显示文件内容</h1>
  <input type="file" id="file-uploader" accept=".jpg, .jpeg, .png" >
  <div id="image-grid"></div>
</div>

const fileuploader = document.getelementbyid('file-uploader');
const reader = new filereader();
const imagegrid = document.getelementbyid('image-grid');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  const file = files[0];
  reader.readasdataurl(file);
  
  reader.addeventlistener('load', (event) => {
    const img = document.createelement('img');
    imagegrid.appendchild(img);
    img.src = event.target.result;
    img.alt = file.name;
  });
});

6.验证文件大小

如我们所见，我们可以读取文件的大小元数据，实际上可以将其用于文件大小验证，您可能允许用户上传最大1mb的图像文件。让我们看看如何实现这一目标。

// 文件上传change事件的侦听器
fileuploader.addeventlistener('change', (event) => {
  // 读取文件大小
  const file = event.target.files[0];
  const size = file.size;

  let msg = '';

 // 检查文件大小是否大于1mb，并准备一条消息。
  if (size > 1024 * 1024) {
      msg = `<span style="color:red;">the allowed file size is 1mb. the file you are trying to upload is of ${returnfilesize(size)}</span>`;
  } else {
      msg = `<span style="color:green;"> a ${returnfilesize(size)} file has been uploaded successfully. </span>`;
  }

  // 向用户显示消息
  feedback.innerhtml = msg;
});

尝试上传不同大小的文件，以查看验证的工作原理

codepen：https://codepen.io/atapas/pen/pobjmkv

<div>
  <h1>检查文件大小</h1>
  <input type="file" id="file-uploader">
  
  <div id="feedback"></div  
</div>

const fileuploader = document.getelementbyid('file-uploader');
const feedback = document.getelementbyid('feedback');

fileuploader.addeventlistener('change', (event) => {
  const file = event.target.files[0];
  console.log('file', file);
  
  const size = file.size;
  console.log('size', size);
  let msg = '';
  
  if (size > 1024 * 1024) {
    msg = `<span style="color:red;">the allowed file size is 1mb. the file you are trying to upload is of ${returnfilesize(size)}</span>`;
  } else {
    msg = `<span style="color:green;"> a ${returnfilesize(size)} file has been uploaded successfully. </span>`;
  }
  feedback.innerhtml = msg;
});

function returnfilesize(number) {
  if(number < 1024) {
    return number + 'bytes';
  } else if(number >= 1024 && number < 1048576) {
    return (number/1024).tofixed(2) + 'kb';
  } else if(number >= 1048576) {
    return (number/1048576).tofixed(2) + 'mb';
  }
}

7.显示文件上传进度

更好的可用性是让你的用户知道文件上传的进程。现在，我们知道了 filereader 和读取和加载文件的事件。

const reader = new filereader();

filereader 有另一个事件，称为进度(progress)，知道已加载了多少。我们可以使用html5的 progress 标签来创建带有此信息的进度栏。

reader.addeventlistener('progress', (event) => {
  if (event.loaded && event.total) {
    // 计算完成百分比
    const percent = (event.loaded / event.total) * 100;
    // 将值设置为进度组件
    progress.value = percent;
  }
});

不如你试着上传一个大一点的文件，看看下面的codepen中的进度条工作情况如何？试试吧。

codepen：https://codepen.io/atapas/pen/eyzpwyj

<div>
  <h1>file upload progress</h1>
  <input type="file" id="file-uploader">
  
  <div id="feedback"></div>
  
  <label id="progress-label" for="progress"></label>
  <progress id="progress" value="0" max="100"> </progress>
</div>

const fileuploader = document.getelementbyid('file-uploader');
const feedback = document.getelementbyid('feedback');
const progress = document.getelementbyid('progress');

const reader = new filereader();

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  const file = files[0];
  reader.readasdataurl(file);
  
  reader.addeventlistener('progress', (event) => {
    if (event.loaded && event.total) {
      const percent = (event.loaded / event.total) * 100;
      progress.value = percent;
      document.getelementbyid('progress-label').innerhtml = math.round(percent) + '%';
      
      if (percent === 100) {
        let msg = `<span style="color:green;">file <u><b>${file.name}</b></u> has been uploaded successfully.</span>`;
        feedback.innerhtml = msg;
      }
    }
  });
});

8.目录上传呢？

我们可以上传整个目录吗？好吧，这是可能的，但有一些限制。有一个叫做 webkitdirectory 的非标准属性（至少在写这篇文章的时候是这样），允许我们上传整个目录。

虽然最初只针对基于webkit的浏览器实现，但webkitdirectory也可以在microsoft edge以及firefox 50和更高版本中使用。但是，即使它具有相对广泛的支持，它仍然不是标准的，除非您别无选择，否则不应该使用它。

您可以将此属性指定为

<input type="file" id="file-uploader" webkitdirectory />

这将允许您选择一个文件夹（又名目录）

用户必须提供确认信息才能上传目录，

用户单击“upload”按钮后，就会进行上传。这里要注意的重要一点：filelist 数组将以平面结构的形式包含有关上载目录中所有文件的信息。但关键是，对于每个 file 对象，webkitrelativepath 属性都会有目录路径。

例如，让我们考虑一个 main 目录及其下的其他文件夹和文件，

现在，file 对象将将 webkitrelativepath 填充为

您可以使用它在您选择的任何ui结构中呈现文件夹和文件。使用此codepen进行进一步探索。

codepen：https://codepen.io/atapas/pen/dyxyrkp

<div>
  <h1>upload directories</h1>
  <input type="file" id="file-uploader" webkitdirectory />
  
  <ul id="pathlist"></ul>
</div>

const fileuploader = document.getelementbyid('file-uploader');
const pathlist = document.getelementbyid('pathlist');

function removeallchildnodes(parent) {
    while (parent.firstchild) {
        parent.removechild(parent.firstchild);
    }
}

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  console.log('files', files);
  
  removeallchildnodes(pathlist);
  
  [...files].foreach((file, index) => {
    let path = document.createelement('li');
    path.innerhtml = file.webkitrelativepath;
    pathlist.appendchild(path);
  });
});

9.让我们拖放，上传

不支持拖放功能进行文件上传是一种古老的方式，不是吗？让我们看看如何通过几个简单的步骤来实现这一目标。

首先，创建一个放置区和一个可选的区域以显示上传的文件内容。我们将使用图像作为文件拖放到此处。

<div id="container">
  <h1>drag & drop an image</h1>
  <div id="drop-zone">
    drop here
  </div>

  <div id="content">
    your image to appear here..
  </div>
</div>

通过它们各自的id获取拖拽和内容区域。

const dropzone = document.getelementbyid('drop-zone');
const content = document.getelementbyid('content');

添加一个 dragover 事件处理程序，以显示将要复制的内容的效果，

dropzone.addeventlistener('dragover', event => {
  event.stoppropagation();
  event.preventdefault();
  event.datatransfer.dropeffect = 'copy';
});

接下来，定义放置图像时我们要做什么，我们将需要一个 drop 事件监听器来处理。

dropzone.addeventlistener('drop', event => {
  // 获取文件
  const files = event.datatransfer.files;

	// 现在，我们可以尽一切可能来展示文件内容在一个html元素中，如，div。
});

尝试在下面的codepen示例中拖放图像文件，并查看其工作原理，不要忘记查看代码以渲染拖放的图像。

codepen：https://codepen.io/atapas/pen/exyvoxn

<div id="container">
  <h1>drag & drop an image</h1>
  <div id="drop-zone"> drop here </div>
  <div id="content">your image to appear here.. </div>
</div>

const dropzone = document.getelementbyid('drop-zone');
const content = document.getelementbyid('content');

const reader = new filereader();

if (window.filelist && window.file) {
  dropzone.addeventlistener('dragover', event => {
    event.stoppropagation();
    event.preventdefault();
    event.datatransfer.dropeffect = 'copy';
  });
  
  dropzone.addeventlistener('drop', event => {
    content.innerhtml = '';
    event.stoppropagation();
    event.preventdefault();
    const files = event.datatransfer.files;
    console.log(files);
    
    reader.readasdataurl(files[0]);
  
    reader.addeventlistener('load', (event) => {
      content.innerhtml = '';
      const img = document.createelement('img');
      img.style.height = '400px';
      img.style.width = '400px';
      content.appendchild(img);
      img.src = event.target.result;
      img.alt = file.name;
      
    });
  }); 
}

10.使用objecturls处理文件

有一个称为 url.createobjecturl() 的特殊方法，可以从文件创建唯一的url，您也可以使用 url.revokeobjecturl() 方法释放它。

dom url.createobjecturl() 和 url.revokeobjecturl() 方法让你可以创建简单的url字符串，这些字符串可以用来引用任何可以使用dom文件对象引用的数据，包括用户计算机上的本地文件。

对象url的简单用法是：

img.src = url.createobjecturl(file);

使用此codepen可以进一步浏览对象url。提示：将此方法与前面#5中提到的方法进行比较。

<div>
  <h1>use object url</h1>
  <input type="file" id="file-uploader" accept=".jpg, .jpeg, .png" >
  
  <div id="image-grid"></div>
</div>

const fileuploader = document.getelementbyid('file-uploader');
const reader = new filereader();
const imagegrid = document.getelementbyid('image-grid');

fileuploader.addeventlistener('change', (event) => {
  const files = event.target.files;
  const file = files[0];
  
  const img = document.createelement('img');
  imagegrid.appendchild(img);
  img.src = url.createobjecturl(file);
  img.alt = file.name;
});

结束

很多时候，原生html功能足以让我们处理手中的用例。我发现，文件上传默认情况下提供了许多不错的选择。