<input type="file">
带有 type="file"
的 <input>
元素允许用户可以从他们的设备中选择一个或多个文件。选择后,这些文件可以使用提交表单的方式上传到服务器上,或者通过 Javascript 代码和文件 API 对文件进行操作。
尝试一下
值
文件 input 的 value
属性包含了一个字符串,表示已选择文件的路径。如果用户没有选择任何文件,则该值为空字符串(""
)。如果用户选择了多个文件,则 value
表示他们选择的文件列表中的第一个文件。可以使用 input 的 HTMLInputElement.files
属性标识其他文件。
备注:
为了阻止恶意软件猜测文件路径,该值的字符串表示总是以 C:\fakepath\
为前缀的文件名,而并不是文件的真实路径。
附加属性
除了被所有 <input>
元素共享的公共属性,file
类型的 input 还支持下列属性:
accept
accept
属性是一个字符串,它定义了文件 input 应该接受的文件类型。这个字符串是一个以逗号为分隔的唯一文件类型说明符列表。由于给定的文件类型可以用多种方式指定,因此当你需要给定格式的文件时,提供一组完整的类型指定符是非常有用的。
例如,可以通过多种方式识别 Microsoft Word 文件,因此接受 Word 文件的网站可能使用像这样的 <input>
:
<input
type="file"
id="docpicker"
accept=".doc,.docx,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document" />
capture
multiple
当指定布尔类型属性 multiple
时,文件 input 允许用户选择多个文件。
非标准属性
除了上面列出来的属性,下面的非标准属性在某些浏览器中可用。应该尽量避免使用它们,因为这样做将限制代码在没有实现它们的浏览器中的运行能力。
webkitdirectory
如果出现布尔属性 webkitdirectory
,表示在文件选择器界面中用户只能选择目录。更多细节和示例见 HTMLInputElement.webkitdirectory
。
尽管 webkitdirectory
最初仅为基于 Webkit 的浏览器实现,它还在 Microsoft Edge 和 Firefox 50 及其后版本中可用。然而,尽管它有相对广泛的支持,它仍然是非标准的。除非别无选择,否则不要使用它。
唯一文件类型说明符
唯一文件类型说明符是一个字符串,表示在 file
类型的 <input>
元素中用户可以选择的文件类型。每个唯一文件类型说明符可以采用下列形式之一:
- 一个以英文句号(“.”)开头的合法的不区分大小写的文件名扩展名。例如:
.jpg
、.pdf
或.doc
。 - 一个不带扩展名的 MIME 类型字符串。
- 字符串
audio/*
,表示“任何音频文件”。 - 字符串
video/*
,表示“任何视频文件”。 - 字符串
image/*
,表示“任何图片文件”。
accept
属性的值是包含一个或多个(用逗号分隔)唯一文件类型说明符的字符串。例如,一个文件选择器需要能被表示成一张图片的内容,包括标准的图片格式和 PDF 文件,大概是这样的:
<input type="file" accept="image/*,.pdf" />
使用文件输入
基本示例
<form method="post" enctype="multipart/form-data">
<div>
<label for="file">选择要上传的文件</label>
<input type="file" id="file" name="file" multiple />
</div>
<div>
<button>提交</button>
</div>
</form>
产生如下结果:
无论用户的设备或操作系统是什么,文件输入都提供一个按钮,打开一个允许用户选择文件的文件选择对话框。
通过包含上述的 multiple
属性,可以指定一次选择多个文件。用户可以用他们选择的平台允许的任何方式从文件选择器中选择多个文件(如按住 Shift 或 Control,然后单击)。如果只想让用户为每个 <input>
选择一个文件,那么省略 multiple
属性。
获取已选择文件的信息
被选择的文件以 HTMLInputElement.files
属性返回,它是包含一系列 File
对象的 FileList
对象。FileList
的行为像一个数组,可以通过检查 length
属性来获得已选择文件的数量。
每个 File
包含下列信息:
name
-
文件名。
lastModified
-
一个数字,指定文件最后一次修改的日期和时间,以 UNIX 新纪元(1970 年 1 月 1 日午夜)以来的毫秒数表示。
lastModifiedDate
已弃用-
一个
Date
对象,表示文件最后一次修改的日期和时间。这被弃用,并且不应使用。使用lastModified
作为替代。 size
-
以字节数为单位的文件大小。
type
-
文件的 MIME 类型。
webkitRelativePath
非标准-
一个字符串,指定了相对于在目录选择器中选择的基本目录的文件路径(即,一个设置了
webkitdirectory
属性的file
选择器)。这是非标准的,应该谨慎使用。
备注:
你可以在所有现代浏览器中读写 HTMLInputElement.files
的值;该特性已经添加到了 Firefox 57 中(见 Firefox bug 1384030)。
限制可接受的文件类型
通常,你不希望用户能够选择任意类型的文件;相反,你通常希望它们选择特定类型的文件。例如,如果你的文件输入让用户上传个人资料图片,你可能希望他们选择 Web 兼容的图像格式,如 JPEG 或 PNG。
可以用 accept
属性指定可接受的文件类型,它是一个以逗号间隔的文件扩展名和 MIME 类型列表。一些例子如下所示:
accept="image/png"
或accept=".png"
——接受 PNG 文件。accept="image/png, image/jpeg"
或accept=".png, .jpg, .jpeg"
——接受 PNG 或 JPEG 文件。accept="image/*"
——接受任何带有image/*
MIME 类型的文件。(许多移动设备也允许用户在使用它时用摄像头拍照。)accept=".doc,.docx,.xml,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document"
——接受类似于 MS Word 文档的任何文件。
让我们来看一个更完整的例子:
<form method="post" enctype="multipart/form-data">
<div>
<label for="profile_pic">选择要上传的文件</label>
<input
type="file"
id="profile_pic"
name="profile_pic"
accept=".jpg, .jpeg, .png" />
</div>
<div>
<button>提交</button>
</div>
</form>
上述代码产生和之前示例相似的结果:
这可能看起来很相似,但是如果你尝试用该输入选择一个文件,你将看到文件选择器只允许你选择 accept
值指定的文件类型(实际接口会按不同的浏览器和操作系统有所不同)。
accept
属性不验证所选文件的类型;它只是为浏览器提供提示来引导用户选择正确的文件类型。用户仍然可以(在大多数情况下)在文件选择器中切换一个选项,使其能够覆盖此选项并选择他们希望的任何文件,然后选择不正确的文件类型。
因此,应该确保 accept
属性得到适当的服务器端验证的支持。
注意事项
-
不能从脚本中设置文件选取器的值——做下面这样的事情是没有效果的:
jsconst input = document.querySelector("input[type=file]"); input.value = "foo";
-
当使用
<input type="file">
选择文件时,出于明显的安全原因,源文件的实际路径没有显示在 input 的value
属性中。实际上显示了文件名,并用C:\fakepath\
附加在路径的开头。这种怪癖有一些历史原因,但它在所有现代浏览器中都受到支持,而且实际上在规范中也有定义。
示例
在本例中,我们将展示一个稍微高级一点的文件选择器,它利用了在 HTMLInputElement.files
属性中可用的文件信息,并且展示了一些聪明的技巧。
备注: 你可以在 GitHub 中查看本示例的完整源代码——file-example.html(参见在线的运行实例)。我们不会解释 CSS;JavaScript 是主要的关注点。
首先,让我们看看 HTML:
<form method="post" enctype="multipart/form-data">
<div>
<label for="image_uploads">Choose images to upload (PNG, JPG)</label>
<input
type="file"
id="image_uploads"
name="image_uploads"
accept=".jpg, .jpeg, .png"
multiple />
</div>
<div class="preview">
<p>No files currently selected for upload</p>
</div>
<div>
<button>Submit</button>
</div>
</form>
这和我们之前看到的类似,没有什么要说明的。
接下来,让我们看一下 JavaScript。
在脚本的第一行,我们获得了对表单 input 本身和拥有 .preview
类的 <div>
元素的引用。然后,我们隐藏了 <input>
元素,这样做是因为文件输入往往很难看,难于设计样式,而且在跨浏览器中对它们的设计不一致。你可以通过单击 <label>
部分来激活 input
元素,因此,最好在视觉上隐藏 input
并将 label 设计成按钮的样式,这样用户如果想上传文件就会知道如何与之交互。
const input = document.querySelector("input");
const preview = document.querySelector(".preview");
input.style.opacity = 0;
备注:
使用 opacity
来隐藏文件输入,而不是使用 visibility: hidden
或者 display: none
,因为辅助技术将后两种样式解释为文件 input 是不可交互的。
接下来,我们将事件监听器添加到 input 中,以监听选择的值的更改(在本例中,当选择文件时)。事件监听器调用我们定制的 updateImageDisplay()
函数。
input.addEventListener("change", updateImageDisplay);
每当 updateImageDisplay()
函数被调用时,我们:
-
使用一个
while
循环来清空预览区<div>
留下的内容。 -
获取包含所有已选择文件信息的
FileList
对象,并将其用一个变量curFiles
保存。 -
通过检查
curFiles.length
是否等于 0 来检查是否没有文件被选择。如果是,则向预览区<div>
输出一条消息,表示没有选择文件。 -
如果选择了文件,我们将循环遍历每个文件,并将关于它的信息输出到预览区
<div>
。注意事项: -
我们使用定制的
validFileType()
函数来检查文件的类型是否正确(例如,用accept
属性指定的图片类型)。 -
如果是,我们:
- 将其名称和文件大小输出到预览区
<div>
的一个列表项中(从file.name
和file.size
获取这些信息)。定制的returnFileSize()
函数返回一个用 bytes/KB/MB 表示的可读性良好的文件大小(默认情况下,浏览器以绝对字节数报告大小)。 - 通过调用
URL.createObjectURL(curFiles[i])
来生成图片的一张缩略预览图。然后,通过创建一个新的<img>
来将这张图片也插入到列表项,并且将它的src
设置为缩略图。
- 将其名称和文件大小输出到预览区
-
如果文件类型无效,则在列表项中显示一条消息,告诉用户需要选择一个其他的文件类型。
function updateImageDisplay() {
while (preview.firstChild) {
preview.removeChild(preview.firstChild);
}
const curFiles = input.files;
if (curFiles.length === 0) {
const para = document.createElement("p");
para.textContent = "No files currently selected for upload";
preview.appendChild(para);
} else {
const list = document.createElement("ol");
preview.appendChild(list);
for (const file of curFiles) {
const listItem = document.createElement("li");
const para = document.createElement("p");
if (validFileType(file)) {
para.textContent = `File name ${file.name}, file size ${returnFileSize(
file.size,
)}.`;
const image = document.createElement("img");
image.src = URL.createObjectURL(file);
listItem.appendChild(image);
listItem.appendChild(para);
} else {
para.textContent = `File name ${file.name}: Not a valid file type. Update your selection.`;
listItem.appendChild(para);
}
list.appendChild(listItem);
}
}
}
定制的 validFileType()
函数接受一个 File
对象作为参数,然后使用 Array.prototype.includes()
检查 fileTypes
中是否有值和文件的 type
属性匹配。如果找到匹配项,函数返回 true
。如果没找到,返回 false
。
// https://developer.mozilla.org/zh-CN/docs/Web/Media/Formats/Image_types
const fileTypes = [
"image/apng",
"image/bmp",
"image/gif",
"image/jpeg",
"image/pjpeg",
"image/png",
"image/svg+xml",
"image/tiff",
"image/webp",
"image/x-icon",
];
function validFileType(file) {
return fileTypes.includes(file.type);
}
returnFileSize()
函数接受一个数字(字节数,取自当前文件的 size
属性)作为参数,并且将其转化为用 bytes/KB/MB 表示的可读性良好的文件大小。
function returnFileSize(number) {
if (number < 1024) {
return `${number} bytes`;
} else if (number >= 1024 && number < 1048576) {
return `${(number / 1024).toFixed(1)} KB`;
} else if (number >= 1048576) {
return `${(number / 1048576).toFixed(1)} MB`;
}
}
这个例子是这样的;演示一下:
规范
Specification |
---|
HTML Standard # file-upload-state-(type=file) |
浏览器兼容性
BCD tables only load in the browser
参见
- 在 web 应用中使用文件——包含许多其他关于
<input type="file">
和 File API 的有用示例。 - CSS 属性兼容性