Skip to content

Commit 442ff5c

Browse files
authored
Update translation of 2-ui/1-document/08-styles-and-classes (javascript-tutorial#673)
Update translation of 2-ui/1-document/08-styles-and-classes (javascript-tutorial#673)
1 parent 460329a commit 442ff5c

2 files changed

Lines changed: 87 additions & 86 deletions

File tree

2-ui/1-document/08-styles-and-classes/2-create-notification/task.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@ importance: 5
22

33
---
44

5-
# 创建通知
5+
# 创建一个通知
66

7-
编写 `showNotification(options)` 通知函数:`<div class="notification">` 包含给定内容。通知应该在 1.5 秒后自动消失。
7+
编写一个函数 `showNotification(options)`:该函数创建一个带有给定内容的通知 `<div class="notification">`。该通知应该在 1.5 秒后自动消失。
88

99
参数:
1010

@@ -21,4 +21,4 @@ showNotification({
2121
[demo src="solution"]
2222

2323

24-
使用 CSS 定位在给定 top/right 坐标处显示元素。源文档已经提供了必要的样式。
24+
使用 CSS 定位在给定的 top/right 坐标处显示元素。源文档已经提供了必要的样式。
Lines changed: 84 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,35 @@
11
# 样式和类
22

3-
在我们讨论 JavaScript 处理样式和类的方法之前 — 有一个重要的规则。尽管这足够明显的,但我们还是要提到这一点
3+
在我们讨论 JavaScript 处理样式和类的方法之前 — 有一个重要的规则。希望它足够明显,但是我们仍然必须提到它
44

5-
通常有两种方式来设计元素样式
5+
通常有两种设置元素样式的方式
66

7-
1. 在 CSS 中创建一个类并添加它`<div class="...">`
7+
1. 在 CSS 中创建一个类,并添加它`<div class="...">`
88
2. 将属性直接写入 `style``<div style="...">`
99

10-
CSS 总是首选的方式 —— 不仅用于 HTML,在 JavaScript 中也是如此
10+
JavaScript 既可以修改类,也可以修改 `style` 属性
1111

12-
只有当类“无法处理时”,我们才会操作 `style` 属性
12+
相较于将样式写入 `style` 属性,我们应该首选通过 CSS 类的方式来添加样式。仅当类“无法处理”时,才应选择使用 `style` 属性的方式
1313

14-
例如,如果我们动态地计算元素的坐标并希望通过 JavaScript 来设置它们,那么 `style` 是可接受的,如下所示:
14+
例如,如果我们动态地计算元素的坐标,并希望通过 JavaScript 来设置它们,那么使用 `style` 是可以接受的,如下所示:
1515

1616
```js
17-
let top = /* complex calculations */;
18-
let left = /* complex calculations */;
19-
elem.style.left = left; // e.g '123px'
20-
elem.style.top = top; // e.g '456px'
17+
let top = /* 复杂的计算 */;
18+
let left = /* 复杂的计算 */;
19+
20+
elem.style.left = left; // 例如 '123px',在运行时计算出的
21+
elem.style.top = top; // 例如 '456px'
2122
```
2223

23-
对于其他情况,比如文本变红色,添加一个背景图标 —— 在 CSS 中描述这个图标,然后应用这个类。这更加灵活,更容易支持
24+
对于其他情况,例如将文本设为红色,添加一个背景图标 — 可以在 CSS 中对这些样式进行描述,然后添加类(JavaScript 可以做到)。这样更灵活,更易于支持
2425

25-
## className and classList
26+
## className classList
2627

27-
更改类在脚本中是最常见的一个操作
28+
更改类是脚本中最常见的操作之一
2829

29-
在以前,JavaScript 有一个限制:像 `"class"` 这样的保留字不能作为对象属性。这一限制现在已经不存在了,但当时并不存在像 `elem.class` 这样的 `"class"` 属性。
30+
在很旧以前,JavaScript 中有一个限制:像 `"class"` 这样的保留字不能用作对象的属性。这一限制现在已经不存在了,但当时就不能存在像 `elem.class` 这样的 `"class"` 属性。
3031

31-
因此对于类,引入了类似的属性 `"className"` `elem.className` 对应于 `"class"` 特性:
32+
因此,对于类,引入了看起来类似的属性 `"className"``elem.className` 对应于 `"class"` 特性(attribute)。
3233

3334
例如:
3435

@@ -40,19 +41,19 @@ elem.style.top = top; // e.g '456px'
4041
</body>
4142
```
4243

43-
如果我们为 `elem.className` 分配一些东西,它将替换所有的类字符串。有时,这正是我们所需要的,但我们通常希望添加/删除单个类。
44+
如果我们对 `elem.className` 进行赋值,它将替换类中的整个字符串。有时,这正是我们所需要的,但通常我们希望添加/删除单个类。
4445

45-
还有另一个属性`elem.classList`
46+
这里还有另一个属性`elem.classList`
4647

47-
`elem.classList` 是一个特殊对象,它拥有 `add/remove/toggle` 的类方法
48+
`elem.classList` 是一个特殊的对象,它具有 `add/remove/toggle` 单个类的方法
4849

4950
例如:
5051

5152
```html run
5253
<body class="main page">
5354
<script>
5455
*!*
55-
// add a class
56+
// 添加一个 class
5657
document.body.classList.add('article');
5758
*/!*
5859
@@ -61,31 +62,31 @@ elem.style.top = top; // e.g '456px'
6162
</body>
6263
```
6364

64-
因此我们既可以使用 `className` 对完整的类字符串进行操作,也可以使用使用 `classList` 对单个类进行操作。我们选择什么取决于我们的需求。
65+
因此,我们既可以使用 `className` 对完整的类字符串进行操作,也可以使用使用 `classList` 对单个类进行操作。我们选择什么取决于我们的需求。
6566

66-
`classList` 方法
67+
`classList` 的方法
6768

68-
- `elem.classList.add/remove("class")` 添加/移除类。
69-
- `elem.classList.toggle("class")`— 如果类存在就移除,否则添加
70-
- `elem.classList.contains("class")`返回 `true/false`,检查给定类
69+
- `elem.classList.add/remove("class")` — 添加/移除类。
70+
- `elem.classList.toggle("class")` 如果类不存在就添加类,存在就移除它
71+
- `elem.classList.contains("class")` 检查给定类,返回 `true/false`
7172

72-
此外,`classList` 是可迭代的,因此我们可以像下述方法一样列出所有类
73+
此外,`classList` 是可迭代的,因此,我们可以像下面这样列出所有类
7374

7475
```html run
7576
<body class="main page">
7677
<script>
7778
for (let name of document.body.classList) {
78-
alert(name); // main, and then page
79+
alert(name); // main,然后是 page
7980
}
8081
</script>
8182
</body>
8283
```
8384

8485
## 元素样式
8586

86-
`elem.style` 属性是一个对象,它对应于 `"style"` 特性中所写的内容。对 `elem.style.width="100px"` 等价于 `style="width:100px"` 的运行效果
87+
`elem.style` 属性是一个对象,它对应于 `"style"` 特性(attribute)中所写的内容。`elem.style.width="100px"` 的效果等价于我们在 `style` 中有一个 `width:100px` 字符串
8788

88-
对于多单词,使用 camelCase:
89+
对于多词(multi-word)属性,使用驼峰式 camelCase:
8990

9091
```js no-beautify
9192
background-color => elem.style.backgroundColor
@@ -99,44 +100,44 @@ border-left-width => elem.style.borderLeftWidth
99100
document.body.style.backgroundColor = prompt('background color?', 'green');
100101
```
101102

102-
````smart header="Prefixed properties"
103-
像 `-moz-border-radius`,`-webkit-border-radius` 这样的浏览器前缀,也遵循同样的规则,比如:
103+
````smart header="前缀属性"
104+
像 `-moz-border-radius` 和 `-webkit-border-radius` 这样的浏览器前缀属性,也遵循同样的规则:连字符 `"-"` 表示大写。
105+
106+
例如:
104107
105108
```js
106109
button.style.MozBorderRadius = '5px';
107110
button.style.WebkitBorderRadius = '5px';
108111
```
109-
110-
即:连字符 `"-"` 变成大写。
111112
````
112113

113114
## 重置样式属性
114115

115-
有时我们想要分配一个样式属性,然后移除它
116+
有时我们想要分配一个样式属性,稍后移除它
116117

117118
例如,为了隐藏一个元素,我们可以设置 `elem.style.display = "none"`
118119

119-
然后,我们可能要移除 `style.display`,就像它没有被设置一样。这里不应该使用 `delete elem.style.display`,而应该使用 `elem.style.display = ""` 将其赋值为空。
120+
然后,稍后我们可能想要移除 `style.display`,就像它没有被设置一样。这里不应该使用 `delete elem.style.display`,而应该使用 `elem.style.display = ""` 将其赋值为空。
120121

121122
```js run
122-
// if we run this code, the <body> "blinks"
123-
document.body.style.display = "none"; // hide
123+
// 如果我们运行这段代码,<body> 将会闪烁
124+
document.body.style.display = "none"; // 隐藏
124125

125126
setTimeout(() => document.body.style.display = "", 1000); // 恢复正常
126127
```
127128

128-
如果我们设置 `display` 为空字符串,那么浏览器一般会应用 CSS 类以及内置样式,就像根本没有这样的 `style` 属性
129+
如果我们将 `display` 设置为空字符串,那么浏览器通常会应用 CSS 类以及内置样式,就好像根本没有这样的 `style` 属性一样
129130

130-
````smart header="用 `style.cssText` 进行重写"
131-
通常,我们使用 `style.*` 来分配单独的样式属性。我们不能将完整的样式设置为 `div.style="color: red; width: 100px"`,因为 `div.style` 是一个对象,而且它是只读的
131+
````smart header="用 `style.cssText` 进行完全的重写"
132+
通常,我们使用 `style.*` 来对各个样式属性进行赋值。我们不能像这样的 `div.style="color: red; width: 100px"` 设置完整的属性,因为 `div.style` 是一个对象,并且它是只读的
132133

133-
以字符串的形式设置样式,可以使用特殊属性 `style.cssText`
134+
想要以字符串的形式设置完整的样式,可以使用特殊属性 `style.cssText`
134135

135136
```html run
136137
<div id="div">Button</div>
137138

138139
<script>
139-
// we can set special style flags like "important" here
140+
// 我们可以在这里设置特殊的样式标记,例如 "important"
140141
div.style.cssText=`color: red !important;
141142
background-color: yellow;
142143
width: 100px;
@@ -147,27 +148,27 @@ setTimeout(() => document.body.style.display = "", 1000); // 恢复正常
147148
</script>
148149
```
149150

150-
我们很少使用它,因为这样的赋值会删除所有现有样式:它不会添加,而是替换它们。偶尔会移出所需的东西。但是当我们知道我们不移出一些重要的内容时,仍然可以对新元素进行处理
151+
我们很少使用这个属性,因为这样的赋值会删除所有现有样式:它不是进行添加,而是替换它们。有时可能会删除所需的内容。但是,当我们知道我们不会删除现有样式时,可以安全地将其用于新元素
151152

152-
通过设置属性`div.setAttribute('style', 'color: red...')` 也可以实现同样的目的
153+
可以通过设置一个特性(attribute)来实现同样的效果`div.setAttribute('style', 'color: red...')`
153154
````
154155
155156
## 注意单位
156157
157-
样式值中必须附上 CSS 单位
158+
不要忘记将 CSS 单位添加到值上
158159
159-
例如,我们不应该将 `elem.style.top` 设置为 `10`,而应将其设置为 `10px`。否则会无效
160+
例如,我们不应该将 `elem.style.top` 设置为 `10`,而应将其设置为 `10px`。否则设置会无效
160161
161162
```html run height=100
162163
<body>
163164
<script>
164165
*!*
165-
// doesn't work!
166+
// 无效!
166167
document.body.style.margin = 20;
167-
alert(document.body.style.margin); // '' (empty string, the assignment is ignored)
168+
alert(document.body.style.margin); // ''(空字符串,赋值被忽略了)
168169
*/!*
169170
170-
// now add the CSS unit (px) - and it works
171+
// 现在添加了 CSS 单位(px)— 生效了
171172
document.body.style.margin = '20px';
172173
alert(document.body.style.margin); // 20px
173174
@@ -177,19 +178,19 @@ setTimeout(() => document.body.style.display = "", 1000); // 恢复正常
177178
</body>
178179
```
179180
180-
请注意浏览器如何“解压”最后一行中的 `style.margin` 属性,并从其中推断 `style.marginLeft` 和 `style.marginTop`(以及其他部分边距)
181+
请注意:浏览器在最后几行代码中对属性 `style.margin` 进行了“解包”,并从中推断出 `style.marginLeft` 和 `style.marginTop`。
181182
182183
## 计算样式:getComputedStyle
183184
184-
修改样式很简单但是如何**读取**它呢
185+
修改样式很简单但是如何 **读取** 样式呢
185186
186-
例如,我们想知道元素的大小、边距、颜色。应该怎么获取?
187+
例如,我们想知道元素的 size,margins 和 color。应该怎么获取?
187188
188-
**`style` 属性仅对 `"style"` 属性值进行操作,而不是任何 CSS 级联。**
189+
**`style` 属性仅对 `"style"` 属性值进行操作,而没有任何 CSS 级联(cascade)。**
189190
190-
因此我们不能使用 `elem.style` 来读取来自 CSS 类的任何内容。
191+
因此我们无法使用 `elem.style` 读取来自 CSS 类的任何内容。
191192
192-
例如,这里的 `style` 看不到边距
193+
例如,这里的 `style` 看不到 margin
193194
194195
```html run height=60 no-beautify
195196
<head>
@@ -200,28 +201,28 @@ setTimeout(() => document.body.style.display = "", 1000); // 恢复正常
200201
The red text
201202
<script>
202203
*!*
203-
alert(document.body.style.color); // empty
204-
alert(document.body.style.marginTop); // empty
204+
alert(document.body.style.color); // 空的
205+
alert(document.body.style.marginTop); // 空的
205206
*/!*
206207
</script>
207208
</body>
208209
```
209210
210-
...但如果我们需要,比如说,把边距增加 20px 呢?那么需要当前值作为开始
211+
……但如果我们需要,例如,将 margin 增加 20px 呢?那么我们需要 margin 的当前值
211212
212-
还有另一种方法:`getComputedStyle`。
213+
对于这个需求,这里有另一种方法:`getComputedStyle`。
213214
214-
语法是
215+
语法如下
215216
216217
```js
217-
getComputedStyle(element[, pseudo])
218+
getComputedStyle(element, [pseudo])
218219
```
219220
220221
element
221-
: 用来读取样式值的的元素
222+
: 需要被读取样式值的元素
222223
223224
pseudo
224-
: 假如给定一个伪元素,例如`::before`。空字符串或无参意味着元素本身
225+
: 伪元素(如果需要),例如 `::before`。空字符串或无参数则意味着元素本身
225226
226227
结果是一个具有样式属性的对象,像 `elem.style`,但现在对于所有的 CSS 类来说都是如此。
227228
@@ -236,7 +237,7 @@ pseudo
236237
<script>
237238
let computedStyle = getComputedStyle(document.body);
238239
239-
// 现在我们可以读出页边距和颜色了
240+
// 现在我们可以读取它的 margin 和 color 了
240241
241242
alert( computedStyle.marginTop ); // 5px
242243
alert( computedStyle.color ); // rgb(255, 0, 0)
@@ -246,22 +247,22 @@ pseudo
246247
```
247248
248249
```smart header="计算值和解析值"
249-
以下是 [CSS](https://drafts.csswg.org/cssom/#resolved-values) 中的两个概念
250+
[CSS](https://drafts.csswg.org/cssom/#resolved-values) 中有两个概念
250251
251-
1. **computed** 样式值是应用所有 CSS 规则和 CSS 继承之后的值,这是 CSS 级联的结果。它可以是 `height:1em` 或者 `font-size:125%`。
252-
2. **resolved** 样式值最终应用于元素值。像 `1em` 或者 `125%` 这样的值都是相对的。浏览器会进行值计算,然后对其进行 fixed 和 absolute,例如:`height:20px` 或 `font-size:16px`。对于几何属性,解析值可能是一个浮点,如 `width:50.5px`。
252+
1. **计算 (computed)** 样式值是所有 CSS 规则和 CSS 继承都应用后的值,这是 CSS 级联(cascade)的结果。它看起来像 `height:1em` `font-size:125%`。
253+
2. **解析 (resolved)** 样式值是最终应用于元素的样式值值。诸如 `1em` `125%` 这样的值是相对的。浏览器将使用计算(computed)值,并使所有单位均为固定的,且为绝对单位,例如:`height:20px` 或 `font-size:16px`。对于几何属性,解析(resolved)值可能具有浮点,例如:`width:50.5px`。
253254
254-
以前,为了获取计算值而创建 `getComputedStyle`,但是事实证明解析值会更加方便,标准也因此发生了变化。
255+
很久以前,创建了 `getComputedStyle` 来获取计算(computed)值,但事实证明,解析(resolved)值要方便得多,标准也因此发生了变化。
255256
256-
因此,现在 `getComputedStyle` 实际上返回的是属性的解析值。
257+
所以,现在 `getComputedStyle` 实际上返回的是属性的解析值(resolved)
257258
```
258259
259260
````warn header="`getComputedStyle` 需要完整的属性名"
260-
我们应该总是要求得到我们想要的确切的属性,例如 `paddingLeft`、`marginTop` 或者 `borderTopWidth`。否则,就不能保证正确的结果。
261+
我们应该总是使用我们想要的确切的属性,例如 `paddingLeft`、`marginTop` `borderTopWidth`。否则,就不能保证正确的结果。
261262
262-
例如,如果有 `paddingLeft/paddingTop` 属性,那么对于 `getComputedStyle(elem).padding`,我们应该得到什么?什么也没有,或者是从已知的填充中“生成”值?这里没有标准规则
263+
例如,如果有 `paddingLeft/paddingTop` 属性,那么对于 `getComputedStyle(elem).padding`,我们会得到什么?什么都没有,或者是从已知的 padding 中“生成”的值?这里没有标准的规则
263264
264-
仍存在其他的不一致。比如,一些浏览器(Chrome)在下述文档中显示 `10px`,一些浏览器(Firefox)—— 则效果不同
265+
还有其他不一致的地方。例如,在下面这个例子中,某些浏览器(Chrome)会显示 `10px`,而某些浏览器(Firefox)则没有
265266
266267
```html run
267268
<style>
@@ -276,27 +277,27 @@ pseudo
276277
```
277278
````
278279

279-
```smart header="\"Visited\" links styles are hidden!"
280-
访问过的链接可以使用 `:visited` CSS 伪类着色
280+
```smart header="应用于 `:visited` 链接的样式被隐藏了!"
281+
可以使用 CSS 伪类 `:visited` 对被访问过的链接进行着色
281282

282-
但 `getComputedStyle` 不允许访问该颜色,否则任意页面都可以通过在页面上创建连接并通过检查样式来确定用户是否访问了连接
283+
`getComputedStyle` 没有给出访问该颜色的方式,因为否则,任意页面都可以通过在页面上创建它,并通过检查样式来确定用户是否访问了某链接
283284

284-
JavaScript 中我们看不到 `:visited` 应用的样式。此外,CSS 中也有一个限制,禁止在 `:visited` 中应用更改几何的样式。这是为了保证一个不好的页面没有办法来测试是否访问了链接,从而窥探隐私
285+
JavaScript 看不到 `:visited` 所应用的样式。此外,CSS 中也有一个限制,即禁止在 `:visited` 中应用更改几何形状的样式。这是为了确保一个不好的页面无法测试链接是否被访问,进而窥探隐私
285286
```
286287
287288
## 总结
288289
289-
在管理 class,有两个 DOM 属性:
290+
要管理 class,有两个 DOM 属性:
290291
291-
- `className`— 字符串值可以很好地管理整个类集合
292-
- `classList`— 拥有 `add/remove/toggle/contains` 方法的对象可以很好地支持单独的类
292+
- `className` — 字符串值,可以很好地管理整个类的集合
293+
- `classList` — 具有 `add/remove/toggle/contains` 方法的对象,可以很好地支持单个类
293294
294-
改变样式
295+
要改变样式
295296
296-
- `style` 属性是一个带有 camelCased 样式的对象。对它的读取和修改 `"style"` 属性中的单个属性等价。要留意如果应用 `important` 和其他稀有内容 —— [MDN](mdn:api/CSSStyleDeclaration) 上有一个方法列表
297+
- `style` 属性是具有驼峰(camelCased样式的对象。对其进行读取和修改与修改 `"style"` 特性(attribute)中的各个属性具有相同的效果。要了解如何应用 `important` 和其他特殊内容 — 在 [MDN](mdn:api/CSSStyleDeclaration) 中有一个方法列表
297298
298-
- `style.cssText` 属性对应于整个“样式”属性,即完整的样式字符串。
299+
- `style.cssText` 属性对应于整个 `"style"` 特性(attribute),即完整的样式字符串。
299300
300-
获取已经解析的样式(对应于所有类,在应用所有 CSS 并计算最终值后):
301+
要读取已解析的(resolved)样式(对于所有类,在应用所有 CSS 并计算最终值之后):
301302
302-
- `getComputedStyle(elem[, pseudo])` 返回与 `style` 对象类似且包含了所有类的对象,是只读的
303+
- `getComputedStyle(elem, [pseudo])` 返回与 `style` 对象类似的,且包含了所有类的对象。只读

0 commit comments

Comments
 (0)