Translation/dom navigation by steinliber · Pull Request #168 · javascript-tutorial/zh.javascript.info

steinliber · 2018-07-20T12:04:17Z

Translation/dom navigation

leviding · 2018-07-22T16:03:50Z

resolve #129

upupming · 2018-08-01T08:09:01Z

校对认领

upupming

翻译处理的很好！
最主要问题就是 Element 有元素的意思，所以在 Node 部分尽量不要把一些单词翻译成带有“元素”这样的字眼

upupming · 2018-08-01T08:41:19Z

 ![](dom-links.png)

-Let's discuss them in more detail.
+让我们更详细的讨论这些。


upupming · 2018-08-01T08:59:15Z


-````warn header="There's a catch: `document.body` can be `null`"
-A script cannot access an element that doesn't exist at the moment of running.
+````warn header="这里有个问题：`document.body` 的值不能是 `null`"


不能 -> 可能

upupming · 2018-08-01T09:05:43Z

-```smart header="In the DOM world `null` means \"doesn't exist\""
-In the DOM, the `null` value means "doesn't exist" or "no such node".
-```
+```smart header="在 DOM 世界中 `null` 就意味着”不存在“”


引号用反了，还有注意这里是特定语法 header="..."，所以最后一个引号不用改为全角
”不存在“” 改为 “不存在”"

upupming · 2018-08-01T09:06:41Z

-In the DOM, the `null` value means "doesn't exist" or "no such node".
-```
+```smart header="在 DOM 世界中 `null` 就意味着”不存在“”
+在 DOM 中，`null` 值就意味着“不存在”或者”没有这样的节点“。 


引号反了

”没有这样的节点“ 改为 “没有这样的节点”

upupming · 2018-08-01T09:11:40Z


 `<html>` = `document.documentElement`
-: The topmost document node is `document.documentElement`. That's DOM node of `<html>` tag.
+：最上面的 document 节点是  `document.documentElement`。这是对应 `<html>` 标签的 DOM 节点。


这里的半角冒号应该是用来生成特定标签的语法，不要修改成全角冒号。

@upupming 你是我与遇见的第一个用图说话的孩子

upupming · 2018-08-01T09:53:10Z

 ---

-# DOM children
+# DOM 子元素


这里的 children 应该没有 element 的意思，或许翻译成孩子比较好

upupming · 2018-08-01T09:54:42Z

 ```

-The second `<li>` (with Pete):
+获取第二个 `<li>`（内容里有 Pete）


with Pete 跟 task.md 翻译不一样了

upupming · 2018-08-01T09:55:54Z

+# 兄弟节点问题

-If `elem` -- is an arbitrary DOM element node...
+如果 `elem` 是任意一个 DOM 元素节点。。。


省略号……

@steinliber 这里要根据校对着意见改下

upupming · 2018-08-01T09:58:32Z


- Is it true that `elem.lastChild.nextSibling` is always `null`?
- Is it true that `elem.children[0].previousSibling` is always `null` ?
+- `elem.lastChild.nextSibling` 一直是 `null` 是不是真的？


这样翻译有点不合语言习惯
一直是 null 是不是真的？ -> 永远是 null吗？

upupming · 2018-08-01T09:59:04Z

@@ -1,4 +1,4 @@
-1. Yes, true. The element `elem.lastChild` is always the last one, it has no `nextSibling`, so if there are children, then yes.
-2. No, wrong, because `elem.children[0]` is the first child among elements. But there may be non-element nodes before it. So `previousSibling` may be a text node.
+1. 是的，这是真的。`elem.lastChild` 一直是最后一个元素，它就没有 `nextSibling` ，所有如果存在子元素，这个问题的答案就是正确。


是的，这是真的。建议用更地道的表达
elem.lastChild 不能说是元素，会和 element 搞混。

leviding · 2018-08-02T00:23:38Z

@upupming 辛苦啦 @steinliber 可以修改啦

steinliber · 2018-08-06T06:41:11Z

已经根据意见进行了修改 @leviding ，校对很用心，非常感谢 @upupming 🙏

Starriers · 2018-08-09T03:25:33Z

@leviding 校对认领

leviding · 2018-08-09T11:04:40Z

@Starriers ok

leviding · 2018-08-10T11:20:07Z

@Starriers 等你校对哈

Starriers · 2018-08-10T11:33:17Z

@leviding OK 今晚弄好

leviding · 2018-08-14T13:19:44Z

@Starriers 校对怎么样了？

Starriers

@steinliber @leviding 校对完成
翻译得挺好的，总结起来就只有两个问题：

破折号用中文的（全部）
md（虽然不是严格意义上的 md）一般都是只空一行，这个自己再检查一下，然后我可以再给你看下，后面看的眼有点花，不一定全部指出来了。

Starriers · 2018-08-10T12:58:24Z


 `<html>` = `document.documentElement`
-: The topmost document node is `document.documentElement`. That's DOM node of `<html>` tag.
+：最上面的 document 节点是  `document.documentElement`。这是对应 `<html>` 标签的 DOM 节点。


@upupming 你是我与遇见的第一个用图说话的孩子

Starriers · 2018-08-14T14:21:56Z

@@ -1,24 +1,25 @@
-importance: 5
+重要度：5


Starriers · 2018-08-14T14:23:14Z

@@ -1,10 +1,10 @@
-importance: 5
+重要度：5


Starriers · 2018-08-14T14:23:20Z

@@ -1,10 +1,11 @@
-importance: 5
+重要度：5


Starriers · 2018-08-14T14:23:29Z

@@ -1,18 +1,19 @@
-importance: 5
+重要度：5


Starriers · 2018-08-14T14:47:10Z

+窗口坐标并不会考虑到文档滚动，它们就是基于窗口的左上角计算出来的。
+

 In other words, when we scroll the page, the element goes up or down, *its window coordinates change*. That's very important.


原文删除删除多余空行即可

Starriers · 2018-08-14T14:48:18Z

- Some browsers (like Chrome) also add to the result `getBoundingClientRect` properties `width` and `height`. We can get them also by subtraction: `height=bottom-top`, `width=right-left`.

-```warn header="Coordinates right/bottom are different from CSS properties"
 If we compare window coordinates versus CSS positioning, then there are obvious similarities to `position:fixed` -- also the position relative to the viewport.


删除原文删除多余空行

Starriers · 2018-08-14T14:55:01Z


-As it uses window coordinates, the element may be different depending on the current scroll position.
+因为它使用的是窗口坐标，基于现在滚动的位置会显示不同的元素。
+


多了空行

Starriers · 2018-08-14T14:55:18Z

+这里就是一个典型的错误，如果我们不检查，它就可能会发生。

-Here's a typical error that may occur if we don't check for it:



多了空行

Starriers · 2018-08-14T14:57:16Z

+- 元素的 `pageX` 和 `pageY` 坐标始终保持一致，因为它们是相对于文档计算的。

-## Getting document coordinates [#getCoords]



多了空行

leviding · 2018-08-15T03:13:44Z

@steinliber 可以修改了

steinliber · 2018-08-15T07:19:41Z

根据校对意见做了更改谢谢两位，有个问题不是很确定，task 里的 importance 需要翻译吗 @leviding

leviding · 2018-08-15T07:42:07Z

@steinliber 那个不翻译

steinliber · 2018-08-15T09:34:05Z

ok, 已经做了相应的更改

leviding · 2018-08-15T14:22:00Z

辛苦，明天白天我 review 下

mengjf added 2 commits July 20, 2018 20:02

Translation/dom navigation

a2fc512

Translation/coordinate

d4879ee

leviding added the 校对认领 label Jul 22, 2018

leviding mentioned this pull request Jul 22, 2018

2-ui/1-document/03-dom-navigation #129

Closed

upupming approved these changes Aug 1, 2018

View reviewed changes

leviding added the 正在校对 label Aug 2, 2018

modify base on advise

099749e

leviding added the WIP Work in process label Aug 6, 2018

leviding removed the 校对认领 label Aug 9, 2018

leviding removed the WIP Work in process label Aug 10, 2018

Starriers reviewed Aug 14, 2018

View reviewed changes

leviding added the enhancement New feature or request label Aug 15, 2018

modify base on advise

41e6638

importance in task not translate

3d5604b

leviding added WIP Work in process and removed enhancement New feature or request labels Aug 15, 2018

leviding added 12 commits August 18, 2018 19:17

Update task.md

78f266e

Update task.md

5bde2d0

Update task.md

4233af7

Update task.md

b2bfaab

Update task.md

34c8528

Update solution.md

93bfc2c

Update task.md

87d31c8

Update task.md

4aa9762

Update article.md

09f2181

Update article.md

53c40fc

Update article.md

c530f3a

Update article.md

5210a62

leviding approved these changes Aug 18, 2018

View reviewed changes

leviding merged commit c85940d into javascript-tutorial:zh-hans Aug 18, 2018

leviding added 翻译完成 and removed WIP Work in process 正在校对 labels Aug 18, 2018

		窗口坐标并不会考虑到文档滚动，它们就是基于窗口的左上角计算出来的。


		In other words, when we scroll the page, the element goes up or down, its window coordinates change. That's very important.


		As it uses window coordinates, the element may be different depending on the current scroll position.
		因为它使用的是窗口坐标，基于现在滚动的位置会显示不同的元素。

		这里就是一个典型的错误，如果我们不检查，它就可能会发生。

		Here's a typical error that may occur if we don't check for it:

		- 元素的 `pageX` 和 `pageY` 坐标始终保持一致，因为它们是相对于文档计算的。

		## Getting document coordinates [#getCoords]

		@@ -1,24 +1,25 @@
		importance: 5
		重要度：5

		@@ -1,10 +1,10 @@
		importance: 5
		重要度：5

		@@ -1,10 +1,11 @@
		importance: 5
		重要度：5

		@@ -1,18 +1,19 @@
		importance: 5
		重要度：5

Conversation

steinliber commented Jul 20, 2018

Uh oh!

leviding commented Jul 22, 2018

Uh oh!

upupming commented Aug 1, 2018

Uh oh!

upupming left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

leviding commented Aug 2, 2018

Uh oh!

steinliber commented Aug 6, 2018

Uh oh!

Starriers commented Aug 9, 2018

Uh oh!

leviding commented Aug 9, 2018

Uh oh!

leviding commented Aug 10, 2018

Uh oh!

Starriers commented Aug 10, 2018

Uh oh!

leviding commented Aug 14, 2018

Uh oh!

Starriers left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

leviding commented Aug 15, 2018

Uh oh!

steinliber commented Aug 15, 2018

Uh oh!

leviding commented Aug 15, 2018

Uh oh!

steinliber commented Aug 15, 2018

Uh oh!

leviding commented Aug 15, 2018