docs(cn): translate content/docs/reference-events.md into Chinese by Ryanhui · Pull Request #101 · reactjs/zh-hans.react.dev

Ryanhui · 2019-02-16T02:56:54Z

No description provided.

netlify · 2019-02-16T03:00:01Z

Deploy preview for cn-reactjs ready!

Built with commit ae22e81

https://deploy-preview-101--cn-reactjs.netlify.com

ycjcl868 · 2019-02-16T14:22:03Z

  }, 0);

-  // Won't work. this.state.clickEvent will only contain null values.
+  // 无用，this.state.clickEvent 会只包含 null 值


Suggested change

// 无用，this.state.clickEvent 会只包含 null 值

// 不起作用，this.state.clickEvent 的值将会只包含 null

Ryanhui · 2019-02-17T00:31:13Z

已修改

yuqingc · 2019-03-08T03:24:01Z

+此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。参考 [Handling Events](/docs/handling-events.html) 指南学习更多。

-## Overview {#overview}
+## 概述 {#overview}


Suggested change

## 概述 {#overview}

## 概览 {#overview}

FYI: #2

QC-L · 2019-03-09T17:05:51Z

 ---

-This reference guide documents the `SyntheticEvent` wrapper that forms part of React's Event System. See the [Handling Events](/docs/handling-events.html) guide to learn more.
+此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。参考 [Handling Events](/docs/handling-events.html) 指南学习更多。


Suggested change

此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。参考 [Handling Events](/docs/handling-events.html) 指南学习更多。

此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。请参考有关[事件处理](/docs/handling-events.html)的指南来了解更多。

QC-L · 2019-03-09T17:06:22Z

@@ -6,13 +6,13 @@ layout: docs
 category: Reference
 ---



标题翻译为合成事件？

QC-L · 2019-03-09T17:10:53Z

+## 概述 {#overview}

-Your event handlers will be passed instances of `SyntheticEvent`, a cross-browser wrapper around the browser's native event. It has the same interface as the browser's native event, including `stopPropagation()` and `preventDefault()`, except the events work identically across all browsers.
+`SyntheticEvent` 实例将被传递给你的事件处理程序，这是一个浏览器原生事件的跨浏览器包装器。除了在所有浏览器间完全相同的事件，它有着和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()` 。


Suggested change

`SyntheticEvent` 实例将被传递给你的事件处理程序，这是一个浏览器原生事件的跨浏览器包装器。除了在所有浏览器间完全相同的事件，它有着和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()` 。

`SyntheticEvent` 实例将被传递给你的事件处理函数，它是浏览器的原生事件的跨浏览器包装器。除兼容所有浏览器外，它还拥有和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()`。

QC-L · 2019-03-09T17:12:03Z

+`SyntheticEvent` 实例将被传递给你的事件处理程序，这是一个浏览器原生事件的跨浏览器包装器。除了在所有浏览器间完全相同的事件，它有着和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()` 。

-If you find that you need the underlying browser event for some reason, simply use the `nativeEvent` attribute to get it. Every `SyntheticEvent` object has the following attributes:
+如果因为某些原因，你需要使用浏览器的底层事件，只需要使用 `nativeEvent` 属性实现。每个 `SyntheticEvent` 对象有以下属性：


Suggested change

如果因为某些原因，你需要使用浏览器的底层事件，只需要使用 `nativeEvent` 属性实现。每个 `SyntheticEvent` 对象有以下属性：

当你需要使用浏览器的底层事件时，只需要使用 `nativeEvent` 属性来获取即可。每个 `SyntheticEvent` 对象都包含以下属性：

QC-L · 2019-03-09T17:15:25Z

+> 注意：
 >
-> As of v0.14, returning `false` from an event handler will no longer stop event propagation. Instead, `e.stopPropagation()` or `e.preventDefault()` should be triggered manually, as appropriate.
+> 截止 v0.14 ，事件处理程序返回 `false` 不再阻止事件传播。相反，`e.stopPropagation()` 或者 `e.preventDefault()` 应适当的手动触发。


Suggested change

> 截止 v0.14 ，事件处理程序返回 `false` 不再阻止事件传播。相反，`e.stopPropagation()` 或者 `e.preventDefault()` 应适当的手动触发。

> 截止 v0.14，当事件处理函数返回 `false` 时，不再阻止事件冒泡。你可以选择使用 `e.stopPropagation()` 或者 `e.preventDefault()` 替代。

QC-L · 2019-03-09T17:21:03Z

+## 支持的事件 {#supported-events}

-React normalizes events so that they have consistent properties across different browsers.
+React 使事件正常化，所以他们在不同浏览器中有一致的属性。


Suggested change

React 使事件正常化，所以他们在不同浏览器中有一致的属性。

React 使事件规范化，因此它们在不同浏览器中拥有相同的属性。

QC-L · 2019-03-09T17:23:26Z

+React 使事件正常化，所以他们在不同浏览器中有一致的属性。

-The event handlers below are triggered by an event in the bubbling phase. To register an event handler for the capture phase, append `Capture` to the event name; for example, instead of using `onClick`, you would use `onClickCapture` to handle the click event in the capture phase.
+以下的事件处理函数在冒泡阶段被事件触发。要在注册捕获阶段的事件处理函数，需要为事件名称添加 `Capture` 。例如，不是使用 `onClick` ，而是使用 `onClickCapture` 处理捕获阶段的点击事件。


Suggested change

以下的事件处理函数在冒泡阶段被事件触发。要在注册捕获阶段的事件处理函数，需要为事件名称添加 `Capture` 。例如，不是使用 `onClick` ，而是使用 `onClickCapture` 处理捕获阶段的点击事件。

以下的事件处理函数在冒泡阶段被触发。如需注册捕获阶段的事件处理函数，则应为事件名添加 `Capture`。例如，处理捕获阶段的点击事件请使用 `onClickCapture`，而不是 `onClick`。

QC-L · 2019-03-09T17:23:54Z

 onDragLeave onDragOver onDragStart onDrop onMouseDown onMouseEnter onMouseLeave
 onMouseMove onMouseOut onMouseOver onMouseUp
 ```
+`onMouseEnter` 和 `onMouseLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。


Suggested change

`onMouseEnter` 和 `onMouseLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

`onMouseEnter` 和 `onMouseLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

QC-L · 2019-03-09T17:24:10Z

 onPointerDown onPointerMove onPointerUp onPointerCancel onGotPointerCapture
 onLostPointerCapture onPointerEnter onPointerLeave onPointerOver onPointerOut
 ```
+`onPointerEnter` 和 `onPointerLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。


Suggested change

`onPointerEnter` 和 `onPointerLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

`onPointerEnter` 和 `onPointerLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

QC-L · 2019-03-09T17:26:47Z

+关于跨浏览器支持的说明：

-Pointer events are not yet supported in every browser (at the time of writing this article, supported browsers include: Chrome, Firefox, Edge, and Internet Explorer). React deliberately does not polyfill support for other browsers because a standard-conform polyfill would significantly increase the bundle size of `react-dom`.
+并非每个浏览器都支持指针事件（在写这篇文章时，支持的浏览器有：Chrome，Firefox，Edge，和 Internet Explorer）。React 有意没有通过 polyfill 支持其他浏览器，因为符合标准的 polyfill 会显著增加 react-dom 的包大小。


Suggested change

并非每个浏览器都支持指针事件（在写这篇文章时，支持的浏览器有：Chrome，Firefox，Edge，和 Internet Explorer）。React 有意没有通过 polyfill 支持其他浏览器，因为符合标准的 polyfill 会显著增加 react-dom 的包大小。

并非每个浏览器都支持指针事件（在写这篇文章时，已支持的浏览器有：Chrome，Firefox，Edge 和 Internet Explorer）。React 故意不通过 polyfill 的方式适配其他浏览器，主要是符合标准的 polyfill 会显著增加 react-dom 的 bundle 大小。

netlify · 2019-03-12T06:01:56Z

Deploy preview for zh-hans-reactjs ready!

Built with commit ae22e81

https://deploy-preview-101--zh-hans-reactjs.netlify.com

thoamsy · 2019-03-12T11:48:25Z

+## 支持的事件 {#supported-events}

-React normalizes events so that they have consistent properties across different browsers.
+React 使事件规范化，因此它们在不同浏览器中拥有相同的属性。


React 通过将事件 normalize 以让它们在不同浏览器中拥有一致的属性？

@Ryanhui 修改下~

jothy1023 · 2019-03-13T14:06:12Z

 ---

-This reference guide documents the `SyntheticEvent` wrapper that forms part of React's Event System. See the [Handling Events](/docs/handling-events.html) guide to learn more.
+此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。请参考有关[事件处理](/docs/handling-events.html)的指南来了解更多。


此参考指南记录了构成 React 事件系统一部分的 SyntheticEvent 包装器。请参考事件处理的指南来了解更多。

不需要「有关」吧，这个文档直接就是讲「事件处理」的呀

jothy1023 · 2019-03-13T14:10:01Z

+`SyntheticEvent` 实例将被传递给你的事件处理函数，它是浏览器的原生事件的跨浏览器包装器。除兼容所有浏览器外，它还拥有和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()`。

-If you find that you need the underlying browser event for some reason, simply use the `nativeEvent` attribute to get it. Every `SyntheticEvent` object has the following attributes:
+如果因为某些原因，当你需要使用浏览器的底层事件时，只需要使用 `nativeEvent` 属性来获取即可。每个 `SyntheticEvent` 对象都包含以下属性：


当你出于某些原因，必须使用浏览器的底层事件时，你只需使用 nativeEvent 属性即可获取。每个 SyntheticEvent 对象都包含以下属性：

jothy1023 · 2019-03-13T14:13:41Z

+> 注意：
 >
-> As of v0.14, returning `false` from an event handler will no longer stop event propagation. Instead, `e.stopPropagation()` or `e.preventDefault()` should be triggered manually, as appropriate.
+> 截止 v0.14，当事件处理函数返回 `false` 时，不再阻止事件冒泡。你可以选择使用 `e.stopPropagation()` 或者 `e.preventDefault()` 替代。


自 v0.14 起，从事件处理函数中返回 false 将不再阻止事件冒泡。更恰当的做法是使用 e.stopPropagation() 或者 e.preventDefault() 手动触发。

jothy1023 · 2019-03-13T14:24:10Z

+并非每个浏览器都支持指针事件（在写这篇文章时，已支持的浏览器有：Chrome，Firefox，Edge 和 Internet Explorer）。React 故意不通过 polyfill 的方式适配其他浏览器，主要是符合标准的 polyfill 会显著增加 react-dom 的 bundle 大小。

-If your application requires pointer events, we recommend adding a third party pointer event polyfill.
+如果你的应用要求指针事件，我们推荐添加第三方的指针事件 polyfil 。


如果你的应用需要用到指针事件，我们建议你添加第三方的指针事件 polyfill。

不过，这个 React 是不是已经支持了？

…actjs#101)

docs(cn): translate content/docs/reference-events.md into Chinese

092284d

QC-L added the Pending Review 已翻译，待校对阶段 label Feb 16, 2019

ycjcl868 reviewed Feb 16, 2019

View reviewed changes

QC-L added Pending Modify 已校对，待修改阶段 and removed Pending Review 已翻译，待校对阶段 labels Feb 16, 2019

modify

8efa8cc

QC-L added Pending Review 已翻译，待校对阶段 and removed Pending Review 已翻译，待校对阶段 labels Feb 17, 2019

QC-L requested changes Feb 17, 2019

View reviewed changes

Comment thread content/docs/reference-events.md

QC-L mentioned this pull request Feb 17, 2019

OLD CLAIMS #4

Closed

add the deleted row

5958fd0

QC-L added Pending Re-Review 已修改，待审校阶段 and removed Pending Modify 已校对，待修改阶段 labels Feb 21, 2019

hijiangtao requested review from QC-L and ycjcl868 February 24, 2019 03:09

yuqingc suggested changes Mar 8, 2019

View reviewed changes

QC-L requested changes Mar 9, 2019

View reviewed changes

modify

1f165a5

modify

ae5fe20

QC-L previously approved these changes Mar 12, 2019

View reviewed changes

thoamsy reviewed Mar 12, 2019

View reviewed changes

Update reference-events.md

ae22e81

QC-L dismissed their stale review via ae22e81 March 12, 2019 14:27

QC-L approved these changes Mar 12, 2019

View reviewed changes

hijiangtao approved these changes Mar 12, 2019

View reviewed changes

hijiangtao merged commit 299594c into reactjs:master Mar 12, 2019

jothy1023 reviewed Mar 13, 2019

View reviewed changes

OhIAmFine pushed a commit to OhIAmFine/zh-hans.reactjs.org that referenced this pull request May 6, 2019

docs(cn): translate content/docs/reference-events.md into Chinese (re…

1506cfb

…actjs#101)

	// 无用，this.state.clickEvent 会只包含 null 值
	// 不起作用，this.state.clickEvent 的值将会只包含 null

	此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。参考 [Handling Events](/docs/handling-events.html) 指南学习更多。
	此参考指南记录了构成 React 事件系统一部分的 `SyntheticEvent` 包装器。请参考有关[事件处理](/docs/handling-events.html)的指南来了解更多。

	`SyntheticEvent` 实例将被传递给你的事件处理程序，这是一个浏览器原生事件的跨浏览器包装器。除了在所有浏览器间完全相同的事件，它有着和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()` 。
	`SyntheticEvent` 实例将被传递给你的事件处理函数，它是浏览器的原生事件的跨浏览器包装器。除兼容所有浏览器外，它还拥有和浏览器原生事件相同的接口，包括 `stopPropagation()` 和 `preventDefault()`。

	如果因为某些原因，你需要使用浏览器的底层事件，只需要使用 `nativeEvent` 属性实现。每个 `SyntheticEvent` 对象有以下属性：
	当你需要使用浏览器的底层事件时，只需要使用 `nativeEvent` 属性来获取即可。每个 `SyntheticEvent` 对象都包含以下属性：

	> 截止 v0.14 ，事件处理程序返回 `false` 不再阻止事件传播。相反，`e.stopPropagation()` 或者 `e.preventDefault()` 应适当的手动触发。
	> 截止 v0.14，当事件处理函数返回 `false` 时，不再阻止事件冒泡。你可以选择使用 `e.stopPropagation()` 或者 `e.preventDefault()` 替代。

	React 使事件正常化，所以他们在不同浏览器中有一致的属性。
	React 使事件规范化，因此它们在不同浏览器中拥有相同的属性。

	以下的事件处理函数在冒泡阶段被事件触发。要在注册捕获阶段的事件处理函数，需要为事件名称添加 `Capture` 。例如，不是使用 `onClick` ，而是使用 `onClickCapture` 处理捕获阶段的点击事件。
	以下的事件处理函数在冒泡阶段被触发。如需注册捕获阶段的事件处理函数，则应为事件名添加 `Capture`。例如，处理捕获阶段的点击事件请使用 `onClickCapture`，而不是 `onClick`。

	`onMouseEnter` 和 `onMouseLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

	`onMouseEnter` 和 `onMouseLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

	`onPointerEnter` 和 `onPointerLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

	`onPointerEnter` 和 `onPointerLeave` 事件从离开的元素向进入的元素传播，不是正常的冒泡，也没有捕获阶段。

	并非每个浏览器都支持指针事件（在写这篇文章时，支持的浏览器有：Chrome，Firefox，Edge，和 Internet Explorer）。React 有意没有通过 polyfill 支持其他浏览器，因为符合标准的 polyfill 会显著增加 react-dom 的包大小。
	并非每个浏览器都支持指针事件（在写这篇文章时，已支持的浏览器有：Chrome，Firefox，Edge 和 Internet Explorer）。React 故意不通过 polyfill 的方式适配其他浏览器，主要是符合标准的 polyfill 会显著增加 react-dom 的 bundle 大小。

Conversation

Ryanhui commented Feb 16, 2019

Uh oh!

netlify Bot commented Feb 16, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Ryanhui commented Feb 17, 2019

Uh oh!

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!

netlify Bot commented Mar 12, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

thoamsy Mar 12, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

netlify Bot commented Feb 16, 2019 •

edited

Loading

netlify Bot commented Mar 12, 2019 •

edited

Loading

thoamsy Mar 12, 2019 •

edited

Loading