原标题:有用!10个HTML文件上传技巧
上传文件的能力是许多Web和移动应用的关键需求,从将照片上传到社交媒体上到将简历发布到工作门户网站上,文件上传无处不在。
作为一名Web开发人员,我们一定知道HTML提供了原生文件上传的支持,并借助于Java的一点帮助。在HTML5中,File API被添加到DOM中。利用它,我们可以读取FileList和其中的File对象,这就解决了文件的多种用例,即在本地加载文件或通过网络发送到服务器进行处理等。
在本文中,我们将讨论HTML文件上传支持的10种用法,希望你觉得它有用。
在任何时候,如果您想使用这些文件上传功能,都可以在这里找到:
HTML文件上传演示:https://html-file-upload.netlify.app/
该演示的源代码在我的Github存储库中,✋请随时关注我,并通过示例不断更新代码,如果您觉得有用,请给一个⭐。
源代码仓库:https://github.com/atapas/html-file-upload1.单个文件上传
我们可以将输入类型指定为file,以在Web应用程序中使用文件上传器功能。
< inputtype= "file"id= "file-uploader">
输入文件类型使用户可以通过按钮上传一个或多个文件,默认情况下,它允许使用操作系统的本地文件浏览器上传单个文件。
上传成功后,File API可以使用简单的Java代码读取File对象。要读取File对象,我们需要监听文件上传器的change事件。
首先,通过ID获取文件上传器实例
constfileUploader = document.getElementById( 'file-uploader');
然后添加一个change事件侦听器,以在上传完成后读取文件对象,我们从event.target.files属性获取上传的文件信息。
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
});
在浏览器控制台中观察输出,注意FileList数组中的File对象拥有上传文件的所有元数据信息。
下面是相同示例的代码页,供您进一步研究
CodePen:https://codepen.io/atapas/pen/rNLOyRm
< div>
< h1>单个文件上传 h1>
< inputtype= "file"id= "file-uploader">
< p>上传文件,并在浏览器控制台中查看输出。 p>
< pid= "feedback"> p>
div>
constfileUploader = document.getElementById( 'file-uploader');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
constfeedback = document.getElementById( 'feedback');
constmsg = `File ${files[ 0].name}uploaded successfully!`;
feedback.innerHTML = msg;
});
2.多文件上传
我们可以一次上传多个文件。为此,我们只需要在输入文件标签中添加一个名为multiple的属性即可。
< inputtype= "file"id= "file-uploader"multiple/>
现在,文件浏览器将允许您上传一个或多个要上传的文件。就像前面的例子一样,你可以添加一个change事件处理程序来捕获上传文件的信息。您是否注意到FileList是一个数组?对,对于多个文件上传,数组将具有以下信息:
下面是CodePen链接,用于探索多个文件上传。
CodePen:https://codepen.io/atapas/pen/MWeamYp
< div>
< h1>多文件上传 h1>
< inputtype= "file"id= "file-uploader"multiple>
< p>上传多个文件并在浏览器控制台中查看输出 p>
< pid= "feedback"> p>
div>
constfileUploader = document.getElementById( 'file-uploader');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
// show the upload feedback
constfeedback = document.getElementById( 'feedback');
constmsg = ` ${files.length}file(s) uploaded successfully!`;
feedback.innerHTML = msg;
});
3.了解文件元数据
每当我们上传一个文件时,File对象都有元数据信息,如文件名、大小、最后更新时间、类型等,此信息对于进一步的验证和决策很有用。
// 通过id获取文件上传者
constfileUploader = document.getElementById( 'file-uploader');
// 监听 change 事件并读取元数据
fileUploader.addEventListener( 'change', (event) => {
// 获取FileList数组
constfiles = event.target.files;
// 循环浏览文件并获取元数据
for( constfile offiles) {
constname = file.name;
consttype = file.type ? file.type: 'NA';
constsize = file.size;
constlastModified = file.lastModified;
console.log({ file, name, type, size, lastModified });
}
});
这是单个文件上传的输出:
使用此CodePen进行进一步探索
CodePen:https://codepen.io/atapas/pen/gOMaRJv
< div>
< h1>Read File Metadata h1>
< inputtype= "file"id= "file-uploader">
< pid= "feedback"> p>
div>
constfileUploader = document.getElementById( 'file-uploader');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
for( constfile offiles) {
constname = file.name;
consttype = file.type ? file.type : 'NA';
constsize = file.size;
constlastModified = file.lastModified;
console.log({file, name, type, size, lastModified});
constfeedback = document.getElementById( 'feedback');
constmsg = ` File Name: ${name}
File Size: ${size}
File type: ${type}
File Last Modified: ${ newDate(lastModified)}` ;
feedback.innerHTML = msg;
}
});
4.了解文件 accept属性
我们可以使用accept属性来限制要上传的文件的类型,您可能希望在用户上传个人资料图片时,只显示允许浏览png格式图片类型。
< inputtype= "file"id= "file-uploader"accept= ".jpg, .png"multiple>
在上面的代码中,文件浏览器将只允许扩展名为jpg和png的文件。
请注意,在这种情况下,文件浏览器会自动将文件选择类型设置为自定义而不是全部。但是,如果需要,您始终可以将其更改回所有文件。
使用此CodePen探索accept属性
CodePen:https://codepen.io/atapas/pen/OJXymRP
< div>
< h1>只能选择.png和.jpg文件 h1>
< inputtype= "file"id= "file-uploader"accept= ".jpg, .png"multiple>
< p>Upload files and see the output in browser console p>
div>
constfileUploader = document.getElementById( 'file-uploader');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
});
5.管理文件内容
您可以在成功上传文件后显示文件内容。对于个人资料图片,如果上传后不立即向用户展示上传的图片,会造成混乱。
我们可以使用FileReader对象将文件转换为二进制字符串。然后添加load事件侦听器,以在成功上传文件时获取二进制字符串。
// 获取FileReader的实例
constreader = newFileReader;
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
constfile = files[ 0];
// 上传后获取文件对象并读取
// 数据作为URL二进制字符串
reader.readAsDataURL(file);
// 加载后,对字符串进行处理
reader.addEventListener( 'load', (event) => {
// 在这里我们创建一个图像标签并添加图片
constimg = document.( 'img');
imageGrid.(img);
img.src = event.target.result;
img.alt = file.name;
});
});
尝试在下面的CodePen中选择一个图像文件,然后查看其渲染。
CodePen:https://codepen.io/atapas/pen/zYBvdjZ
< div>
< h1>显示文件内容 h1>
< inputtype= "file"id= "file-uploader"accept= ".jpg, .jpeg, .png">
< divid= "image-grid"> div>
div>
constfileUploader = document.getElementById( 'file-uploader');
constreader = newFileReader;
constimageGrid = document.getElementById( 'image-grid');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
constfile = files[ 0];
reader.readAsDataURL(file);
reader.addEventListener( 'load', (event) => {
constimg = document.( 'img');
imageGrid.(img);
img.src = event.target.result;
img.alt = file.name;
});
});
6.验证文件大小
如我们所见,我们可以读取文件的大小元数据,实际上可以将其用于文件大小验证,您可能允许用户上传最大1MB的图像文件。让我们看看如何实现这一目标。
// 文件上传change事件的侦听器
fileUploader.addEventListener( 'change', (event) => {
// 读取文件大小
constfile = event.target.files[ 0];
constsize = file.size;
letmsg = '';
// 检查文件大小是否大于1MB,并准备一条消息。
if(size > 1024* 1024) {
msg = `The allowed file size is 1MB. The file you are trying to upload is of ${returnFileSize(size)}`;
} else{
msg = ` A ${returnFileSize(size)}file has been uploaded successfully. `;
}
// 向用户显示消息
feedback.innerHTML = msg;
});
尝试上传不同大小的文件,以查看验证的工作原理
CodePen:https://codepen.io/atapas/pen/pobjMKv
< div>
< h1>检查文件大小 h1>
< inputtype= "file"id= "file-uploader">
< divid= "feedback"> div
div>
constfileUploader = document.getElementById( 'file-uploader');
constfeedback = document.getElementById( 'feedback');
fileUploader.addEventListener( 'change', (event) => {
constfile = event.target.files[ 0];
console.log( 'file', file);
constsize = file.size;
console.log( 'size', size);
letmsg = '';
if(size > 1024* 1024) {
msg = `The allowed file size is 1MB. The file you are trying to upload is of ${returnFileSize(size)}`;
} else{
msg = ` A ${returnFileSize(size)}file has been uploaded successfully. `;
}
feedback.innerHTML = msg;
});
functionreturnFileSize( number){
if(number < 1024) {
returnnumber + 'bytes';
} elseif(number >= 1024&& number < 1048576) {
return(number/ 1024).toFixed( 2) + 'KB';
} elseif(number >= 1048576) {
return(number/ 1048576).toFixed( 2) + 'MB';
}
}
7.显示文件上传进度
更好的可用性是让你的用户知道文件上传的进程。现在,我们知道了FileReader和读取和加载文件的事件。
constreader = newFileReader;
FileReader有另一个事件,称为进度(progress),知道已加载了多少。我们可以使用HTML5的progress标签来创建带有此信息的进度栏。
reader.addEventListener( 'progress', (event) => {
if(event.loaded && event.total) {
// 计算完成百分比
constpercent = (event.loaded / event.total) * 100;
// 将值设置为进度组件
progress.value = percent;
}
});
不如你试着上传一个大一点的文件,看看下面的CodePen中的进度条工作情况如何?试试吧。
CodePen:https://codepen.io/atapas/pen/eYzpwYj
< div>
< h1>File upload progress h1>
< inputtype= "file"id= "file-uploader">
< divid= "feedback"> div>
< labelid= "progress-label"for= "progress"> label>
< progressid= "progress"value= "0"max= "100"> progress>
div>
constfileUploader = document.getElementById( 'file-uploader');
constfeedback = document.getElementById( 'feedback');
constprogress = document.getElementById( 'progress');
constreader = newFileReader;
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
constfile = files[ 0];
reader.readAsDataURL(file);
reader.addEventListener( 'progress', (event) => {
if(event.loaded && event.total) {
constpercent = (event.loaded / event.total) * 100;
progress.value = percent;
document.getElementById( 'progress-label').innerHTML = Math.round(percent) + '%';
if(percent === 100) {
letmsg = `File ${file.name} has been uploaded successfully.`;
feedback.innerHTML = msg;
}
}
});
});
8.目录上传呢?
我们可以上传整个目录吗?好吧,这是可能的,但有一些限制。有一个叫做webkitdirectory的非标准属性(至少在写这篇文章的时候是这样),允许我们上传整个目录。
虽然最初只针对基于WebKit的浏览器实现,但webkitdirectory也可以在Microsoft Edge以及Firefox 50和更高版本中使用。但是,即使它具有相对广泛的支持,它仍然不是标准的,除非您别无选择,否则不应该使用它。
您可以将此属性指定为
< inputtype= "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>
< inputtype= "file"id= "file-uploader"webkitdirectory/>
< ulid= "pathList"> ul>
div>
constfileUploader = document.getElementById( 'file-uploader');
constpathList = document.getElementById( 'pathList');
functionremoveAllChildNodes( parent){
while(parent.firstChild) {
parent.removeChild(parent.firstChild);
}
}
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
console.log( 'files', files);
removeAllChildNodes(pathList);
[...files].forEach( ( file, index) =>{
letpath = document.( 'li');
path.innerHTML = file.webkitRelativePath;
pathList.(path);
});
});
9.让我们拖放上传
不支持拖放功能进行文件上传是一种古老的方式,不是吗?让我们看看如何通过几个简单的步骤来实现这一目标。
首先,创建一个放置区和一个可选的区域以显示上传的文件内容。我们将使用图像作为文件拖放到此处。
< divid= "container">
< h1>Drag & Drop an Image h1>
< divid= "drop-zone">
DROP HERE
div>
< divid= "content">
Your image to appear here..
div>
div>
通过它们各自的ID获取拖拽和内容区域。
constdropZone = document.getElementById( 'drop-zone');
constcontent = document.getElementById( 'content');
添加一个dragover事件处理程序,以显示将要复制的内容的效果,
dropZone.addEventListener( 'dragover', event => {
event.stopPropagation;
event.preventDefault;
event.dataTransfer.dropEffect = 'copy';
});
接下来,定义放置图像时我们要做什么,我们将需要一个drop事件监听器来处理。
dropZone.addEventListener( 'drop', event => {
// 获取文件
constfiles = event.dataTransfer.files;
// 现在,我们可以尽一切可能来展示文件内容在一个HTML元素中,如,DIV。
});
尝试在下面的CodePen示例中拖放图像文件,并查看其工作原理,不要忘记查看代码以渲染拖放的图像。
CodePen:https://codepen.io/atapas/pen/ExyVoXN
< divid= "container">
< h1>Drag & Drop an Image h1>
< divid= "drop-zone">DROP HERE div>
< divid= "content">Your image to appear here.. div>
div>
constdropZone = document.getElementById( 'drop-zone');
constcontent = document.getElementById( 'content');
constreader = newFileReader;
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;
constfiles = event.dataTransfer.files;
console.log(files);
reader.readAsDataURL(files[ 0]);
reader.addEventListener( 'load', (event) => {
content.innerHTML = '';
constimg = document.( 'img');
img.style.height = '400px';
img.style.width = '400px';
content.(img);
img.src = event.target.result;
img.alt = file.name;
});
});
}
10.使用objectURLs处理文件
有一个称为URL.createObjectURL的特殊方法,可以从文件创建唯一的URL,您也可以使用URL.revokeObjectURL方法释放它。
DOMURL.createObjectURL和URL.revokeObjectURL方法让你可以创建简单的URL字符串,这些字符串可以用来引用任何可以使用DOM文件对象引用的数据,包括用户计算机上的本地文件。
对象URL的简单用法是:
img.src = URL.createObjectURL(file);
使用此CodePen可以进一步浏览对象URL。提示:将此方法与前面#5中提到的方法进行比较。
< div>
< h1>Use Object URL h1>
< inputtype= "file"id= "file-uploader"accept= ".jpg, .jpeg, .png">
< divid= "image-grid"> div>
div>
constfileUploader = document.getElementById( 'file-uploader');
constreader = newFileReader;
constimageGrid = document.getElementById( 'image-grid');
fileUploader.addEventListener( 'change', (event) => {
constfiles = event.target.files;
constfile = files[ 0];
constimg = document.( 'img');
imageGrid.(img);
img.src = URL.createObjectURL(file);
img.alt = file.name;
});
结束
很多时候,原生HTML功能足以让我们处理手中的用例。我发现,文件上传默认情况下提供了许多不错的选择。
原文:https://dev.to/atapas/10-useful-html-file-upload-tips-for-web-developers-2d1d
点分享
点点赞
责任编辑: