diff --git a/docs/api/nav.md b/docs/api/nav.md index 7a5d975232f..58123c14c3f 100644 --- a/docs/api/nav.md +++ b/docs/api/nav.md @@ -19,7 +19,11 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill'; Nav is a standalone component for loading arbitrary components and pushing new components on to the stack. -Unlike Router Outlet, Nav is not tied to a particular router. This means that if we load a Nav component, and push other components to the stack, they will not affect the app's overall router. This fits use cases where you could have a modal, which needs its own sub-navigation, without making it tied to the apps URL. +Unlike Router Outlet, Nav is not tied to a particular router. This means that if we load a Nav component, and push other components to the stack, they will not affect the app's overall router. For example, you should not push a new component to `ion-nav` and expect the URL to update. This fits use cases where you could have a modal, which needs its own sub-navigation, without making it tied to the apps URL. + +:::note +`ion-nav` is not meant to be used for routing. Instead, see the routing guides for [Angular](../angular/navigation), [React](../react/navigation), and [Vue](../vue/navigation), or [`ion-router`](./router) for vanilla JavaScript projects. +::: ## Using NavLink diff --git a/versioned_docs/version-v6/api/nav.md b/versioned_docs/version-v6/api/nav.md index 330f38561c4..a59ce7d562a 100644 --- a/versioned_docs/version-v6/api/nav.md +++ b/versioned_docs/version-v6/api/nav.md @@ -23,7 +23,11 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill'; Nav is a standalone component for loading arbitrary components and pushing new components on to the stack. -Unlike Router Outlet, Nav is not tied to a particular router. This means that if we load a Nav component, and push other components to the stack, they will not affect the app's overall router. This fits use cases where you could have a modal, which needs its own sub-navigation, without making it tied to the apps URL. +Unlike Router Outlet, Nav is not tied to a particular router. This means that if we load a Nav component, and push other components to the stack, they will not affect the app's overall router. For example, you should not push a new component to `ion-nav` and expect the URL to update. This fits use cases where you could have a modal, which needs its own sub-navigation, without making it tied to the apps URL. + +:::note +`ion-nav` is not meant to be used for routing. Instead, see the routing guides for [Angular](../angular/navigation), [React](../react/navigation), and [Vue](../vue/navigation), or [`ion-router`](./router) for vanilla JavaScript projects. +::: ## Using NavLink