动态路由匹配

我们经常需要把某种模式匹配到的所有路由,全都映射到同个view。例如,我们有一个 User view,对于所有 ID 各不相同的用户,都要使用这个视图来渲染。那么,我们可以在 magix-router 的路由路径中使用『动态路径参数』(dynamic segment)来达到这个效果:

define('app/user', function(require, exports, module) {
  module.exports = Magix.View.extend({
    tmpl: '<div>User</div>',
    render: function(){
      this.updater.digest()
    }
  })
})

const router = new MagixRouter({
  routes: [
    // 动态路径参数 以冒号开头
    { path: '/user/:id', view: 'app/user' }
  ]
})

现在呢,像 /user/foo/user/bar 都将映射到相同的路由。

一个『路径参数』使用冒号 : 标记。当匹配到一个路由时,参数值会被设置到 this.route.params,可以在每个视图内使用。于是,我们可以更新 User 的模板,输出当前用户的 ID:

define('app/user', function(require, exports, module) {
  module.exports = Magix.View.extend({
    tmpl: '<div>User <%= route.params.id %></div>',
    render: function(){
      this.updater.digest({
        route: this.route
      })
    }
  })
})

你可以看看这个在线例子

你可以在一个路由中设置多段『路径参数』,对应的值都会设置到 route.params 中。例如:

模式 匹配路径 route.params
/user/:username /user/evan { username: 'evan' }
/user/:username/post/:post_id /user/evan/post/123 { username: 'evan', post_id: 123 }

除了 route.params 外,route 对象还提供了其它有用的信息,例如,route.query(如果 URL 中有查询参数)、route.hash 等等。你可以查看 API 文档 的详细说明。

响应路由参数的变化

提醒一下,当使用路由参数时,例如从 /user/foo 导航到 /user/bar原来的视图实例会被复用。因为两个路由都渲染同个组件,比起销毁再创建,复用则显得更加高效。不过,这也意味着组件的生命周期钩子不会再被调用,需要调用 observeLocation 方法,可以查看 导航守卫 的详情说明,path变化时会重新调用 render 方法

复用组件时,想对路由参数的变化作出响应的话,你可以使用 beforeRouteUpdate 守卫:

define('app/user', function(require, exports, module) {
  module.exports = Magix.View.extend({
    tmpl: '<div>User <%=route.params.id%></div>',
    render: function(){
      this.updater.digest({
        route: this.route
      })
    },
    beforeRouteUpdate (to, from, next) {
      // react to route changes...
      // don't forget to call next()
    }
  })
})

高级匹配模式

magix-router 使用 path-to-regexp 作为路径匹配引擎,所以支持很多高级的匹配模式,例如:可选的动态路径参数、匹配零个或多个、一个或多个,甚至是自定义正则匹配。查看它的 文档 学习高阶的路径匹配,还有 这个例子 展示 magix-router 怎么使用这类匹配。

匹配优先级

有时候,同一个路径可以匹配多个路由,此时,匹配的优先级就按照路由的定义顺序:谁先定义的,谁的优先级就最高。

results matching ""

    No results matching ""