Skip to content
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

Advanced Guides > Compotion API > Template Refs の翻訳 #93

Merged
merged 3 commits into from
Sep 27, 2020
Merged

Advanced Guides > Compotion API > Template Refs の翻訳 #93

merged 3 commits into from
Sep 27, 2020

Conversation

konu96
Copy link
Contributor

@konu96 konu96 commented Sep 26, 2020

Description of Problem

resolve #36

https://v3.vuejs.org/guide/composition-api-template-refs.html#template-refs の翻訳をした

Proposed Solution

Additional Information

@netlify
Copy link

netlify bot commented Sep 26, 2020

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

Built with commit c5cb6b8

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

@@ -1,10 +1,11 @@
## Template Refs

> This section uses [single-file component](single-file-component.html) syntax for code examples
> この節ではサンプルコードで [単一ファイルコンポーネント](single-file-component.html)の文法を使用しています。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

セクションをそのままにしていいか分からなかったので、取り敢えず「節」と訳しています

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.

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

@@ -1,10 +1,11 @@
## Template Refs
Copy link
Member

Choose a reason for hiding this comment

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

Tempalte Refs ですが、 以下のようにテンプレート参照でお願いします! 🙏

Suggested change
## Template Refs
## テンプレート参照


> This guide assumes that you have already read the [Composition API Introduction](composition-api-introduction.html) and [Reactivity Fundamentals](reactivity-fundamentals.html). Read that first if you are new to Composition API.
> このガイドはすでに [Composition API 導入](composition-api-introduction.html) を読んでいることを前提に書かれています。もしまだ読んでいないのなら、先に読みましょう。
Copy link
Member

Choose a reason for hiding this comment

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

Composition API の訳は、コンポジション API で訳していくことにしたので、以下のようにしておいてください。 🙏

Suggested change
> このガイドはすでに [Composition API 導入](composition-api-introduction.html) を読んでいることを前提に書かれています。もしまだ読んでいないのなら、先に読みましょう。
> このガイドはすでに [コンポジション API 導入](composition-api-introduction.html) を読んでいることを前提に書かれています。もしまだ読んでいないのなら、先に読みましょう。


When using the Composition API, the concept of [reactive refs](reactivity-fundamentals.html#creating-standalone-reactive-values-as-refs) and [template refs](component-template-refs.html) are unified. In order to obtain a reference to an in-template element or component instance, we can declare a ref as usual and return it from [setup()](composition-api-setup.html):
Composition API を使うとき、 [リアクティブ refs](reactivity-fundamentals.html#creating-standalone-reactive-values-as-refs) と [テンプレート refs](component-template-refs.html) のコンセプトは同じになります。
Copy link
Member

Choose a reason for hiding this comment

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

  • Composition API の訳は、コンポジション API
  • reactive refs は リアクティブ参照
  • template refs は テンプレート参照
Suggested change
Composition API を使うとき、 [リアクティブ refs](reactivity-fundamentals.html#creating-standalone-reactive-values-as-refs)[テンプレート refs](component-template-refs.html) のコンセプトは同じになります。
コンポジション API を使うとき、 [リアクティブ参照](reactivity-fundamentals.html#creating-standalone-reactive-values-as-refs)[テンプレート参照](component-template-refs.html) のコンセプトは同じになります。

@@ -31,9 +32,9 @@ When using the Composition API, the concept of [reactive refs](reactivity-fundam
</script>
```

Here we are exposing `root` on the render context and binding it to the div as its ref via `ref="root"`. In the Virtual DOM patching algorithm, if a VNode's `ref` key corresponds to a ref on the render context, the VNode's corresponding element or component instance will be assigned to the value of that ref. This is performed during the Virtual DOM mount / patch process, so template refs will only get assigned values after the initial render.
描画コンテキストに `root` 変数を渡していて、`ref="root"` 経由で div 要素とバインドします. 仮想 DOM のパッチアルゴリズムの中で、 もし VNode`ref` キーは描画コンテキストの ref に対応すると、VNode の対応する要素またはコンポーネントインスタンスに ref の値が割り当てられます。これは仮想 DOM のマウント/パッチ処理中に実行されるので、テンプレート refs では初期描画に値だけを取得できます。
Copy link
Member

Choose a reason for hiding this comment

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

binding は以下のように 束縛します お願いします!

Suggested change
描画コンテキストに `root` 変数を渡していて、`ref="root"` 経由で div 要素とバインドします. 仮想 DOM のパッチアルゴリズムの中で、 もし VNode の `ref` キーは描画コンテキストの ref に対応すると、VNode の対応する要素またはコンポーネントインスタンスに ref の値が割り当てられます。これは仮想 DOM のマウント/パッチ処理中に実行されるので、テンプレート refs では初期描画に値だけを取得できます。
描画コンテキストに `root` 変数を渡していて、`ref="root"` 経由で div 要素と束縛します. 仮想 DOM のパッチアルゴリズムの中で、 もし VNode の `ref` キーは描画コンテキストの ref に対応すると、VNode の対応する要素またはコンポーネントインスタンスに ref の値が割り当てられます。これは仮想 DOM のマウント/パッチ処理中に実行されるので、テンプレート refs では初期描画に値だけを取得できます。


Refs used as templates refs behave just like any other refs: they are reactive and can be passed into (or returned from) composition functions.
テンプレート 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.

  • template refs は テンプレート参照
  • ここの refs (原文ででてくる用語の refs) は references の略称。なので、訳も参照で。
Suggested change
テンプレート refs は他の refs と似た挙動をします。つまり、リアクティブかつコンポジション関数に渡せる(または返せる)ことができます。
テンプレート参照は他の参照と似た挙動をします。つまり、リアクティブかつコンポジション関数に渡せる(または返せる)ことができます。

return () => <div ref={root} />
}
}
```

### Usage inside `v-for`

Composition API template refs do not have special handling when used inside `v-for`. Instead, use function refs to perform custom handling:
コンポジション API のテンプレート refs `v-for` 内部で使う時に特別な処理はされないです。代わりに、関数 refs を使って独自処理を実行してください。
Copy link
Member

Choose a reason for hiding this comment

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

function refs は意訳的に以下のようにすると分かりやすいです。

Suggested change
コンポジション API のテンプレート refs を `v-for` 内部で使う時に特別な処理はされないです。代わりに、関数 refs を使って独自処理を実行してください
コンポジション API のテンプレート参照を `v-for` 内部で使う時には特別な処理はされないです。代わりに、参照を提供する関数を使って独自処理を実行してください

@konu96
Copy link
Contributor Author

konu96 commented Sep 27, 2020

細かい点までレビューありがとうございます. 対応したのでお手隙の際に、レビューお願いします.

@kazupon
Copy link
Member

kazupon commented Sep 27, 2020

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

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

@kazupon kazupon merged commit 9aac71b into vuejs-jp:lang-ja Sep 27, 2020
@konu96 konu96 deleted the translate-composition-api-template-refs branch September 27, 2020 13:17
@naokie naokie mentioned this pull request Apr 27, 2021
17 tasks
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 > Compotion API > Template Refs の翻訳
2 participants