update japanese docs (#1124)

kazupon · web-flow · commit 18381f576206 · 2017-01-30T11:14:41.000+09:00
* update navigation guards section NOTE: pick up from the bellows - 94e6b89 - f7e3b60 * title singularization * update route matching * add passing props section NOTE: pick up from 2288d83 * add new API NOTE: pick from 6ce0ff7 * add beforeRouteUpdate NOTE: pick up from f5e9fcf * add router.onReady NOTE: pick up from 03928bd * update docs NOTE: pick up from b5ce47f * update summary titles
diff --git a/docs/ja/SUMMARY.md b/docs/ja/SUMMARY.md
@@ -13,6 +13,7 @@
   - [名前付きルート](essentials/named-routes.md)
   - [名前付きビュー](essentials/named-views.md)
   - [リダイレクトとエイリアス](essentials/redirect-and-alias.md)
+  - [ルートコンポーネントにプロパティを渡す](essentials/passing-props.md)
   - [HTML5 History モード](essentials/history-mode.md)
 - 高度な使い方
   - [ナビゲーションガード](advanced/navigation-guards.md)
@@ -25,6 +26,6 @@
   - [router-link](api/router-link.md)
   - [router-view](api/router-view.md)
   - [ルートオブジェクト](api/route-object.md)
-  - [ルートコンストラクタオプション](api/options.md)
-  - [ルートインスタンス](api/router-instance.md)
+  - [ルーターコンストラクタオプション](api/options.md)
+  - [ルーターインスタンス](api/router-instance.md)
   - [コンポーネント注入](api/component-injections.md)
diff --git a/docs/ja/advanced/navigation-guards.md b/docs/ja/advanced/navigation-guards.md
@@ -2,6 +2,8 @@
 
 この名前が示すように、 `vue-router` によって提供されるナビゲーションガードは、リダイレクトもしくはキャンセルによって遷移をガードするために主に使用されます。ルートナビゲーション処理 (グローバル、ルート単位、コンポーネント内) をフックする多くの方法があります。
 
+**パラメータまたはクエリの変更はナビゲーションガードをトリガーしない** ということを覚えておいてください。単純にそれらの変更を対応するために [`$route` オブジェクトを監視します](../essentials/dynamic-matching.md#reacting-to-params-changes)。
+
 ### グローバルガード
 
 `router.beforeEach` を使ってグローバル before ガードを登録できます。
@@ -60,7 +62,11 @@ const router = new VueRouter({
 
 ### コンポーネント内ガード
 
-最後に、 `beforeRouteEnter` と `beforeRouteLeave` を使ってルートコンポーネント内側でルートナビゲーションガードを直接定義することができます。
+最後に、 以下のオプションでルートコンポーネント(ルータ設定に渡されるもの)の内側でルートナビゲーションガードを直接定義することができます。
+
+- `beforeRouteEnter`
+- `beforeRouteUpdate` (2.2 で追加)
+- `beforeRouteLeave`
 
 ``` js
 const Foo = {
@@ -70,6 +76,13 @@ const Foo = {
     // `this` でのこのコンポーネントへのアクセスはできません。
     // なぜならばこのガードが呼び出される時にまだ作られていないからです!
   },
+  beforeRouteUpdate (to, from, next) {
+    // このコンポーネントを描画するルートが変更されたときに呼び出されますが、
+    // このコンポーネントは新しいルートで再利用されます。
+    // たとえば、動的な引数 /foo/:id を持つルートの場合、/foo/1 と /foo/2 の間を移動すると、
+    // 同じ Foo コンポーネントインスタンスが再利用され、そのときにこのフックが呼び出されます。
+    // `this` でコンポーネントインスタンスにアクセスできます。
+  },
   beforeRouteLeave (to, from, next) {
     // このコンポーネントをレンダリングするルートが間もなく
     // ナビゲーションから離れていく時に呼ばれます。
diff --git a/docs/ja/api/options.md b/docs/ja/api/options.md
@@ -1,4 +1,4 @@
-# ルートコンストラクタオプション
+# ルーターコンストラクタオプション
 
 ### routes
 
diff --git a/docs/ja/api/router-instance.md b/docs/ja/api/router-instance.md
@@ -28,8 +28,8 @@
   グローバルなナビゲーションガードの追加。[ナビゲーションガード](../advanced/navigation-guards.md) をご参照ください。
 
 
-- **router.push(location)**
-- **router.replace(location)**
+- **router.push(location, onComplete?, onAbort?)**
+- **router.replace(location, onComplete?, onAbort?)**
 - **router.go(n)**
 - **router.back()**
 - **router.forward()**
@@ -53,3 +53,17 @@
     href: string;
   }
   ```
+
+- **router.addRoute(routes)**
+
+  > 2.2.0+
+
+  動的にルートをルーターに追加します。引数は `routes` コンストラクタオプションで同じルート設定形式を使用する配列でなければなりません。
+
+- **router.onReady(callback)**
+
+  > 2.2.0+
+
+  このメソッドは、ルーターが初期ナビゲーションを完了したときに呼び出されるコールバックをキューに入れます。つまり、初期ルートに関連付けられているすべての非同期 enter フックと非同期コンポーネントを解決したことを意味します。
+
+  これは、サーバーとクライアントの両方で一貫した出力を保証するために、サーバーサイドレンダリングに役立ちます。
diff --git a/docs/ja/api/router-link.md b/docs/ja/api/router-link.md
@@ -94,7 +94,7 @@
 
   - デフォルト: `false`
 
-  デフォルトのアクティブクラスのマッチングの振る舞いは **包含的なマッチ** です。 例えば、現在のパスが `/a` から始まる間は、`<router-link to="/a">` にアクティブクラスが適用されます。
+  デフォルトのアクティブクラスのマッチングの振る舞いは **包含的なマッチ** です。 例えば、現在のパスが `/a/` または `/a` から始まる限りは、`<router-link to="/a">` にアクティブクラスが適用されます。
 
   この結果として `<router-link to="/">` は全てのルートに対してアクティブになります! リンクに対して "正確なマッチモード" を強制するために、 `exact` プロパティを使ってください。
 
@@ -105,7 +105,7 @@
 
   アクティブリンククラスをより説明している例としてこちらの [動作](https://jsfiddle.net/8xrk1n9f/) を確認してください。
 
-- **events**
+- **event**
 
   > 2.1.0+
 
diff --git a/docs/ja/essentials/navigation.md b/docs/ja/essentials/navigation.md
@@ -2,7 +2,7 @@
 
 宣言的なナビゲーションとしてアンカータグを作成する `<router-link>` がありますが、ルーターのインスタンスメソッドを使ったプログラムによる方法でもそれは可能です。
 
-#### `router.push(location)`
+#### `router.push(location, onComplete?, onAbort?)`
 
 異なる URL へ遷移するときに `router.push` が使えます。このメソッドは history スタックに新しいエントリを追加します。それによってユーザーがブラウザの戻るボタンをクリックした時に前の URL に戻れるようになります。
 
@@ -29,7 +29,9 @@ router.push({ name: 'user', params: { userId: 123 }})
 router.push({ path: 'register', query: { plan: 'private' }})
 ```
 
-#### `router.replace(location)`
+2.2.0 以降では、必要に応じて、第 2 引数と第 3 引数として `router.push` または `router.replace` に `onComplete` と `onAbort` コールバックを指定します。これらのコールバックは、ナビゲーションが正常に完了したとき(すべての非同期フックが解決された後)に呼び出されるか、またはそれぞれ中止されます(現在のナビゲーションが終了する前に同じルートまたは別のルートにナビゲートされた)
+
+#### `router.replace(location, onComplete?, onAbort?)`
 
 これは `router.push` のように動作しますが、異なる点は新しい history エントリを追加しないで遷移することです。この名前から推定されるように、現在のエントリを置換します。
 
diff --git a/docs/ja/essentials/passing-props.md b/docs/ja/essentials/passing-props.md
@@ -0,0 +1,71 @@
+# ルートコンポーネントにプロパティを渡す
+
+コンポーネントで `$route` を使うと特定のURLでしか使用できないコンポーネントの柔軟性が制限されるルートで密結合を作り出します。
+
+このコンポーネントをルーターが使用するプロパティからこのコンポーネントを分離するには:
+
+**❌ $route に結合**
+
+``` js
+const User = {
+  template: '<div>User {{ $route.params.id }}</div>'
+}
+const router = new VueRouter({
+  routes: [
+    { path: '/user/:id', component: User }
+  ]
+})
+```
+
+**👍 プロパティによる分離**
+
+``` js
+const User = {
+  props: ['id'],
+  template: '<div>User {{ id }}</div>'
+}
+const router = new VueRouter({
+  routes: [
+    { path: '/user/:id', component: User, props: true }
+  ]
+})
+```
+
+これにより、コンポーネントをどこからでも使用できるようになり、コンポーネントの再利用とテストが容易になります。
+
+### Boolean モード
+
+props を true に設定すると、route.params がコンポーネントのプロパティとして設定されます。
+
+### Object モード
+
+props がオブジェクトの場合、これはコンポーネントプロパティとしてそのまま設定されます。
+プロパティが静的なときに便利です。
+
+``` js
+const router = new VueRouter({
+  routes: [
+    { path: '/promotion/from-newsletter', component: Promotion, props: { newsletterPopup: false } }
+  ]
+})
+```
+
+### Function モード
+
+プロパティを返す関数を作成することができます。
+これにより、パラメータを別のタイプにキャストし、静的な値をルートベースの値などと組み合わせることができます。
+
+``` js
+const router = new VueRouter({
+  routes: [
+    { path: '/search', component: SearchUser, props: (route) => ({ query: route.query.q }) }
+  ]
+})
+```
+
+url `/search?q=vue` は `{query: "vue"}` をプロパティとして SearchUser コンポーネントに渡します。
+
+ルート変更時にのみ評価されるため、プロパティの機能はステートレスにしてください。
+ラッパーコンポーネントを使用すると、状態を変更して状態を変更することができます。
+
+高度な使い方については、[example](https://github.com/vuejs/vue-router/blob/dev/examples/route-props/app.js)を参照してください。

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# ルートコンストラクタオプション`
	`1`	`+# ルーターコンストラクタオプション`
`2`	`2`
`3`	`3`	`### routes`
`4`	`4`