diff --git a/docs/ja/advanced/navigation-guards.md b/docs/ja/advanced/navigation-guards.md index 2196c705e..9fe7aaf86 100644 --- a/docs/ja/advanced/navigation-guards.md +++ b/docs/ja/advanced/navigation-guards.md @@ -20,17 +20,19 @@ router.beforeEach((to, from, next) => { 全てのガード関数は 3 つの引数を受け取ります。 -- **`to: Route`**: 次にナビゲーションされる対象の [ルートオブジェクト](../api/route-object.md)。 - -- **`from: Route`**: ナビゲーションされる前の現在のルートです。 - -- **`next: Function`**: フックを **解決** するためにこの関数を呼ぶ必要があります。この振る舞いは `next` に渡される引数に依存します: + - **`to: Route`**: 次にナビゲーションされる対象の [ルートオブジェクト](../api/route-object.md)。 + + - **`from: Route`**: ナビゲーションされる前の現在のルートです。 + + - **`next: Function`**: フックを **解決** するためにこの関数を呼ぶ必要があります。この振る舞いは `next` に渡される引数に依存します: - **`next()`**: パイプラインの次のフックに移動します。もしフックが残っていない場合は、このナビゲーションは **確立** されます。 - **`next(false)`**: 現在のナビゲーションを中止します。もしブラウザのURLが変化した場合は(ユーザーが手動で変更した場合でも、戻るボタンの場合でも)、 `from` ルートのURLにリセットされます。 - - **`next('/')` or `next({ path: '/' })`**: 異なる場所へリダイレクトします。現在のナビゲーションは中止され、あたらしいナビゲーションが始まります。 + - **`next('/')` または `next({ path: '/' })`**: 異なる場所へリダイレクトします。現在のナビゲーションは中止され、あたらしいナビゲーションが始まります。 + + - **`next(error)`**: (2.4.0+) `next` に渡された引数が `Error` インスタンスである場合、ナビゲーションは中止され、エラーは `router.onError()` を介して登録されたコールバックに渡されます。 グローバル after フックを登録することもできます。しかしながら、ガードとは異なり、これらのフックは `next` 関数を受け取らず、ナビゲーションに影響しません。 diff --git a/docs/ja/api/component-injections.md b/docs/ja/api/component-injections.md index b1dc4f20e..b15482024 100644 --- a/docs/ja/api/component-injections.md +++ b/docs/ja/api/component-injections.md @@ -12,9 +12,10 @@ 現在のアクティブな [ルート](route-object.md) 。このプロパティは読み出しのみ可能かつ変更不可ですが、watch は可能です。 -### Enabled Options +### 有効になるオプション - **beforeRouteEnter** +- **beforeRouteUpdate** (2.2 で追加) - **beforeRouteLeave** [コンポーネント内ガード](../advanced/navigation-guards.md#incomponent-guards) をご参照ください。 diff --git a/docs/ja/api/options.md b/docs/ja/api/options.md index 8ed64ea38..56591043f 100644 --- a/docs/ja/api/options.md +++ b/docs/ja/api/options.md @@ -67,3 +67,11 @@ ``` より詳細ついては [スクロールの振る舞い](../advanced/scroll-behavior.md) をご参照ください。 + +### parseQuery / stringifyQuery + +> 2.4.0+ + +- 型: `Function` + + カスタムクエリ構文解析関数 / 文字列化関数を提供します。デフォルトを上書きします。 diff --git a/docs/ja/api/router-instance.md b/docs/ja/api/router-instance.md index 84e37c1bd..02ace70f8 100644 --- a/docs/ja/api/router-instance.md +++ b/docs/ja/api/router-instance.md @@ -60,10 +60,24 @@ 動的にルートをルーターに追加します。引数は `routes` コンストラクタオプションで同じルート設定形式を使用する配列でなければなりません。 -- **router.onReady(callback)** +- **router.onReady(callback, [errorCallback])** > 2.2.0+ このメソッドは、ルーターが初期ナビゲーションを完了したときに呼び出されるコールバックをキューに入れます。つまり、初期ルートに関連付けられているすべての非同期 enter フックと非同期コンポーネントを解決したことを意味します。 これは、サーバーとクライアントの両方で一貫した出力を保証するために、サーバーサイドレンダリングに役立ちます。 + + 第 2 引数 `errorCallback` は 2.4 以降でのみサポートされます。初期ルート解決がエラーの時に、呼び出されます (例: 非同期コンポーネントの解決が失敗)。 + +- **router.onError(callback)** + + > 2.4.0+ + + ルートナビゲーション中にエラーが検出されたときに呼び出されるコールバックを登録します。エラーを呼び出すには、次のいずれかのシナリオが必要であることに注意してください: + + - エラーがルートガード関数内で同期的に投げられる; + + - エラーが補足され、ルートガード関数内で `next(err)` を呼び出すことによって非同期に処理される; + + - ルートを描画するために必須な非同期コンポーネントを解決しようとする時に発生したエラー; diff --git a/docs/ja/essentials/navigation.md b/docs/ja/essentials/navigation.md index 82745ca81..7c69d94b2 100644 --- a/docs/ja/essentials/navigation.md +++ b/docs/ja/essentials/navigation.md @@ -4,6 +4,8 @@ #### `router.push(location, onComplete?, onAbort?)` +**注意: Vue インスタンスの内部では、`$router` としてルーターインスタンスにアクセスできます。従って、`this.$router.push` で呼ぶことができます。** + 異なる URL へ遷移するときに `router.push` が使えます。このメソッドは history スタックに新しいエントリを追加します。それによってユーザーがブラウザの戻るボタンをクリックした時に前の URL に戻れるようになります。 @@ -16,7 +18,7 @@ 引数は文字列のパス、もしくは、location を記述するオブジェクトが使えます。例: ``` js -// 文字列 +// 文字列パス router.push('home') // オブジェクト