Translate react-dom by gotchane · Pull Request #45 · reactjs/ja.react.dev

gotchane · 2019-02-02T08:39:30Z

This PR is a part of #4.

Translation: https://reactjs.org/docs/react-dom.html

Please review 🙏

sasurau4

ありがとうございます 👍
ほとんど、スタイルに関する指摘です。修正よろしくお願いします。

gotchane · 2019-02-03T00:11:11Z

@sasurau4 @smikitky

ご確認ありがとうございます！
レビューいただいた点修正しました！

sasurau4 · 2019-02-03T09:26:23Z

LGTM 🚀
お疲れ様です！ 👍
@smikitky さんのレビューも入ると思うのでお待ちを 🙏

gotchane · 2019-02-05T05:15:03Z

見返して気づいた修正点を少し修正しました。
引き続きレビューお待ちしております 🙇

koba04

@gotchane レビューしましたので確認お願いします 🙇
hydrateについては、「クライアントと合わせる」という訳から「クライアントで再利用する」に変えましたが、これについては他の方の意見も聞きたいです。

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

gotchane · 2019-02-06T00:39:02Z

@koba04
Suggestion ありがとうございます！反映しました。
「クライアントで再利用する」という表現、僕は良いと思いました！

smikitky

確認をお願いします。

hydrate は直訳すると「水分を与える」(水素 hydrogen と同じ語源)ですが、要するに「入れ物（コンテナdiv）に中身を注ぐ」、もっと端的に言うとSSRにおいては単にコンテナに（HTMLに変換される）コンテンツを書き込むことだと思います。hydrate 自体に「再利用する」という意味はありません。しかも SSR 特有の単語かと思いきや、クライアント側のコードの render に対してまで hydrate を使っている文が2か所あり（これは原文が不親切）、その場合は「（初回）レンダー」と換言しても問題ないと思います。

smikitky · 2019-02-06T01:36:48Z

+> ルートの `ReactComponent` インスタンスへの参照が必要な場合は、ルート要素に[コールバックの ref](/docs/more-about-refs.html#the-ref-callback-attribute) を追加することを推奨します。
 >
-> Using `ReactDOM.render()` to hydrate a server-rendered container is deprecated and will be removed in React 17. Use [`hydrate()`](#hydrate) instead.
+> サーバで描画されたコンテナをクライアントで再利用するために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。


Suggested change
> サーバで描画されたコンテナをクライアントで再利用するために`ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。
> サーバで描画されたコンテナにコンテンツを書き込むために`ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。
原文に近づけたつもりですが、これはどちらでもいいです

挙動をイメージしやすいように実際の挙動からこの訳を出しましたが、指摘の通り原文の単語にこの意味はないので、どちらを取るかですね。

こちらは挙動のイメージのしやすさを踏まえ、「再利用する」のままにしますね。

smikitky · 2019-02-06T01:38:58Z

 ```

-Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
+[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。


Suggested change
[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html)により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。
[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html)によって HTML コンテンツが描画されるコンテナに書き込むために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。

「書き込む」だと、ReactDOM.hydrate()のタイミングで何かDOM更新するように受け取られるのではと感じたのですが如何でしょう？
原文かつ挙動にあった言葉が思い浮かばないですが...。

すみません SSR は殆ど素人なので実際の挙動に合っているようでしたら元の文で大丈夫です

「注入する」「賦活する」あたりの言葉も浮かびましたがどうせ意味不明になりそう…

こちらも同様、「再利用する」のままにします！

koba04 · 2019-02-06T02:47:48Z

hydrateについては、SSRで構築されたDOMに「動きを与える」（React Elementを構築してイベントリストを設定するなど）と理解しています。
確かにこの文章だと、その行為そのもの（再利用と表現した部分）と、hydrateを含んだrenderを指しているものがありますね。

smikitky · 2019-02-06T03:24:55Z

なるほど、hydrate とは render の一部なんですね…とりあえずクライアントの render を指している部分についての修正ができていれば、SSR側については分かりやすく訳せていれば大丈夫だと思います。

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

gotchane · 2019-02-06T10:35:04Z

@smikitky @koba04
レビュー・コメントありがとうございました！
単語の意味の確認通して、React の挙動についてとても勉強になりました。

議論を踏まえ、SSR の部分のみ「再利用する」のままにし、残りのご指摘を反映しました。
再度ご確認いただけるとありがたいです 🙏

koba04 · 2019-02-06T15:34:49Z

@gotchane mergeしました 🚀 ありがとうございます 👏👏👏

gotchane · 2019-02-07T00:11:30Z

ありがとうございました 🚀 🚀 🚀

translate reference-react-dom
b8f5861

smikitky self-requested a review February 2, 2019 09:04

sasurau4 suggested changes Feb 2, 2019
View reviewed changes

tesseralis mentioned this pull request Feb 2, 2019
Japanese Translation Progress #4
Closed
90 tasks

gotchane added 3 commits February 3, 2019 08:16

trim half-width space after punctuation
facce61

fix translation of note
c52edf0

fix translations pointed out
67b9614

sasurau4 approved these changes Feb 3, 2019
View reviewed changes

koba04 requested review from koba04 and removed request for koba04 February 4, 2019 01:15

fix a bit
e69d6c2

koba04 requested changes Feb 5, 2019
View reviewed changes

Apply suggestions from code review
53eecd2
Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

smikitky requested changes Feb 6, 2019
View reviewed changes

Apply suggestions from code review
313e88d
Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

smikitky approved these changes Feb 6, 2019
View reviewed changes

koba04 approved these changes Feb 6, 2019
View reviewed changes

koba04 merged commit 0caf551 into reactjs:masterFeb 6, 2019

gotchane deleted the translate/reference-react-dom branch February 7, 2019 00:10

	> サーバで描画されたコンテナをクライアントで再利用するために`ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。
	> サーバで描画されたコンテナにコンテンツを書き込むために`ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。

	[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html)により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。
	[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html)によって HTML コンテンツが描画されるコンテナに書き込むために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。

Uh oh!

Conversation

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

Uh oh!

Uh oh!

sasurau4 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gotchane commented Feb 3, 2019

Uh oh!

sasurau4 commented Feb 3, 2019

Uh oh!

gotchane commented Feb 5, 2019

Uh oh!

koba04 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gotchane commented Feb 6, 2019

Uh oh!

smikitky left a comment • 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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

smikitkyFeb 6, 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!

koba04Feb 6, 2019

Choose a reason for hiding this comment

Uh oh!

gotchaneFeb 6, 2019

Choose a reason for hiding this comment

Uh oh!

smikitkyFeb 6, 2019

Choose a reason for hiding this comment

Uh oh!

koba04Feb 6, 2019

Choose a reason for hiding this comment

Uh oh!

smikitkyFeb 6, 2019

Choose a reason for hiding this comment

Uh oh!

smikitkyFeb 6, 2019

Choose a reason for hiding this comment

Uh oh!

gotchaneFeb 6, 2019

Choose a reason for hiding this comment

Uh oh!

Uh oh!

koba04 commented Feb 6, 2019

Uh oh!

smikitky commented Feb 6, 2019

Uh oh!

gotchane commented Feb 2, 2019•
edited
Loading

smikitky left a comment •
edited
Loading

smikitkyFeb 6, 2019•
edited
Loading