Top Layout

默认情况下，页面将通过递归向上遍历每个目录直到到达 src/routes 目录来创建其布局堆栈。 如果在任何时候它不应该继续递归向上遍历目录，您可以使用top layout功能。

top layout意味着该布局始终位于嵌套布局堆栈的最顶部，并且不会继续收集父布局，即使存在父目录布局。

通过以 ! 结尾的layout文件名来指定top layout，例如 layout!.tsx。

src/
└── routes/
    ├── layout.tsx              # Root layout
    └── docs/
        ├── layout!.tsx         # Docs layout
        ├── index.tsx           # https://example.com/docs
        └── api/
            └── index.tsx       # https://example.com/docs/api

在上面的示例中，src/routes/docs/api/index.tsx 的父目录中有两个布局。 默认情况下，docs/api 页面将嵌套在两种布局（root布局和docs布局）中。

但是，由于 src/routes/docs/layout!.tsx 文件名以 ! 结尾， 因此此布局成为top layout，而 Root src/routes/layout.tsx 布局不是布局堆栈的一部分。