# Nesting Routes

Routisan provides a fluent API for nesting your routes as children by using a callback passed to the route instance’s children() method. Naturally, you can nest as deeply as you like.

# Defining Nested Routes

Let’s expand on the last example by adding a few more account-management routes:

Route.view('account', 'AccountView').children(() => {
  Route.view('/', 'ManageAccount')
  Route.view('/emails', 'ManageEmails')

Here, AccountView would be the view that contains the <router-view /> for child routes.

Consistency Note

Leading slashes will be removed from child routes, otherwise the route path above would simply be /emails, not /account/emails. The aim here is to compile routes according to natural expectations of the tree-structure provided.

A note about nested child roots

Child Roots ('/') will be converted to empty strings to ensure the paths do not become absolute roots, ie app.test/. Whilst this feature is there by design in Vue Router 4, it is not supported by Routisan as it does not honour the natural expecations of the tree-structure.

# Cascading Names

You can cascade route names, without needed to re-define the prefix of a nested name. Expanding on the above example:

Route.view('account', 'AccountView').name('account').children(() => {
  Route.view('/', 'ManageAccount').name('manage')
  Route.view('/emails', 'ManageEmails').name('emails')

This would produce a set of routes with the following names:

  • /accountaccount.manage
  • /account/emailsaccount.emails
Last Updated: 9/25/2021, 12:51:09 PM