Skip to content

docs: Advanced Guides > Reactivity Fundamentals の翻訳 (#31) #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 23, 2020

Conversation

mascii
Copy link
Collaborator

@mascii mascii commented Sep 22, 2020

resolve #31

Advanced Guides > Reactivity Fundamentals の翻訳

@netlify
Copy link

netlify bot commented Sep 22, 2020

Deploy preview for vuejs-v3-ja-doc-preview ready!

Built with commit 4d425c9

https://deploy-preview-82--vuejs-v3-ja-doc-preview.netlify.app


To create a reactive state from a JavaScript object, we can use a `reactive` method:
JavaScript のオブジェクトからリアクティブな状態を作る目的で、`reactive` メソッドを用いることができます:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

本家へフィードバックするための個人的なMEMO:
reactive メソッドは違和感がある。すべては function だと思う。

Copy link
Member

@kazupon kazupon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

レビュー 👀 コメント 💬 しました。
対応お願いします! 🙏


You can learn more about `reactive` in the [Basic Reactivity API's](../api/basic-reactivity.html) section
`reactive` についての詳細は [Basic Reactivity API](../api/basic-reactivity.html) セクションを参照してください
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Basic Reactivity API は以下のような訳お願いします。

Suggested change
`reactive` についての詳細は [Basic Reactivity API](../api/basic-reactivity.html) セクションを参照してください
`reactive` についての詳細は [基本 リアクティビティ API](../api/basic-reactivity.html) セクションを参照してください


When a ref is returned as a property on the render context (the object returned from [setup()](composition-api-setup.html)) and accessed in the template, it automatically unwraps to the inner value. There is no need to append `.value` in the template:
ref がレンダーコンテキスト([setup()](composition-api-setup.html) によって返されるオブジェクト)のプロパティとして返されていてテンプレート内でアクセスされる場合、自動的に内部の値にアンラップされます。テンプレート内においては `.value` を付ける必要はありません:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • レンダーコンテキスト ですが、このままでもいいですが、なるべくカタカナ日本語翻訳で意味がわからなくなった場合でも分かるように、原文も付加した形でにしておいてください
  • アンラップが wrap という概念に疎い人にはわかリにくいので、意訳する形にしました
Suggested change
ref がレンダーコンテキスト([setup()](composition-api-setup.html) によって返されるオブジェクト)のプロパティとして返されていてテンプレート内でアクセスされる場合、自動的に内部の値にアンラップされます。テンプレート内においては `.value` を付ける必要はありません:
ref がレンダーコンテキスト(render contenxt)([setup()](composition-api-setup.html) によって返されるオブジェクト)のプロパティとして返されていてテンプレート内でアクセスされる場合、自動的に内部の値にアンラップ(ref でラップされた値を元に値の状態に戻す)されます。テンプレート内においては `.value` を付ける必要はありません:

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • レンダーコンテキストの部分について、 () が二回連続し少々読みづらく感じたのですが、L34 での表記とあわせて「(render contenxt - setup() によって返されるオブジェクト)」のように変更しても良いでしょうか?
  • 意訳「ref でラップされた値を元に値の状態に戻す」について、"state" の意味での「状態」との混同を避けるため「ref でラップされた値を取り出す」という表現が良いかと考えましたが、いかがでしょうか?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「(render contenxt - setup() によって返されるオブジェクト)」のように変更しても良いでしょうか?

それでも大丈夫です。確かに、括弧が地続きですと、読みづらいですね。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"state" の意味での「状態」との混同を避けるため「ref でラップされた値を取り出す」という表現が良いかと考えましたが、いかがでしょうか?

確かに「値の状態に戻す」 ですと state と間違いやすいですね。その案でいいと思います。


## Creating Standalone Reactive Values as `refs`
## 独立したリアクティブな値を `refs` として作成する
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

refs ですが、原文は references だと長いので refs に略しています。
日本語訳の方は、refs は以下の参照としておいてください。

Suggested change
## 独立したリアクティブな値を `refs` として作成する
## 独立したリアクティブな値を `参照` として作成する

console.log(book.title) // 'Vue 3 Detailed Guide'
```

You can learn more about `refs` in the [Refs API](../api/refs-api.html#ref) section
`refs` についての詳細は [Refs API](../api/refs-api.html#ref) セクションを参照してください
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

以下の意訳でお願いします。

Suggested change
`refs` についての詳細は [Refs API](../api/refs-api.html#ref) セクションを参照してください
`ref` で作成した `参照` についての詳細は [参照 (refs) API](../api/refs-api.html#ref) セクションを参照してください

@mascii
Copy link
Collaborator Author

mascii commented Sep 23, 2020

@kazupon ご指摘いただいていた箇所について 4d425c9 で修正しましたので、ご確認お願いいたします。

@kazupon
Copy link
Member

kazupon commented Sep 23, 2020

対応ありがとうございます!
確認しました。
CIでエラーが発生していますが、翻訳作業に支障はない(このPRとは別事象)なので、マージします。

翻訳ありがとうございました。

@kazupon kazupon merged commit 0565c78 into vuejs-jp:lang-ja Sep 23, 2020
@mascii
Copy link
Collaborator Author

mascii commented Sep 24, 2020

@kazupon レビューいただきありがとうございました!

@mascii mascii deleted the translate-reactivity-fundamentals branch September 24, 2020 00:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Advanced Guides > Reactivity Fundamentals の翻訳
2 participants