Skip to content

Commit 32f4b80

Browse files
[zh-cn]: sync translation for FileReader.{abort(), abort, load} (#20359)
1 parent 5ce00e1 commit 32f4b80

File tree

3 files changed

+76
-65
lines changed

3 files changed

+76
-65
lines changed

files/zh-cn/web/api/filereader/abort/index.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,27 @@
11
---
2-
title: FileReader.abort()
2+
title: FileReaderabort() 方法
33
slug: Web/API/FileReader/abort
4+
l10n:
5+
sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
46
---
57

6-
{{APIRef("File API")}}
8+
{{APIRef("File API")}}{{AvailableInWorkers}}
79

8-
该方法可以取消 FileReader 的读取操作,触发之后 {{domxref("FileReader.readyState","readyState")}} 为已完成(DONE
10+
{{domxref("FileReader")}} 接口的 **`abort()`** 方法中止读取操作。返回后,{{domxref("FileReader.readyState","readyState")}} 将为 `DONE`
911

1012
## 语法
1113

12-
```plain
13-
instanceOfFileReader.abort();
14+
```js-nolint
15+
abort()
1416
```
1517

16-
### 例外情况
18+
### 参数
1719

18-
- `DOM_FILE_ABORT_ERR`
19-
- : 对一个没有正在进行读取操作({{domxref("FileReader.readyState","readyState")}} 不是 `LOADING`)的 `FileReader` 进行 `abort` 操作,会抛出 `DOM_FILE_ABORT_ERR` 错误。
20+
无。
21+
22+
### 返回值
23+
24+
无({{jsxref("undefined")}})。
2025

2126
## 规范
2227

files/zh-cn/web/api/filereader/abort_event/index.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22
title: FileReader:abort 事件
33
slug: Web/API/FileReader/abort_event
44
l10n:
5-
sourceCommit: 497d322c61511b11e4877a77660f8d7b394a8277
5+
sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
66
---
77

88
{{APIRef("File API")}}{{AvailableInWorkers}}
99

10-
**`abort`** 事件会在读取操作被中止时触发:例如,当程序调用了 {{domxref("FileReader.abort()")}} 方法。
10+
{{domxref("FileReader")}} 接口的 **`abort`** 事件在读取被中止时触发:例如因为程序调用了 {{domxref("FileReader.abort()")}} 方法。
1111

1212
此事件不可取消且不会冒泡。
1313

1414
## 语法
1515

16-
在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 这样的方法中使用事件名称,或设置事件处理器属性。
16+
{{domxref("EventTarget.addEventListener", "addEventListener()")}} 等方法中使用事件名称,或设置事件处理器属性。
1717

1818
```js
1919
addEventListener("abort", (event) => {});
@@ -23,31 +23,31 @@ onabort = (event) => {};
2323

2424
## 事件类型
2525

26-
{{domxref("ProgressEvent")}}。继承于 {{domxref("Event")}}。
26+
{{domxref("ProgressEvent")}}。继承自 {{domxref("Event")}}。
2727

2828
{{InheritanceDiagram("ProgressEvent")}}
2929

3030
## 事件属性
3131

32-
_该属性也继承了其父类 {{domxref("Event")}} 的属性_
32+
_还继承其父级 {{domxref("Event")}} 的属性。_
3333

3434
- {{domxref("ProgressEvent.lengthComputable")}} {{ReadOnlyInline}}
35-
- : 一个布尔标志,表示底层进程要完成的总工作量及已完成的工作量是否可计算。换句话说,它表明进度是否可以衡量
35+
- : 一个布尔标志,指示底层进程要完成的总工作量以及已完成的工作量是否可计算。换句话说,它表明进展是否可衡量
3636
- {{domxref("ProgressEvent.loaded")}} {{ReadOnlyInline}}
37-
- : 一个 64 位无符号整数值,表示底层进程已完成的工作量。完成工作的比例可以通过除以 `total` 属性的值来计算。当使用 HTTP 下载资源时,这仅计算 HTTP 消息的主体的大小,并且不包括标头以及其他开销
37+
- : 一个 64 位无符号整数值,指示底层进程已执行的工作量。完成工作的比率可以通过将 `total` 除以该属性的值来计算。使用 HTTP 下载资源时,仅计算 HTTP 消息的正文,不包括标头和其他开销
3838
- {{domxref("ProgressEvent.total")}} {{ReadOnlyInline}}
39-
- : 一个 64 位无符号整数,表示底层进程正在执行的总工作量。当使用 HTTP 下载资源时,这是 `Content-Length`消息体的大小),并且不包括标头以及其他开销
39+
- : 一个 64 位无符号整数,表示底层进程正在执行的工作总量。使用 HTTP 下载资源时,这是 `Content-Length`消息正文的大小),不包括标头和其他开销
4040

4141
## 示例
4242

43-
### 在线示例
43+
### 实时示例
4444

4545
#### HTML
4646

4747
```html
4848
<div class="example">
4949
<div class="file-select">
50-
<label for="avatar">选择你的头像:</label>
50+
<label for="avatar">选择个人资料图片:</label>
5151
<input
5252
type="file"
5353
id="avatar"
@@ -58,7 +58,7 @@ _该属性也继承了其父类 {{domxref("Event")}} 的属性_。
5858
<img src="" class="preview" height="200" alt="图片预览" />
5959

6060
<div class="event-log">
61-
<label for="eventLog">事件输出:</label>
61+
<label for="eventLog">事件日志:</label>
6262
<textarea readonly class="event-log-contents" id="eventLog"></textarea>
6363
</div>
6464
</div>
@@ -111,7 +111,7 @@ const eventLog = document.querySelector(".event-log-contents");
111111
const reader = new FileReader();
112112

113113
function handleEvent(event) {
114-
eventLog.textContent += `${event.type}:传输了 ${event.loaded} 个字节\n`;
114+
eventLog.textContent += `${event.type}:传输了 ${event.loaded} 字节\n`;
115115

116116
if (event.type === "load") {
117117
preview.src = reader.result;
@@ -142,7 +142,7 @@ fileInput.addEventListener("change", handleSelected);
142142

143143
#### 结果
144144

145-
{{ EmbedLiveSample('在线示例', '100%', '300px') }}
145+
{{ EmbedLiveSample('实时示例', '100%', '300px') }}
146146

147147
## 规范
148148

@@ -154,4 +154,4 @@ fileInput.addEventListener("change", handleSelected);
154154

155155
## 参见
156156

157-
- 相关事件:{{domxref("FileReader.loadstart_event", "loadstart")}}、{{domxref("FileReader.loadend_event", "loadend")}}、{{domxref("FileReader.progress_event", "progress")}}、{{domxref("FileReader.error_event", "error")}}、{{domxref("FileReader.load_event", "load")}}
157+
- 相关事件:{{domxref("FileReader.loadstart_event", "loadstart")}}、{{domxref("FileReader.loadend_event", "loadend")}}、{{domxref("FileReader.progress_event", "progress")}}、{{domxref("FileReader.error_event", "error")}}、{{domxref("FileReader.load_event", "load")}}

files/zh-cn/web/api/filereader/load_event/index.md

Lines changed: 49 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,65 @@
11
---
2-
title: "FileReader: load event"
2+
title: FileReaderload 事件
33
slug: Web/API/FileReader/load_event
4+
l10n:
5+
sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
46
---
57

6-
{{APIRef}}
7-
8-
当文件成功读取时,执行`load` 事件
9-
10-
<table class="properties">
11-
<tbody>
12-
<tr>
13-
<th scope="row">是否冒泡</th>
14-
<td>No</td>
15-
</tr>
16-
<tr>
17-
<th scope="row">是否能中断退出</th>
18-
<td>No</td>
19-
</tr>
20-
<tr>
21-
<th scope="row">调用接口</th>
22-
<td>{{domxref("ProgressEvent")}}</td>
23-
</tr>
24-
<tr>
25-
<th scope="row">事件处理属性</th>
26-
<td>{{domxref("FileReader.onload")}}</td>
27-
</tr>
28-
</tbody>
29-
</table>
30-
31-
## 例子
32-
33-
### Live example
8+
{{APIRef("File API")}}{{AvailableInWorkers}}
9+
10+
{{domxref("FileReader")}} 接口的 **`load`** 事件在成功读取文件时触发。
11+
12+
此事件不可取消且不会冒泡。
13+
14+
## 语法
15+
16+
在 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 等方法中使用事件名称,或设置事件处理器属性。
17+
18+
```js
19+
addEventListener("load", (event) => {});
20+
21+
onload = (event) => {};
22+
```
23+
24+
## 事件类型
25+
26+
{{domxref("ProgressEvent")}}。继承自 {{domxref("Event")}}。
27+
28+
{{InheritanceDiagram("ProgressEvent")}}
29+
30+
## 事件属性
31+
32+
_还继承其父级 {{domxref("Event")}} 的属性。_
33+
34+
- {{domxref("ProgressEvent.lengthComputable")}} {{ReadOnlyInline}}
35+
- : 一个布尔标志,指示底层进程要完成的总工作量以及已完成的工作量是否可计算。换句话说,它表明进展是否可衡量。
36+
- {{domxref("ProgressEvent.loaded")}} {{ReadOnlyInline}}
37+
- : 一个 64 位无符号整数值,指示底层进程已执行的工作量。完成工作的比率可以通过将 `total` 除以该属性的值来计算。使用 HTTP 下载资源时,仅计算 HTTP 消息的正文,不包括标头和其他开销。
38+
- {{domxref("ProgressEvent.total")}} {{ReadOnlyInline}}
39+
- : 一个 64 位无符号整数,表示底层进程正在执行的工作总量。使用 HTTP 下载资源时,这是 `Content-Length`(消息正文的大小),不包括标头和其他开销。
40+
41+
## 示例
42+
43+
### 实时示例
3444

3545
#### HTML
3646

3747
```html
3848
<div class="example">
3949
<div class="file-select">
40-
<label for="avatar">Choose a profile picture:</label>
50+
<label for="avatar">选择个人资料图片:</label>
4151
<input
4252
type="file"
4353
id="avatar"
4454
name="avatar"
4555
accept="image/png, image/jpeg" />
4656
</div>
4757

48-
<img src="" class="preview" height="200" alt="Image preview..." />
58+
<img src="" class="preview" height="200" alt="图片预览" />
4959

5060
<div class="event-log">
51-
<label>Event log:</label>
52-
<textarea readonly class="event-log-contents"></textarea>
61+
<label for="eventLog">事件日志:</label>
62+
<textarea readonly class="event-log-contents" id="eventLog"></textarea>
5363
</div>
5464
</div>
5565
```
@@ -65,6 +75,7 @@ img.preview {
6575
border: 1px solid black;
6676
margin: 0.2rem;
6777
padding: 0.2rem;
78+
resize: none;
6879
}
6980

7081
.example {
@@ -89,13 +100,9 @@ img.preview {
89100
.event-log > label {
90101
display: block;
91102
}
92-
93-
.event-log-contents {
94-
resize: none;
95-
}
96103
```
97104

98-
#### JS
105+
#### JavaScript
99106

100107
```js
101108
const fileInput = document.querySelector('input[type="file"]');
@@ -104,8 +111,7 @@ const eventLog = document.querySelector(".event-log-contents");
104111
const reader = new FileReader();
105112

106113
function handleEvent(event) {
107-
eventLog.textContent =
108-
eventLog.textContent + `${event.type}: ${event.loaded} bytes transferred\n`;
114+
eventLog.textContent += `${event.type}:传输了 ${event.loaded} 字节\n`;
109115

110116
if (event.type === "load") {
111117
preview.src = reader.result;
@@ -135,7 +141,7 @@ fileInput.addEventListener("change", handleSelected);
135141

136142
#### 结果
137143

138-
{{ EmbedLiveSample('Live_example', '100%', '300px') }}
144+
{{ EmbedLiveSample('实时示例', '100%', '300px') }}
139145

140146
## 规范
141147

@@ -145,6 +151,6 @@ fileInput.addEventListener("change", handleSelected);
145151

146152
{{Compat}}
147153

148-
## 请参阅
154+
## 参见
149155

150-
- Related events: {{domxref("FileReader.loadstart_event")}}, {{domxref("FileReader.loadend_event")}}, {{domxref("FileReader.progress_event")}}, {{domxref("FileReader.error_event")}}, {{domxref("FileReader.abort_event")}}
156+
- 相关事件:{{domxref("FileReader.loadstart_event", "loadstart")}}{{domxref("FileReader.loadend_event", "loadend")}}{{domxref("FileReader.progress_event", "progress")}}{{domxref("FileReader.error_event", "error")}}{{domxref("FileReader.abort_event", "abort")}}

0 commit comments

Comments
 (0)