aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/html/element/input/file/index.html
blob: 5bf3428f1544e7e608293bacfb85061aa948c48e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
---
title: <input type="file">
slug: Web/HTML/Element/Input/file
tags:
  - HTML
  - HTML 表单
  - 多个文件
  - 文件
  - 文件选择器
  - 目录选择器
  - 表单输入
  - 输入类型
translation_of: Web/HTML/Element/input/file
---
<div>{{HTMLRef}}</div>

<p>使用 <strong><code>type="file"</code> </strong>的 {{HTMLElement("input")}} 元素使得用户可以选择一个或多个元素以<a href="/zh-CN/docs/Learn/HTML/Forms">提交表单</a>的方式上传到服务器上,或者通过 Javascript 的 <a href="/zh-CN/docs/Web/API/File/Using_files_from_web_applications">File API</a> 对文件进行操作。</p>

<div>{{EmbedInteractiveExample("pages/tabbed/input-file.html", "tabbed-shorter")}}</div>

<div class="hidden">这个交互式示例的源代码存储在 GitHub 存储库中。如果你想为互动范例项目作出贡献,请克隆 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> 并发送给我们发送一个拉取请求。</div>

<table class="properties">
 <tbody>
  <tr>
   <td><strong><a href="#值"></a></strong></td>
   <td>A {{domxref("DOMString")}} 表示已选择文件的路径</td>
  </tr>
  <tr>
   <td><strong>事件</strong></td>
   <td>{{domxref("HTMLElement/change_event", "change")}} 和 {{domxref("HTMLElement/input_event", "input")}}</td>
  </tr>
  <tr>
   <td><strong>支持的公共属性</strong></td>
   <td>{{htmlattrxref("required", "input")}}</td>
  </tr>
  <tr>
   <td>
    <p><strong>附加属性</strong></p>
   </td>
   <td>{{htmlattrxref("accept", "input/file")}}, {{htmlattrxref("capture", "input/file")}}, {{htmlattrxref("files", "input/file")}}, {{htmlattrxref("multiple", "input/file")}}</td>
  </tr>
  <tr>
   <td><strong>IDL 属性</strong></td>
   <td><code>files</code> 和 <code>value</code></td>
  </tr>
  <tr>
   <td><strong>DOM 接口</strong></td>
   <td>
    <p>{{domxref("HTMLInputElement")}}</p>
   </td>
  </tr>
  <tr>
   <td><strong>属性</strong></td>
   <td>
    <p><a href="/zh-CN/docs/Web/API/HTMLInputElement">仅适用于类型为 <code>file</code> 元素的属性</a></p>
   </td>
  </tr>
  <tr>
   <td><strong>方法</strong></td>
   <td>{{domxref("HTMLInputElement.select", "select()")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="值"></h2>

<p>文件 input 的 {{htmlattrxref("value", "input")}} 属性包括了一个 {{domxref("DOMString")}},表示已选择文件的路径。如果用户选择了多个文件,则 <code>value</code> 表示他们选择的文件列表中的第一个文件。 可以使用 input 的 <code>HTMLInputElement.files</code> 属性标识其他文件。</p>

<div class="note"><strong>Note:</strong>

<ol>
 <li>如果选择了多个文件,这个值表示第一个已选择文件的路径。JavaScript 可以<a href="/zh-CN/docs/Web/API/File/Using_files_from_web_applications#Getting_information_about_selected_files">通过 input 的 files 属性访问其他文件</a></li>
 <li>如果没有选择文件,该值为空字符串 <code>""</code></li>
 <li>为了阻止恶意软件猜测文件路径,字符串<a href="https://html.spec.whatwg.org/multipage/input.html#fakepath-srsly">以 C:\fakepath\ 为前缀</a></li>
</ol>
</div>

<h2 id="附加属性">附加属性</h2>

<p>除了被所有 {{HTMLElement("input")}} 元素共享的公共属性,<code>file</code> 类型的 input 还支持下列属性:</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">属性</th>
   <th scope="col">说明</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code><a href="#attr-accept">accept</a></code></td>
   <td>一个或多个 <a href="#唯一文件类型说明符">唯一文件类型说明符</a> 描述允许的文件类型</td>
  </tr>
  <tr>
   <td><code><a href="#attr-capture">capture</a></code></td>
   <td>捕获图像或视频数据的源</td>
  </tr>
  <tr>
   <td><code><a href="#attr-files">files</a></code></td>
   <td>{{domxref("FileList")}} 列出了已选择的文件</td>
  </tr>
  <tr>
   <td><code><a href="#attr-multiple">multiple</a></code></td>
   <td>布尔值,如果出现,则表示用户可以选择多个文件</td>
  </tr>
 </tbody>
</table>

<h3 id="htmlattrdefaccept">{{htmlattrdef("accept")}}</h3>

<p><code><a href="/zh-CN/docs/Web/HTML/Attributes/accept">accept</a></code> 属性是一个字符串,它定义了文件 input 应该接受的文件类型。这个字符串是一个以逗号为分隔的<strong><a href="#唯一文件类型说明符">唯一文件类型说明符</a></strong>列表。由于给定的文件类型可以用多种方式指定,因此当你需要给定格式的文件时,提供一组完整的类型指定符是非常有用的。</p>

<p>例如,有许多方法可以识别 Microsoft Word 文件,所以接受 Word 文件的站点可以使用一个<code>&lt;input&gt;</code></p>

<pre class="brush: html">&lt;input type="file" id="docpicker"
  accept=".doc,.docx,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document"&gt;</pre>

<h3 id="htmlattrdefcapture">{{htmlattrdef("capture")}}</h3>

<p><a href="/zh-CN/docs/Web/HTML/Attributes/capture"><code>capture</code></a> 属性是一个字符串,如果 <code><a href="/zh-CN/docs/Web/HTML/Attributes/accept">accept</a></code> 属性指出了 input 是图片或者视频类型,则它指定了使用哪个摄像头去这些数据。值 <code>user</code> 表示应该使用前置摄像头和/或麦克风。值 <code>environment</code> 表示应该使用后置摄像头和/或麦克风。如果缺少此属性,则 {{Glossary("user agent")}} 可以自由决定做什么。如果请求的前置模式不可用,则用户代理可能退回到其首选的默认模式。</p>

<div class="note"><strong>Note:</strong> <code>capture</code> 以前是一个布尔类型的属性,如果存在,则请求使用设备的媒体捕获设备(如:摄像机),而不是请求一个文件输入。</div>

<h3 id="htmlattrdeffiles">{{htmlattrdef("files")}}</h3>

<p>{{domxref("FileList")}} 对象每个已选择的文件。如果 {{htmlattrxref("multiple", "input/file")}} 属性没有指定,则这个列表只有一个成员。</p>

<h3 id="htmlattrdefmultiple">{{htmlattrdef("multiple")}}</h3>

<p>当指定布尔类型属性 <a href="/zh-CN/docs/Web/HTML/Attributes/multiple"><code>multiple</code></a>, 文件 input 允许用户选择多个文件。</p>

<h2 id="非标准属性">非标准属性</h2>

<p>除了上面列出来的属性,下面的非标准属性在某些浏览器中可用。你应该尽量避免使用它们,因为这样做将限制代码在没有实现它们的浏览器中的运行能力。</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">属性</th>
   <th scope="col">描述</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code><a href="#attr-webkitdirectory">webkitdirectory</a></code></td>
   <td>一个布尔值,表示是否仅允许用户选择一个目录(或多个目录,如果 <code><a href="#attr-multiple">multiple</a></code> 也出现的话)</td>
  </tr>
 </tbody>
</table>

<h3 id="htmlattrdefwebkitdirectory_non-standard_inline">{{htmlattrdef("webkitdirectory")}} {{non-standard_inline}}</h3>

<div id="webkitdirectory-include">
<p>如果出现布尔属性 <code>webkitdirectory,</code>表示在文件选择器界面中用户只能选择目录。更多细节和示例见  {{domxref("HTMLInputElement.webkitdirectory")}}。</p>

<div class="note">
<p><strong>Note:</strong> 尽管 <code>webkitdirectory</code> 最初仅为基于 webkit 的浏览器实现,它还在 Microsoft Edge 和 Firefox 50 及其后版本中可用。然而,尽管它有相对广泛的支持,它仍然是非标准的。除非你别无选择,否则不要使用它。</p>
</div>
</div>

<h2 id="唯一文件类型说明符">唯一文件类型说明符</h2>

<p><strong>唯一文件类型说明符</strong>是一个字符串,表示在 <code>file</code> 类型的 {{HTMLElement("input")}} 元素中用户可以选择的文件类型。每个唯一文件类型说明符可以采用下列形式之一:</p>

<ul>
 <li>一个以英文句号(".")开头的合法的不区分大小写的文件名扩展名。例如: <code>.jpg</code><code>.pdf</code> 或 <code>.doc</code></li>
 <li>一个不带扩展名的 MIME 类型字符串。</li>
 <li>字符串 <code>audio/*</code>, 表示 “任何音频文件”。</li>
 <li>字符串 <code>video/*</code>,表示 “任何视频文件”。</li>
 <li>字符串 <code>image/*</code>,表示 “任何图片文件”。</li>
</ul>

<p><code>accept</code> 属性的值是一个包含一个或多个(用逗号分隔)这种唯一文件类型说明符的字符串。 例如,一个文件选择器需要能被表示成一张图片的内容,包括标准的图片格式和 PDF 文件,大概是这样的:</p>

<pre class="brush: html">&lt;input type="file" accept="image/*,.pdf"&gt;</pre>

<h2 id="使用文件输入">使用文件输入</h2>

<h3 id="基本示例">基本示例</h3>

<pre class="brush: html">&lt;form method="post" enctype="multipart/form-data"&gt;
 &lt;div&gt;
   &lt;label for="file"&gt;Choose file to upload&lt;/label&gt;
   &lt;input type="file" id="file" name="file" multiple&gt;
 &lt;/div&gt;
 &lt;div&gt;
   &lt;button&gt;Submit&lt;/button&gt;
 &lt;/div&gt;
&lt;/form&gt;</pre>

<div class="hidden">
<pre class="brush: css">div {
  margin-bottom: 10px;
}</pre>
</div>

<p>产生如下结果:</p>

<p>{{EmbedLiveSample('基本示例', 650, 60)}}</p>

<div class="note">
<p><strong>Note</strong>: 你也可以在 GitHub 中找到这个示例 — <a href="https://github.com/mdn/learning-area/blob/master/html/forms/file-examples/simple-file.html">源代码</a><a href="https://mdn.github.io/learning-area/html/forms/file-examples/simple-file.html">在线运行</a></p>
</div>

<p>无论用户的设备或操作系统是什么,文件输入都提供一个按钮,打开一个允许用户选择文件的文件选择对话框。</p>

<p>包含上述的 {{htmlattrxref("multiple", "input/file")}} 属性,指定可以一次选择多个文件。 用户可以用他们选择的平台允许的任何方式从文件选择器中选择多个文件(如,按住 <kbd>Shift</kbd> or <kbd>Control</kbd>,然后单击)。如果您只想让用户为每个 <code>&lt;input&gt;</code> 选择一个文件,那么省略 <code>multiple</code> 属性。</p>

<h3 id="获取已选择文件的信息">获取已选择文件的信息</h3>

<p>被选择的文件以 <code>HTMLInputElement.files</code> 属性返回,它是一个包含一列 {{domxref("File")}} 对象的 {{domxref("FileList")}} 对象。<code>FileList</code> 的行为像一个数组,所以你可以检查 <code>length</code> 属性来获得已选择文件的数量。</p>

<p>每个 <code>File</code> 包含下列信息:</p>

<dl>
 <dt><code>name</code></dt>
 <dd>文件名。</dd>
 <dt><code>lastModified</code></dt>
 <dd>一个数字,指定文件最后一次修改的日期和时间,以 UNIX 新纪元(1970 年 1 月 1 日午夜)以来的毫秒数表示。</dd>
 <dt><code>lastModifiedDate</code> {{deprecated_inline}}</dt>
 <dd>一个 {{jsxref("Date")}} 对象,表示文件最后一次修改的日期和时间。<em>这被弃用,并且不应使用。使用 <code>lastModified</code> 作为替代</em></dd>
 <dt><code>size</code></dt>
 <dd>以字节数为单位的文件大小。</dd>
 <dt><code>type</code></dt>
 <dd>文件的 <a href="/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types">MIME 类型</a></dd>
 <dt><code>webkitRelativePath</code> {{non-standard_inline}}</dt>
 <dd>一个字符串,指定了相对于在目录选择器中选择的基本目录的文件路径(即,一个设置了 {{htmlattrxref("webkitdirectory", "input/file")}} 属性的 <code>file</code> 选择器)。 <em>这是非标准的,应该谨慎使用。</em></dd>
</dl>

<div class="note">
<p><strong>Note</strong>: 你可以在所有现代浏览器中读写 <code>HTMLInputElement.files</code> 的值;最近这被添加到 Firefox 57 中(见 {{bug(1384030)}})。</p>
</div>

<h3 id="限制可接受的文件类型">限制可接受的文件类型</h3>

<p>通常,你不希望用户能够选择任意类型的文件;相反,你通常希望它们选择特定类型的文件。例如,如果你的文件输入让用户上传个人资料图片,您可能希望他们选择 Web 兼容的图像格式,如 {{Glossary("JPEG")}} 或 {{Glossary("PNG")}}。</p>

<p>可以用 {{htmlattrxref("accept","input/file")}} 属性指定可接受的文件类型,它是一个以逗号间隔的文件扩展名和 MIME 类型列表。一些例子:</p>

<ul>
 <li><code>accept="image/png"</code> 或 <code>accept=".png"</code> — 接受 PNG 文件。</li>
 <li><code>accept="image/png, image/jpeg"</code> 或 <code>accept=".png, .jpg, .jpeg"</code> — 接受 PNG 或 JPEG 文件。</li>
 <li><code>accept="image/*"</code> — 接受带有一个 <code>image/*</code> MIME 类型的任何文件。(许多移动设备也允许用户在使用它时用摄像头拍照。)</li>
 <li><code>accept=".doc,.docx,.xml,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document"</code> — 接受 MS Word 文档之类的任何文件。</li>
</ul>

<p>让我们来看一个更完整的例子:</p>

<pre class="brush: html">&lt;form method="post" enctype="multipart/form-data"&gt;
  &lt;div&gt;
    &lt;label for="profile_pic"&gt;Choose file to upload&lt;/label&gt;
    &lt;input type="file" id="profile_pic" name="profile_pic"
          accept=".jpg, .jpeg, .png"&gt;
  &lt;/div&gt;
  &lt;div&gt;
    &lt;button&gt;Submit&lt;/button&gt;
  &lt;/div&gt;
&lt;/form&gt;</pre>

<div class="hidden">
<pre class="brush: css">div {
  margin-bottom: 10px;
}</pre>
</div>

<p>上述代码产生和之前示例相似的结果:</p>

<p>{{EmbedLiveSample('限制可接受的文件类型', 650, 60)}}</p>

<div class="note">
<p><strong>Note</strong>: 你也可以在 GitHub 中找到这个示例 — <a href="https://github.com/mdn/learning-area/blob/master/html/forms/file-examples/file-with-accept.html">源代码</a><a href="https://mdn.github.io/learning-area/html/forms/file-examples/file-with-accept.html">在线运行</a></p>
</div>

<p>这可能看起来很相似,但是如果你尝试用该输入选择一个文件,你将看到文件选择器只允许你选择 <code>accept</code> 值指定的文件类型(实际特性会按不同的浏览器和操作系统有所不同)。</p>

<p><img alt="Screenshot of a macOS file picker dialog. Files other than JPEG are grayed-out and unselectable." src="https://mdn.mozillademos.org/files/15183/file-chooser.png" style="margin: 0 auto;"></p>

<p><code>accept</code> 属性不验证所选文件的类型;它只是为浏览器提供提示来引导用户选择正确的文件类型。用户仍然可以(在大多数情况下)在文件选择器中切换一个选项,使其能够覆盖此选项并选择他们希望的任何文件,然后选择不正确的文件类型。</p>

<p>因此,您应该确保 <code>accept</code> 属性得到适当的服务器端验证的支持。</p>

<h3 id="注意事项">注意事项</h3>

<ol>
 <li>
  <p>你不能从脚本中设置文件选取器的值 — You cannot set the value of a file picker from a script — 做下面这样的事情是没有效果的:</p>

  <pre class="brush: js">const input = document.querySelector("input[type=file]");
input.value = "foo";
</pre>
 </li>
 <li>
  <p>当使用一个 <code>&lt;input type="file"&gt;</code> 选择一个文件,When a file is chosen using an <code>&lt;input type="file"&gt;</code>,出于明显的安全原因,源文件的实际路径没有显示在 input 的 <code>value</code> 属性中。相反,显示了文件名,并用 <code>C:\fakepath\</code> 附加在路径的开头。这种怪癖有一些历史原因,但它在所有现代浏览器中都受到支持,而且实际上<a href="https://html.spec.whatwg.org/multipage/forms.html#fakepath-srsly">在规范中也有定义</a></p>
 </li>
</ol>

<h2 id="示例">示例</h2>

<p>在本例中,我们将展示一个稍微高级一点的文件选择器,它利用了在 <code>HTMLInputElement.files</code> 属性中可用的文件信息,并且展示了一些聪明的技巧。</p>

<div class="note">
<p><strong>Note</strong>: 你可以在 GitHub 中查看本示例的完整源代码 — <a href="https://github.com/mdn/learning-area/blob/master/html/forms/file-examples/file-example.html">file-example.html</a> (<a href="https://mdn.github.io/learning-area/html/forms/file-examples/file-example.html">在线运行</a>)。我们不会解释 CSS;JavaScript 是主要的关注点。</p>
</div>

<p>首先,让我们看看 HTML:</p>

<pre class="brush: html">&lt;form method="post" enctype="multipart/form-data"&gt;
  &lt;div&gt;
    &lt;label for="image_uploads"&gt;Choose images to upload (PNG, JPG)&lt;/label&gt;
    &lt;input type="file" id="image_uploads" name="image_uploads" accept=".jpg, .jpeg, .png" multiple&gt;
  &lt;/div&gt;
  &lt;div class="preview"&gt;
    &lt;p&gt;No files currently selected for upload&lt;/p&gt;
  &lt;/div&gt;
  &lt;div&gt;
    &lt;button&gt;Submit&lt;/button&gt;
  &lt;/div&gt;
&lt;/form&gt;</pre>

<div class="hidden">
<pre class="brush: css">html {
  font-family: sans-serif;
}

form {
  width: 580px;
  background: #ccc;
  margin: 0 auto;
  padding: 20px;
  border: 1px solid black;
}

form ol {
  padding-left: 0;
}

form li, div &gt; p {
  background: #eee;
  display: flex;
  justify-content: space-between;
  margin-bottom: 10px;
  list-style-type: none;
  border: 1px solid black;
}

form img {
  height: 64px;
  order: 1;
}

form p {
  line-height: 32px;
  padding-left: 10px;
}

form label, form button {
  background-color: #7F9CCB;
  padding: 5px 10px;
  border-radius: 5px;
  border: 1px ridge black;
  font-size: 0.8rem;
  height: auto;
}

form label:hover, form button:hover {
  background-color: #2D5BA3;
  color: white;
}

form label:active, form button:active {
  background-color: #0D3F8F;
  color: white;
}</pre>
</div>

<p>这和我们之前看到的类似 — 没有什么要说明的。</p>

<p>接下来,让我们看一下 JavaScript。</p>

<p>在脚本的第一行,我们获得了对表单 input 本身和拥有 <code>.preview</code> 类的 {{htmlelement("div")}} 元素的引用。然后,我们隐藏了 {{htmlelement("input")}} 元素 — 我们这样做是因为文件输入往往很难看,难于设计样式,而且在跨浏览器中对它们的设计不一致。你可以通过单击 <code>input</code> 元素来激活它,因此,最好在视觉上隐藏 input 并将 label 设计成按钮的样式,这样用户如果想上传文件就会知道如何与之交互。</p>

<pre class="brush: js">const input = document.querySelector('input');
const preview = document.querySelector('.preview');

input.style.opacity = 0;</pre>

<div class="note">
<p><strong>Note:</strong> 使用{{cssxref("opacity")}} 来隐藏文件输入,而不是使用 {{cssxref("visibility", "visibility: hidden")}} 或者 {{cssxref("display", "display: none")}},因为辅助技术将后两种样式解释为文件 input 是不可交互的。</p>
</div>

<p>接下来,我们将<a href="/zh-CN/docs/Web/API/EventTarget/addEventListener">事件监听器</a>添加到 input 中,以监听选择的值的更改(在本例中,当选择文件时)。事件监听器调用我们定制的 <code>updateImageDisplay()</code> 函数。</p>

<pre class="brush: js">input.addEventListener('change', updateImageDisplay);</pre>

<p>每当 <code>updateImageDisplay()</code> 函数被调用时,我们:</p>

<ul>
 <li>使用一个 {{jsxref("Statements/while", "while")}} 循环来清空 preview <code>&lt;div&gt;</code> 留下的内容。</li>
 <li>获取包含所有已选择文件信息的 {{domxref("FileList")}} 对象,并将其用一个变量 <code>curFiles</code> 保存。</li>
 <li>通过检查 <code>curFiles.length</code> 是否等于 0 来检查是否没有文件被选择。如果是,则用 preview <code>&lt;div&gt;</code> 输出一条消息,来表示没有选择文件。</li>
 <li>如果<em>选择</em>了文件,我们将循环遍历每个文件,并将关于它的信息输出到 preview <code>&lt;div&gt;</code>。注意事项:</li>
 <li>我们使用定制的 <code>validFileType()</code> 函数来检查文件的类型是否正确。(例如,用 <code>accept</code> 属性指定的图片类型)。</li>
 <li>如果是,我们:
  <ul>
   <li>将其名称和文件大小输出到到 <span style="font-size: 1rem; letter-spacing: -0.00278rem;">previous </span><code style="font-size: 1rem; letter-spacing: -0.00278rem;">&lt;div&gt;</code> 的一个列表项中(<span style="font-size: 1rem; letter-spacing: -0.00278rem;">从 </span><code style="font-size: 1rem; letter-spacing: -0.00278rem;">file.name</code><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> 和 </span><code style="font-size: 1rem; letter-spacing: -0.00278rem;">file.size</code>获取)。定制的 <code style="font-size: 1rem; letter-spacing: -0.00278rem;">returnFileSize()</code><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> 函数返回一个用 bytes/KB/MB 表示的</span>格式良好的大小(默认情况下,浏览器以绝对字节数报告大小)。</li>
   <li>通过调用 {{domxref("URL.createObjectURL", "URL.createObjectURL(curFiles[i])")}} 来生成图片的一张缩略预览图。然后,通过创建一个新的 {{htmlelement("img")}} 来将这张图片也插入到列表项,并且将它的 {{htmlattrxref("src", "img")}} 设置为缩略图。</li>
  </ul>
 </li>
 <li>如果文件类型无效,则在列表项中显示一条消息,告诉用户需要选择一个其它的文件类型。</li>
</ul>

<pre class="brush: js">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);
    }
  }
}</pre>

<p>定制的 <code>validFileType()</code> 函数接受一个 {{domxref("File")}} 对象作为参数,然后使用 {{jsxref("Array.prototype.includes()")}} 检查 <code>fileTypes</code> 中是否有值和文件的 <code>type</code> 属性匹配。如果找到匹配项,函数返回 <code>true</code>。如果没找到,返回 <code>false</code></p>

<pre class="brush: js">const fileTypes = [
  'image/jpeg',
  'image/pjpeg',
  'image/png'
];

function validFileType(file) {
  return fileTypes.includes(file.type);
}</pre>

<p><code>returnFileSize()</code> 函数接受一个数字(字节数,取自当前文件的 <code>size</code> 属性)作为参数,并且将其转化为用 bytes/KB/MB 表示的格式良好的大小。</p>

<pre class="brush: js">function returnFileSize(number) {
  if(number &lt; 1024) {
    return number + 'bytes';
  } else if(number &gt;= 1024 &amp;&amp; number &lt; 1048576) {
    return (number/1024).toFixed(1) + 'KB';
  } else if(number &gt;= 1048576) {
    return (number/1048576).toFixed(1) + 'MB';
  }
}</pre>

<p>这个例子是这样的;演示一下:</p>

<p>{{EmbedLiveSample('示例', '100%', 200)}}</p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'input.html#file-upload-state-(type=file)', '&lt;input type="file"&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Initial definition</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5.1', 'sec-forms.html#file-upload-state-typefile', '&lt;input type="file"&gt;')}}</td>
   <td>{{Spec2('HTML5.1')}}</td>
   <td>Initial definition</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML Media Capture', '#the-capture-attribute','capture attribute')}}</td>
   <td>{{Spec2('HTML Media Capture')}}</td>
   <td>initial <code>capture</code> attribute</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("html.elements.input.input-file")}}</p>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li><a href="/zh-CN/docs/Web/API/File/Using_files_from_web_applications">在 web 应用中使用文件</a> — 包含许多其它关于 <code>&lt;input type="file"&gt;</code> 和 <a href="/zh-CN/docs/Web/API/File">File API</a> 的有用示例。</li>
 <li><a href="zh-CN/docs/Learn/HTML/Forms/Property_compatibility_table_for_form_widgets">CCSS 属性兼容性</a></li>
</ul>