Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[RFC] Nested routes #71

Open
aleclarson opened this issue Jun 30, 2022 · 0 comments
Open

[RFC] Nested routes #71

aleclarson opened this issue Jun 30, 2022 · 0 comments
Labels
proposal An idea not set in stone roadmap

Comments

@aleclarson
Copy link
Contributor

aleclarson commented Jun 30, 2022

For nested routes to be fully supported, we'll need a component for each UI library, but we can provide primitives to make implementation easy and share the common logic between them.

  • getMatchedRoutes
    This returns an array of Route objects, ordered parent-first.
    Its result is injected before each page starts rendering.
    The Route component can use this to know if it should render.

  • renderRoute
    Given a Route object, it will load its route props and route module.
    Then the route's layout (see [RFC] Layout modules #70) has its render method called, but with options.nested set to true (which signals to the layout that it should produce a result supported by its associated UI library, rather than plain HTML).

So the expected flow goes like this:

  • developer uses Route component specific to UI library of choice
  • component checks if any routes returned by getMatchedRoutes have a route pattern identical to its own
  • component calls renderRoute (if it finds a matching route) and does whatever with the result

Note that nested routes still need to be declared within the routes module, because that's where the route props, module, layout, and more are defined. That declaration is also used when pre-rendering and (eventually) bundling.

What's so great about nested routes?

Nested routes let you tell Saus that certain route props don't need to delay rendering until a certain point in the component tree. This means you can stream HTML to the browser before all data is loaded, which can vastly improve TTFP (time to first paint) and therefore make your site feel faster.

@aleclarson aleclarson added roadmap proposal An idea not set in stone labels Jun 30, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
proposal An idea not set in stone roadmap
Projects
None yet
Development

No branches or pull requests

1 participant