docs: suggest using <NuxtPage> rather than <RouterView> (#25106)

nuxt · Jan 9, 2024 · 4168157 · 4168157
1 parent 3d368c9
commit 4168157
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/3.api/1.components/2.nuxt-page.md b/docs/3.api/1.components/2.nuxt-page.md
@@ -15,6 +15,10 @@ links:
 It accepts same `name` and `route` props.
 ::
 
+::callout{color="amber" icon="i-ph-warning-duotone"}
+`<NuxtPage>` should be used instead of `<RouterView>` as the former takes additional care on internal states. Otherwise, `useRoute()` may return incorrect paths.
+::
+
 ## Props
 
 - `name`: tells `RouterView` to render the component with the corresponding name in the matched route record's components option.