From: Eduardo San Martin Morote <posva13@gmail.com>
Date: Wed, 2 Sep 2020 16:09:35 +0000 (+0200)
Subject: docs: adapt watch usage [skip ci]
X-Git-Tag: v4.0.0-beta.10~70
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5621d808658a607e1936dd0de4c64a0fad40ca67;p=thirdparty%2Fvuejs%2Frouter.git

docs: adapt watch usage [skip ci]
---

diff --git a/docs/guide/advanced/data-fetching.md b/docs/guide/advanced/data-fetching.md
index def9f1df..8a3882d1 100644
--- a/docs/guide/advanced/data-fetching.md
+++ b/docs/guide/advanced/data-fetching.md
@@ -39,13 +39,16 @@ export default {
     }
   },
   created() {
-    // fetch the data when the view is created and the data is
-    // already being observed
-    this.fetchData()
-  },
-  watch: {
-    // call again the method if the route changes
-    $route: 'fetchData',
+    // watch the params of the route to fetch the data again
+    this.$watch(
+      () => this.$route.params,
+      () => {
+        this.fetchData()
+      },
+      // fetch the data when the view is created and the data is
+      // already being observed
+      { immediate: true }
+    )
   },
   methods: {
     fetchData() {
diff --git a/docs/guide/essentials/dynamic-matching.md b/docs/guide/essentials/dynamic-matching.md
index bd65d39d..f99edfda 100644
--- a/docs/guide/essentials/dynamic-matching.md
+++ b/docs/guide/essentials/dynamic-matching.md
@@ -4,13 +4,13 @@ Very often we will need to map routes with the given pattern to the same compone
 
 ```js
 const User = {
-  template: '<div>User</div>'
+  template: '<div>User</div>',
 }
 
 // these are passed to `createRouter`
 const routes = [
   // dynamic segments start with a colon
-  { path: '/user/:id', component: User }
+  { path: '/user/:id', component: User },
 ]
 ```
 
@@ -20,7 +20,7 @@ A _param_ is denoted by a colon `:`. When a route is matched, the value of its _
 
 ```js
 const User = {
-  template: '<div>User {{ $route.params.id }}</div>'
+  template: '<div>User {{ $route.params.id }}</div>',
 }
 ```
 
@@ -41,16 +41,19 @@ In addition to `$route.params`, the `$route` object also exposes other useful in
 
 One thing to note when using routes with params is that when the user navigates from `/user/johnny` to `/user/jolyne`, **the same component instance will be reused**. Since both routes render the same component, this is more efficient than destroying the old instance and then creating a new one. **However, this also means that the lifecycle hooks of the component will not be called**.
 
-To react to params changes in the same component, you can simply watch the `$route` object:
+To react to params changes in the same component, you can simply watch anything on the `$route` object, in this scenario, the `$route.params`:
 
 ```js
 const User = {
   template: '...',
-  watch: {
-    $route(to, from) {
-      // react to route changes...
-    }
-  }
+  created() {
+    this.$watch(
+      () => this.$route.params,
+      (toParams, previousParams) => {
+        // react to route changes...
+      }
+    )
+  },
 }
 ```
 
@@ -59,10 +62,10 @@ Or, use the `beforeRouteUpdate` [navigation guard](../advanced/navigation-guards
 ```js
 const User = {
   template: '...',
-  beforeRouteUpdate(to, from, next) {
+  async beforeRouteUpdate(to, from) {
     // react to route changes...
-    // don't forget to call next()
-  }
+    this.userData = await fetchUser(to.params.id)
+  },
 }
 ```