From 9b7bf986863915ffdee5ec67a86616ddad9ce046 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Wed, 30 Jan 2019 20:19:57 +0900 Subject: [PATCH 01/11] docs(ja): update README.md --- docs/ja/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/README.md b/docs/ja/README.md index a43edf928..0e412e3f1 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -15,4 +15,4 @@ Vue Router は [Vue.js](http://vuejs.org) 公式ルータです。これは Vue. - HTML5 history モードまたは hash モードと IE9 の互換性 - カスタマイズ可能なスクロール動作 -[はじめに](./guide/) または [例](https://github.com/vuejs/vue-router/tree/dev/examples) から試してください。 ([`README.md`](https://github.com/vuejs/vue-router/)を参照してください。). +[ドキュメント](https://router.vuejs.org/ja/guide/)で始めるか、 [例](https://github.com/vuejs/vue-router/tree/dev/examples) から試してください。 ([`README.md`](https://github.com/vuejs/vue-router/)を参照してください。). From 10381eef8429c8b4f24025e5fc6f7c028ac5d08e Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Wed, 30 Jan 2019 20:23:07 +0900 Subject: [PATCH 02/11] docs(ja): update navigation.md ref: https://github.com/vuejs/vue-router/commit/6ba8682bae7c9270e855b7facd514fee9795743e --- docs/ja/guide/essentials/navigation.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/ja/guide/essentials/navigation.md b/docs/ja/guide/essentials/navigation.md index e1c9a69a5..997a9db29 100644 --- a/docs/ja/guide/essentials/navigation.md +++ b/docs/ja/guide/essentials/navigation.md @@ -25,21 +25,21 @@ router.push('home') router.push({ path: 'home' }) // 名前付きルート -router.push({ name: 'user', params: { userId: 123 }}) +router.push({ name: 'user', params: { userId: '123' } }) // 結果的に /register?plan=private になる query -router.push({ path: 'register', query: { plan: 'private' }}) +router.push({ path: 'register', query: { plan: 'private' } }) ``` **注意**: `params` は、上記例に示すように、`path` が提供されている場合は無視されます。これは `query` に対するケースとは異なります。 代わりに、ルートの `name` か任意のパラメータを付与した `path` 全体を手動で指定する必要があります: ```js -const userId = 123 -router.push({ name: 'user', params: { userId }}) // -> /user/123 +const userId = '123' +router.push({ name: 'user', params: { userId } }) // -> /user/123 router.push({ path: `/user/${userId}` }) // -> /user/123 // これは動作"しません" -router.push({ path: '/user', params: { userId }}) // -> /user +router.push({ path: '/user', params: { userId } }) // -> /user ``` 同じルールが、`router-link` コンポーネントの `to` プロパティに対して適用されます。 From 873f86851183a2db1e86973a825a2f6338764b64 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Wed, 30 Jan 2019 20:24:49 +0900 Subject: [PATCH 03/11] docs(ja): update dynamic-matching.md ref: https://github.com/vuejs/vue-router/commit/f4d186652f7d33169b8e6f2e66175432eef15e2f --- docs/ja/guide/essentials/dynamic-matching.md | 29 ++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 7e432b8b4..1681e14f8 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -65,6 +65,35 @@ const User = { } ``` +## Catch all / 404 Not found Route + +Regular params will only match characters in between url fragments, separated by `/`. If we want to match **anything**, we can use the asterisk (`*`): + +```js +{ + // will match everything + path: '*' +} +{ + // will match anything starting with `/user-` + path: '/user-*' +} +``` + +When using _asterisk_ routes, make sure to correctly order your routes so that _asterisk_ ones are at the end. +The route `{ path; '*' }` is usually used to 404 client side. If you are using _History mode_, make sure to [correctly configure your server](./history-mode.md) as well. + +When using an _asterisk_, a param named `pathMatch` is automatically added to `$route.params`. It contains the rest of the url matched by the _asterisk_: + +```js +// Given a route { path: '/user-*' } +this.$router.push('/user-admin') +this.$route.params.pathMatch // 'admin' +// Given a route { path: '*' } +this.$router.push('/non-existing') +this.$route.params.pathMatch // '/non-existing' +``` + ## 高度なマッチングパターン `vue-router` はパスのマッチングエンジンとして [path-to-regexp](https://github.com/pillarjs/path-to-regexp) を使っています。これは Optional による動的なセグメント、Zero or more / One or more に対する要求、また、カスタム正規表現パターンまでもサポートしています。 これらの高度なパターンについてはこちらの [ドキュメンテーション](https://github.com/pillarjs/path-to-regexp#parameters) または、 `vue-router` の中でそれらを使っている [こちらの例](https://github.com/vuejs/vue-router/blob/dev/examples/route-matching/app.js) をご参照ください。 From 7dde9063bf7e6dbd58dcdf707be288a2b03adf67 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Wed, 30 Jan 2019 23:47:24 +0900 Subject: [PATCH 04/11] docs(ja): translate previous commit --- docs/ja/guide/essentials/dynamic-matching.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 1681e14f8..3ef8c8589 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -67,29 +67,29 @@ const User = { ## Catch all / 404 Not found Route -Regular params will only match characters in between url fragments, separated by `/`. If we want to match **anything**, we can use the asterisk (`*`): +通常のパラメータは、`/` で区切られた url フラグメントの間にある文字だけにマッチします。**何でも**一致させたい場合は、アスタリスク(`*`)を使うことができます: ```js { - // will match everything + // 全てにマッチします path: '*' } { - // will match anything starting with `/user-` + // `/user-`から始まるもにマッチします path: '/user-*' } ``` -When using _asterisk_ routes, make sure to correctly order your routes so that _asterisk_ ones are at the end. -The route `{ path; '*' }` is usually used to 404 client side. If you are using _History mode_, make sure to [correctly configure your server](./history-mode.md) as well. +_アスタリスク_ ルートを使用するときは、_アスタリスク_ ルートが最後になるようにルートを正しく順序付けでください。 +`{ path: '*' }` ルートは、通常 404 クライアントサイドで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様に確認してください。 -When using an _asterisk_, a param named `pathMatch` is automatically added to `$route.params`. It contains the rest of the url matched by the _asterisk_: +_アスタリスク_ を使用するときは、 `pathMatch` と名付けられたパラメータは、自動的に `$route.params` に追加されます。_アスタリスク_ によってマッチされた url の残りを含みます: ```js -// Given a route { path: '/user-*' } +// 与えられた { path: '/user-*' } ルート this.$router.push('/user-admin') this.$route.params.pathMatch // 'admin' -// Given a route { path: '*' } +// 与えられた { path: '*' } ルート this.$router.push('/non-existing') this.$route.params.pathMatch // '/non-existing' ``` From 54f07e64660791f8638b929ed73fa1ecda2b2f50 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Wed, 30 Jan 2019 23:49:17 +0900 Subject: [PATCH 05/11] docs(ja): update navitation-guard.md --- docs/ja/guide/advanced/navigation-guards.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/guide/advanced/navigation-guards.md b/docs/ja/guide/advanced/navigation-guards.md index 7a1384e70..90cb4f54c 100644 --- a/docs/ja/guide/advanced/navigation-guards.md +++ b/docs/ja/guide/advanced/navigation-guards.md @@ -4,7 +4,7 @@ **パラメータまたはクエリの変更は enter/leave ナビゲーションガードをトリガーしない** ということを覚えておいてください。それらの変更に対応するために [`$route` オブジェクトを監視する](../essentials/dynamic-matching.md#reacting-to-params-changes)、またはコンポーネント内ガード `beforeRouteUpdate` を使用するかの、どちらかができます。 -## グローバルガード +## グローバルビフォーガード `router.beforeEach` を使ってグローバル before ガードを登録できます。 From c2a0868ab479a2283504bedb1ac94b30fa2baec6 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Thu, 31 Jan 2019 23:37:19 +0900 Subject: [PATCH 06/11] Revert "docs(ja): update README.md" This reverts commit 9b7bf986863915ffdee5ec67a86616ddad9ce046. --- docs/ja/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/README.md b/docs/ja/README.md index 0e412e3f1..a43edf928 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -15,4 +15,4 @@ Vue Router は [Vue.js](http://vuejs.org) 公式ルータです。これは Vue. - HTML5 history モードまたは hash モードと IE9 の互換性 - カスタマイズ可能なスクロール動作 -[ドキュメント](https://router.vuejs.org/ja/guide/)で始めるか、 [例](https://github.com/vuejs/vue-router/tree/dev/examples) から試してください。 ([`README.md`](https://github.com/vuejs/vue-router/)を参照してください。). +[はじめに](./guide/) または [例](https://github.com/vuejs/vue-router/tree/dev/examples) から試してください。 ([`README.md`](https://github.com/vuejs/vue-router/)を参照してください。). From cff46b480641564554b7c1b19b272e800b6c7c10 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Thu, 31 Jan 2019 23:38:09 +0900 Subject: [PATCH 07/11] docs(ja): fix typo ref: https://github.com/vuejs/vue-router/pull/2602#discussion_r252667917 ref: https://github.com/vuejs/vue-router/pull/2602#discussion_r252668048 --- docs/ja/guide/essentials/dynamic-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 3ef8c8589..a28efbb53 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -75,7 +75,7 @@ const User = { path: '*' } { - // `/user-`から始まるもにマッチします + // `/user-`から始まる任意のものにマッチします path: '/user-*' } ``` From f780850f0984f67665475a65b776cb4f4fbf92e8 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Thu, 31 Jan 2019 23:42:01 +0900 Subject: [PATCH 08/11] docs(ja): fix typo ref: https://github.com/vuejs/vue-router/pull/2602#discussion_r252668164 --- docs/ja/guide/essentials/dynamic-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index a28efbb53..771c2f253 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -80,7 +80,7 @@ const User = { } ``` -_アスタリスク_ ルートを使用するときは、_アスタリスク_ ルートが最後になるようにルートを正しく順序付けでください。 +_アスタリスク_ ルートを使用するときは、_アスタリスク_ ルートが最後になるようにルートを正しく順序付けてください。 `{ path: '*' }` ルートは、通常 404 クライアントサイドで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様に確認してください。 _アスタリスク_ を使用するときは、 `pathMatch` と名付けられたパラメータは、自動的に `$route.params` に追加されます。_アスタリスク_ によってマッチされた url の残りを含みます: From f0e26bc951defec5a8ebd5334572dc22a6ae2af9 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Thu, 31 Jan 2019 23:44:53 +0900 Subject: [PATCH 09/11] docs(ja): improve translate of --- docs/ja/guide/essentials/dynamic-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 771c2f253..387e8483f 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -81,7 +81,7 @@ const User = { ``` _アスタリスク_ ルートを使用するときは、_アスタリスク_ ルートが最後になるようにルートを正しく順序付けてください。 -`{ path: '*' }` ルートは、通常 404 クライアントサイドで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様に確認してください。 +`{ path: '*' }` ルートは、通常クライアントサイドの404ページで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様に確認してください。 _アスタリスク_ を使用するときは、 `pathMatch` と名付けられたパラメータは、自動的に `$route.params` に追加されます。_アスタリスク_ によってマッチされた url の残りを含みます: From aec97f3a96b21d2db5017ab1386448208f4283d1 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Thu, 31 Jan 2019 23:47:59 +0900 Subject: [PATCH 10/11] docs(ja): improve translation of --- docs/ja/guide/essentials/dynamic-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 387e8483f..1087cffcd 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -81,7 +81,7 @@ const User = { ``` _アスタリスク_ ルートを使用するときは、_アスタリスク_ ルートが最後になるようにルートを正しく順序付けてください。 -`{ path: '*' }` ルートは、通常クライアントサイドの404ページで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様に確認してください。 +`{ path: '*' }` ルートは、通常クライアントサイドの404ページで使われます。_History モード_ を使用する場合は、[正しいサーバの設定](./history-mode.md)も同様にしっかりしてください。 _アスタリスク_ を使用するときは、 `pathMatch` と名付けられたパラメータは、自動的に `$route.params` に追加されます。_アスタリスク_ によってマッチされた url の残りを含みます: From dbe53cbd1f6572b79ec61cceef8d18f5bc4a9053 Mon Sep 17 00:00:00 2001 From: kazuya kawaguchi Date: Fri, 1 Feb 2019 00:06:12 +0900 Subject: [PATCH 11/11] docs(ja): update ref: https://github.com/vuejs/vue-router/pull/2602#discussion_r252669084 ref: https://github.com/vuejs/vue-router/pull/2602#discussion_r252669199 --- docs/ja/guide/essentials/dynamic-matching.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ja/guide/essentials/dynamic-matching.md b/docs/ja/guide/essentials/dynamic-matching.md index 1087cffcd..2a1658fbe 100644 --- a/docs/ja/guide/essentials/dynamic-matching.md +++ b/docs/ja/guide/essentials/dynamic-matching.md @@ -65,7 +65,7 @@ const User = { } ``` -## Catch all / 404 Not found Route +## すべてキャッチするルート / 404 Not found ルート 通常のパラメータは、`/` で区切られた url フラグメントの間にある文字だけにマッチします。**何でも**一致させたい場合は、アスタリスク(`*`)を使うことができます: @@ -86,10 +86,10 @@ _アスタリスク_ ルートを使用するときは、_アスタリスク_ _アスタリスク_ を使用するときは、 `pathMatch` と名付けられたパラメータは、自動的に `$route.params` に追加されます。_アスタリスク_ によってマッチされた url の残りを含みます: ```js -// 与えられた { path: '/user-*' } ルート +// { path: '/user-*' } というルートが与えられた this.$router.push('/user-admin') this.$route.params.pathMatch // 'admin' -// 与えられた { path: '*' } ルート +// { path: '*' } というルートが与えられた this.$router.push('/non-existing') this.$route.params.pathMatch // '/non-existing' ```