ionic-team / ionic-team/ionic-docs

React routing docs provide conflicting information on nested navigation

未关闭
#1,604 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
triage
主要语言
MDX
星标
621
派生
3.2k
平均合并
1 天 2 小时
30 天内合并 PR
86

描述

**URL**
https://ionicframework.com/docs/react/navigation

The React Navigation document contains a small bit of conflicting information (which caused me some confusion).

The docs first showcase an example of nested routing using `IonRouterOutlet`:
```jsx








```
with the `DashboardPage` component further down:
```jsx
const DashboardPage: React.FC = () => {
return (




);
};
```

So upon navigating to the `/dashboard` routes, we'd expect the `DashboardPage` component to work and allow for nested navigation.

However, this does **not** work properly. Indeed, the docs also say [below](https://ionicframework.com/docs/react/navigation#ionrouteroutlet):

> An `IonRouterOutlet` should also not be a descendant from another `IonRouterOutlet`.

In direct contradiction with what was showcased a few paragraphs above.

贡献指南

打开贡献指南

调研方向

Start at the React navigation page and compare the nested routing examples with the IonRouterOutlet guidance below. Clarify or revise the conflicting documentation so the supported approach to nested navigation is unambiguous, then verify the rendered page explains the same behavior consistently.

由索引模型根据 Issue 内容生成。

评估

技术栈
react
领域
documentation
Issue 类型
文档
难度
2/5
预计耗时
1-3 小时
活跃度
停滞
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。