dojo dragon main logo

配置路由

路由配置是一个层级结构,用于描述整个应用程序,将 idoutlet 与路由路径关联起来。路由的路径中可以嵌套子路由,这样就可以构建出一个能精准反应应用程序需求的路由结构。

路由配置 API 由以下属性组成:

  • id: string: 路由的唯一标识。
  • path: string: 与 URL 匹配的路由路径片段。
  • outlet: string: 路由的 outlet 名称,Outlet 部件使用该值确定要渲染的内容。
  • defaultRoute: boolean (可选): 将此 Outlet 标记为默认路由,当应用程序加载时,如果没有配置路由或未找到路由,则应用程序会自动跳转到此路由。
  • defaultParams: { [index: string]: string } (可选): 相关的默认参数(pathquery),如果默认路由有必填的参数,则此项必填。
  • children: RouteConfig[] (可选): 嵌套的子路由配置。

src/routes.ts

export default [
    {
        id: 'home',
        path: 'home',
        outlet: 'home',
        defaultRoute: true
    },
    {
        id: 'about',
        path: 'about',
        outlet: 'about-overview',
        children: [
            {
                id: 'about-services',
                path: '{services}',
                outlet: 'about'
            },
            {
                id: 'about-company',
                path: 'company',
                outlet: 'about'
            },
            {
                id: 'about-history',
                path: 'history',
                outlet: 'about'
            }
        ]
    }
];

本示例将注册以下路径和路由标识:

URL Path Route
/home home
/about about-overview
/about/company about-company
/about/history about-history
/about/knitting about-services
/about/sewing about-services

about-services 路由被注册为与 /about 后跟的任何路径匹配,这与注册的 about-companyabout-history 有冲突,但是 Dojo 路由能确保在这些情况下也能匹配出正确的路由。