vuejs · superyusuke · superyusuke · superyusuke · Dec 31, 2018 · pr-triage
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
-There are situations when you want the template inside the slot to be able to access data from the child component that is responsible for rendering the slot content. This is particularly useful when you need freedom in creating custom templates that use the child component's data properties. That is a typical use case for scoped slots.
+> Base Example
+
+slot 内の template が、slot の content をレンダリングをする役割を持った子コンポーネントの側の「データ」へ、アクセスできたらいいのに、と思うことはないでしょうか。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
+
+> There are situations when you want the template inside the slot to be able to access data from the child component that is responsible for rendering the slot content. 
+
+とくにそれが有効なのは、子コンポーネントの data プロパティを使用するカスタム template を作成する必要がある場合です。まさに `scoped slots` を使用するのに最適な場面です。  
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
+
+> This is particularly useful when you need freedom in creating custom templates that use the child component's data properties. That is a typical use case for scoped slots.
+
+外部 API の設定と使用準備をするコンポーネントを実装する場合を想定してみましょう。そのコンポーネントは、他のコンポーネントから使用されるわけですが、具体的な template と密接には結びついません。そのためレンダリングする template が異なる様々な場所で使いまわすことができ、それでいて特定の API を持つ同じベースオブジェクトを使用します。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
+
+1.  [Google Maps API](https://developers.google.com/maps/documentation/javascript/reference/) を初期化する。
+2. `google` と `map` の2つの object を作成する。
+3. これら2つの object を `GoogleMapLoader` を使用する親コンポーネントに対して露出させている。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md

 `GoogleMapLoader.vue`

-In the template, we create a container for the map which will be used to mount the [Map](https://developers.google.com/maps/documentation/javascript/reference/map#Map) object extracted from the Google Maps API.
+template の中にマップのためのコンテナを作成しましょう。このコンテナへ Google Maps API から抽出した [Map](https://developers.google.com/maps/documentation/javascript/reference/map#Map) がマウントされます。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
@@ -337,7 +438,9 @@ Here we go, integrating the data points directly into the template:
 </GoogleMapLoader>
 ```

-We need to import the required factory components in our script and set the data that will be passed to the markers and lines:
+それから script の中で、factory component を script の中でインポートし、marker と lines という名前でコンポーネントに値をセットします。
-それから script の中で、factory component を script の中でインポートし、marker と lines という名前でコンポーネントに値をセットします。
+それから script の中で、ファクトリーコンポーネントを script の中でインポートし、marker と lines という名前でコンポーネントに値をセットします。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
@@ -379,9 +482,18 @@ export default {
 ```

 ## When To Avoid This Pattern
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md

-## Wrapping Up
-That's it. With all those bits and pieces created we can now re-use the `GoogleMapLoader` component as a base for all our maps by passing different templates to each one of them. Imagine that you need to create another map with different Markers or just Markers without Polylines. By using the above pattern it becomes very easy as we just need to pass different content to the `GoogleMapLoader` component.
+このような非常に複雑な解決法は魅力的に思われるかもしれませんが、ある一定のレベルまでその複雑さが進んでしまうと、その抽象性が、この機能を構成する他のコードの部分よりもかなり高くなってしまい、浮いた存在になってしまうでしょう。その段階にまできた場合には、add-on に抽出することを検討する段階でしょう。(訳注: add-on はおそらく、plugin や mixin などのことです)
-このような非常に複雑な解決法は魅力的に思われるかもしれませんが、ある一定のレベルまでその複雑さが進んでしまうと、その抽象性が、この機能を構成する他のコードの部分よりもかなり高くなってしまい、浮いた存在になってしまうでしょう。その段階にまできた場合には、add-on に抽出することを検討する段階でしょう。(訳注: add-on はおそらく、plugin や mixin などのことです)
+このような非常に複雑な解決法は魅力的に思われるかもしれませんが、ある一定のレベルまでその複雑さが進んでしまうと、その抽象性が、この機能を構成する他のコードの部分よりもかなり高くなってしまい、浮いた存在になってしまうでしょう。その段階にまできた場合には、プラグインやミックスインのようなアドオンとして抽出することを検討する段階でしょう。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
+## まとめ
+> Wrapping Up
+ 
+さあ全てやりとげました。こまごまと作業をしてきた結果として `GoogleMapLoader` コンポーネントを、マップを使う際のベースとして使いまわすことができるようになりました。それぞれの用途に合わせた template を渡せばこのコンポーネントに渡せば、どんなものにでも対応できます。例えば今回のケースとは異なるマーカーや、ポリラインがない場合にも使えますね。今回紹介したパターンを使うことで `GoogleMapLoader` にケースによってことなる必要なコンテンツを渡すだけで、この目的を達成できます。
-さあ全てやりとげました。こまごまと作業をしてきた結果として `GoogleMapLoader` コンポーネントを、マップを使う際のベースとして使いまわすことができるようになりました。それぞれの用途に合わせた template を渡せばこのコンポーネントに渡せば、どんなものにでも対応できます。例えば今回のケースとは異なるマーカーや、ポリラインがない場合にも使えますね。今回紹介したパターンを使うことで `GoogleMapLoader` にケースによってことなる必要なコンテンツを渡すだけで、この目的を達成できます。
+以上です。こまごまと作業をしてきた結果として `GoogleMapLoader` コンポーネントを、マップを使う際のベースとして使いまわすことができるようになりました。それぞれの用途に合わせたテンプレートをこのコンポーネントに渡せば、どんなものにでも対応できます。例えば今回のケースとは異なるマーカーや、ポリラインがない場合にも使えます。今回紹介したパターンを使うことで `GoogleMapLoader` にケースによってことなる必要なコンテンツを渡すだけで、この目的を達成できます。
diff --git a/src/v2/cookbook/practical-use-of-scoped-slots.md b/src/v2/cookbook/practical-use-of-scoped-slots.md
+
+> That's it. With all those bits and pieces created we can now re-use the `GoogleMapLoader` component as a base for all our maps by passing different templates to each one of them. Imagine that you need to create another map with different Markers or just Markers without Polylines. By using the above pattern it becomes very easy as we just need to pass different content to the `GoogleMapLoader` component.
+
+このパターンは Google Map の場合にしか使えないわけではありません。どんなライブラリの場合にも、ベースとなるコンポーネントをセットして、(ベースコンポーネントを呼び出したコンポーネントが実行する) API を露出させればいいのです。
-このパターンは Google Map の場合にしか使えないわけではありません。どんなライブラリの場合にも、ベースとなるコンポーネントをセットして、(ベースコンポーネントを呼び出したコンポーネントが実行する) API を露出させればいいのです。
+このパターンは Google Map の場合にしか使えないわけではありません。どんなライブラリの場合にも、ベースとなるコンポーネントをセットして、(ベースコンポーネントを呼び出したコンポーネントが実行する) API を公開させればいいのです。

		> There are situations when you want the template inside the slot to be able to access data from the child component that is responsible for rendering the slot content.

		とくにそれが有効なのは、子コンポーネントの data プロパティを使用するカスタム template を作成する必要がある場合です。まさに `scoped slots` を使用するのに最適な場面です。

		> This is particularly useful when you need freedom in creating custom templates that use the child component's data properties. That is a typical use case for scoped slots.

		外部 API の設定と使用準備をするコンポーネントを実装する場合を想定してみましょう。そのコンポーネントは、他のコンポーネントから使用されるわけですが、具体的な template と密接には結びついません。そのためレンダリングする template が異なる様々な場所で使いまわすことができ、それでいて特定の API を持つ同じベースオブジェクトを使用します。
	それから script の中で、factory component を script の中でインポートし、marker と lines という名前でコンポーネントに値をセットします。
	それから script の中で、ファクトリーコンポーネントを script の中でインポートし、marker と lines という名前でコンポーネントに値をセットします。
		@@ -379,9 +482,18 @@ export default {
		```

		## When To Avoid This Pattern

		> That's it. With all those bits and pieces created we can now re-use the `GoogleMapLoader` component as a base for all our maps by passing different templates to each one of them. Imagine that you need to create another map with different Markers or just Markers without Polylines. By using the above pattern it becomes very easy as we just need to pass different content to the `GoogleMapLoader` component.

		このパターンは Google Map の場合にしか使えないわけではありません。どんなライブラリの場合にも、ベースとなるコンポーネントをセットして、(ベースコンポーネントを呼び出したコンポーネントが実行する) API を露出させればいいのです。