Vue-router 官方文档笔记

vue-router

个人理解:Vue中的路由相当于pc里面的锚点超链接,如果点击了页面转向哪,也有点像ajax。

安装

npm install vue-router

开始

用Vue.js + vue-router创建单页应用,是非常简单的。使用Vue.js时,我们就已经把组件组合成一个应用了,当你要把vue-router加进来,只需要配置组件和路由映射,然后告诉vue-router在哪里渲染他们。
组件 → 路由 → 渲染地方

<div id="app">
  <h1>Hello App!h1>
  <p>
    
    
    
    <router-link to="/foo">Go to Foorouter-link>
    <router-link to="/bar">Go to Barrouter-link>
  p>
  
  
  <router-view>router-view>
div>
// 0. 如果使用模块化机制编程,導入Vue和VueRouter,要调用 Vue.use(VueRouter)

// 1. 定义(路由)组件。
// 可以从其他文件 import 进来
const Foo = { template: '
foo
'
} const Bar = { template: '
bar
'
} // 2. 定义路由 // 每个路由应该映射一个组件。 其中"component" 可以是 // 通过 Vue.extend() 创建的组件构造器, // 或者,只是一个组件配置对象。 // 我们晚点再讨论嵌套路由。 const routes = [ { path: '/foo', component: Foo }, { path: '/bar', component: Bar } ] // 3. 创建 router 实例,然后传 `routes` 配置 // 你还可以传别的配置参数, 不过先这么简单着吧。 const router = new VueRouter({ routes // (缩写)相当于 routes: routes }) // 4. 创建和挂载根实例。 // 记得要通过 router 配置参数注入路由, // 从而让整个应用都有路由功能 const app = new Vue({ router }).$mount('#app') // 现在,应用已经启动了!

动态路由匹配

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

const User = {
  template: '
User
'
} const router = new VueRouter({ routes: [ {path: '/user/:id', component: User} ] })

路径参数用:表示。
一个路由中可以设置多段路径参数,对应的值都会设置到 route.params route.params外, route route.query, route.hash使watch route对象。

const User = {
    template: '...',
    watch: {
        '$route' (to, from) {

        }
    }
}

嵌套路由

组件模板中有可能有自己的出口,要在嵌套的出口中渲染组件,需要在VueRouter的参数中使用children配置:

const router = new VueRouter({
    router: [
        {path: '/user/:id', component: User,
            children: [
                {
                    path: 'profile',
                    component: UserProfile
                },
                {
                    path: 'posts',
                    component: UserPosts
                }
            ]
        }
    ]
})

要注意,以/开头的嵌套路径会被当作根路径。这让你充分的使用嵌套组件而无须设置嵌套的路径。

编程式的导航

除了使用创建a标签来定义导航链接,我们还可以借助router的实例方法,通过编写代码来实现。
router.push()
这种方法会向history栈中添加记录
router.push() ==

// 字符串
router.push('home')

// 对象
router.push({ path: 'home' })

// 命名的路由
router.push({ name: 'user', params: { userId: 123 }})

// 带查询参数,变成 /register?plan=private
router.push({ path: 'register', query: { plan: 'private' }})

router.replace(location)
router.replace(location) ==
router.go(n)
这个方法的参数是一个整数,意思是在history记录中向前或者后退多少步,类似window.history.go(n)

命名路由

主要是为了通过一个名称来标识一个路由显得更方便一些。

const router = new VueRouter({
  routes: [
    {
      path: '/user/:userId',
      name: 'user',
      component: User
    }
  ]
})

命名视图

有时想同时展示多个视图。

<router-view class="view one"></router-view>
<router-view class="view two" name="a"></router-view>
<router-view class="view three" name="b"></router-view>  
const router = new VueRouter({
  routes: [
    {
      path: '/',
      components: {
        default: Foo,
        a: Bar,
        b: Baz
      }
    }
  ]
})

重定向和别名

const router = new VueRouter({
    routes: [
        {path: '/a', redirect: '/b'}
    ]
})

重定向的目标也可以是一个命名的路由:

const router = new VueRouter({
    routes: [
        {path: '/a', redirect: {name: 'foo'}}
    ]
})

甚至是一个方法

const router = new VueRouter({
  routes: [
    { path: '/a', redirect: to => {
      // 方法接收 目标路由 作为参数
      // return 重定向的 字符串路径/路径对象
    }}
  ]
})

别名

/a 的别名是 /b,意味着,当用户访问 /b 时,URL 会保持为 /b,但是路由匹配则为 /a,就像用户访问 /a 一样。

const router = new VueRouter({
  routes: [
    { path: '/a', component: A, alias: '/b' }
  ]
})

HTML5 History模式

使用history模式时,URL就是正常的url。

const router = new VueRouter({
  mode: 'history',
  routes: [...]
})

导航钩子

正如其名,vue-router提供的导航钩子主要用来拦截导航,让它完成跳转或取消。有多种方式可以在路由导航发生时执行钩子: 全局的,单个路由独享的,或者组件级的。
全局钩子

const router = new VueRouter({ ... })

router.beforeEach((to, from, next) => {
  // ...
})
每个钩子方法接收三个参数:

    to: Route: 即将要进入的目标 路由对象

    from: Route: 当前导航正要离开的路由

    next: Function: 一定要调用该方法来 resolve 这个钩子。执行效果依赖 next 方法的调用参数。

        next(): 进行管道中的下一个钩子。如果全部钩子执行完了,则导航的状态就是 confirmed (确认的)。

        next(false): 中断当前的导航。如果浏览器的 URL 改变了(可能是用户手动或者浏览器后退按钮),那么 URL 地址会重置到 from 路由对应的地址。

        next('/') 或者 next({ path: '/' }): 跳转到一个不同的地址。当前的导航被中断,然后进行一个新的导航。

确保要调用 next 方法,否则钩子就不会被 resolved。

某个路由独享的钩子

const router = new VueRouter({
  routes: [
    {
      path: '/foo',
      component: Foo,
      beforeEnter: (to, from, next) => {
        // ...
      }
    }
  ]
})

组件内的钩子

const Foo = {
  template: `...`,
  beforeRouteEnter (to, from, next) {
    // 在渲染该组件的对应路由被 confirm 前调用
    // 不!能!获取组件实例 `this`
    // 因为当钩子执行前,组件实例还没被创建
  },
  beforeRouteUpdate (to, from, next) {
    // 在当前路由改变,但是改组件被复用时调用
    // 举例来说,对于一个带有动态参数的路径 /foo/:id,在 /foo/1 和 /foo/2 之间跳转的时候,
    // 由于会渲染同样的 Foo 组件,因此组件实例会被复用。而这个钩子就会在这个情况下被调用。
    // 可以访问组件实例 `this`
  },
  beforeRouteLeave (to, from, next) {
    // 导航离开该组件的对应路由时调用
    // 可以访问组件实例 `this`
  }
}

路由元信息
定义路由的时候可以配置meta字段

const router = new VueRouter({
  routes: [
    {
      path: '/foo',
      component: Foo,
      children: [
        {
          path: 'bar',
          component: Bar,
          // a meta field
          meta: { requiresAuth: true }
        }
      ]
    }
  ]
})

我们称呼routes配置中的每个路由对象为路由记录。路由记录可以是嵌套的,因此,当一个路由匹配成功后,他可能匹配多个路由记录。
例如,根据上面的路由配置,/foo/bar这个URL将会匹配路由记录以及子路由记录。
一个路由匹配到的所有路由记录会暴露为 routeroute route.matched数组。因此,我们需要遍历$route.matched来检查路由记录中的meta字段。

过渡动效

是基本的动态组件,所以我们可以用组件给它添加一些过渡效果。

数据获取

有时候,进入某个路由后,需要从服务器获取数据。例如,在渲染用户信息时,你需要从服务器获取用户的数据,我们可以通过两种方式来实现:
1.导航完成之后获取:先完成导航,然后在接下来的组件生命周期钩子中获取数据,在数据获取期间显示加载中的指示。
2.导航完成之前获取:导航完成前,在路由的enter钩子中获取数据,在数据获取成功后执行导航。
导航完成后获取数据
当你使用这种方式时,我们会马上导航和渲染组件,然后在组件的created钩子中获取数据。这让我们有机会再数据获取期间展示一个loading状态,还可以在不同视图间展示不同的loading状态。

  

export default {
    data() {
        return {
            loading: false,
            post: null,
            error: null
        }
    },
    created() {
        // 组件创建完后获取数据,
        // 此时data已经被observed了
        this.fetchData()
    },
    watch: {
        // 如果路由有变化,会再次执行该方法
        '$route': 'fetchData'
    },
    methods: {
        this.error = this.post =null
        this.loading =true
        // replace getPost with your data fetching util/API wrapper
        getPost(this.$route.params.id, (err ,post) => {
            this.loading = false
            if(err) {
                this.error = err.toString()
            } else {
                this.post = post
            }
        })
    }
}

在导航完成前获取数据

export default {
  data () {
    return {
      post: null,
      error: null
    }
  },
  beforeRouteEnter (to, from, next) {
    getPost(to.params.id, (err, post) => 
      if (err) {
        // display some global error message
        next(false)
      } else {
        next(vm => {
          vm.post = post
        })
      }
    })
  },
  // 路由改变前,组件就已经渲染完了
  // 逻辑稍稍不同
  watch: {
    $route () {
      this.post = null
      getPost(this.$route.params.id, (err, post) => {
        if (err) {
          this.error = err.toString()
        } else {
          this.post = post
        }
      })
    }
  }
}

滚动行为

使用前端路由,当切换到新路由时,想要页面滚动到顶部,或者是保持原先的滚动位置,就像重新加载页面那样。vue-router能做到,而且更好,它让你可以自定义路由切换时页面如何滚动。

const router = new VueRouter({
  routes: [...],
  scrollBehavior (to, from, savedPosition) {
    // return 期望滚动到哪个的位置
  }
})

路由懒加载

当打包构建应用时,Javascript包会变得非常大,影响页面加载。如果我们能把不同路由对应的组件分割成不同的代码块,然后当路由被访问的时候才加载对应组件,这样就更加高效了。
结合Vue的异步组件和Webpack的code splitting feature,轻松实现路由组件的懒加载。
我们要做的就是把路由对应的组件定义成异步组件:

const Foo = resolve => {
  // require.ensure 是 Webpack 的特殊语法,用来设置 code-split point
  // (代码分块)
  require.ensure(['./Foo.vue'], () => {
    resolve(require('./Foo.vue'))
  })
}

或者

const Foo = resolve => require(['./Foo.vue'], resolve)

API文档

组件支持用户在具有路由功能的应用中(点击)导航。通过to属性指定目标地址,默认渲染成带有正确连接的标签,可以通过配置tag属性生成别的标签,另外,当目标路由成功激活时,链接元素自动设置一个表示激活的CSS类名。
但是比起写死的标签要好些,理由如下:
1.无论是在HTML5history模式还是hash模式,它的表现行为一致,所以当需要切换路由模式,或者在IE9降级使用hash模式,无须作任何变动。
2.在HTML5history模式下,router-link会拦截点击事件,让浏览器不再重新加载页面。
3.当你在HTML5history模式下使用base选项后,所有的to属性都不需要写(基路径)了。

Props

### to

<router-link to="home">Homerouter-link>

<a href="home">Homea>


<router-link v-bind:to="'home'">Homerouter-link>


<router-link :to="'home'">Homerouter-link>


<router-link :to="{ path: 'home' }">Homerouter-link>


<router-link :to="{ name: 'user', params: { userId: 123 }}">Userrouter-link>


<router-link :to="{ path: 'register', query: { plan: 'private' }}">Registerrouter-link>

replace

<router-link :to="{ path: '/abc'}" replace></router-link>

append

设置append属性后,则在当前路径前添加基路径。

<router-link :to="{ path: 'relative/path'}" append></router-link>

tag

默认为a标签,有时候想要渲染成某种标签,例如

  • 。于是我们是用tag prop类指定何种标签,同样它还是会监听点击,触发导航。
  • <router-link to="/foo" tag="li">foorouter-link>
    
    <li>fooli>

    active-class

    默认值是router-link-active,设置链接激活时使用的CSS类名。默认值可以通过路由的构造选项linkActiveClass来全局配置。

    exact

    默认值是false,是否扩展到全局。

    router-view

    组件是一个functional组件,渲染路径匹配到的视图组件。渲染的组件还可以内嵌自己的,根据嵌套路径,渲染嵌套组件。

    Props

    name

    默认值是default,如果设置了名称,则会渲染对应的路由配置中components下的响应组件。

    行为表现

    其他属性(非router-view使用的属性)都直接传给渲染的组件,很多时候,每个路由的数据都是包含在路由参数中。
    因为它也是个组件,所以可以配合和使用。如果两个结合一起用,要确保在内层使用:

    <transition>
        <keep-alive>
            <router-view>router-view>
        keep-alive>
    transition>

    路由信息对象

    route object是不可变的,每次成功的导航后都会产生一个新的对象。
    $route.path

    类型: string
    
    字符串,对应当前路由的路径,总是解析为绝对路径,如 "/foo/bar"。
    

    $route.params

    类型: Object
    

    一个 key/value 对象,包含了 动态片段 和 全匹配片段,如果没有路由参数,就是一个空对象。
    $route.query

    类型: Object
    
    一个 key/value 对象,表示 URL 查询参数。例如,对于路径 /foo?user=1,则有 $route.query.user == 1,如果没有查询参数,则是个空对象。
    

    $route.hash

    类型: string
    
    当前路由的 hash 值 (带 #) ,如果没有 hash 值,则为空字符串。
    

    $route.fullPath

    类型: string
    
    完成解析后的 URL,包含查询参数和 hash 的完整路径。
    

    $route.matched

    类型: Array
    

    一个数组,包含当前路由的所有嵌套路径片段的 路由记录 。路由记录就是 routes 配置数组中的对象副本(还有在 children 数组)。

    const router = new VueRouter({
      routes: [
        // 下面的对象就是 route record
        { path: '/foo', component: Foo,
          children: [
            // 这也是个 route record
            { path: 'bar', component: Bar }
          ]
        }
      ]
    })

    当 URL 为 /foo/bar,$route.matched 将会是一个包含从上到下的所有对象(副本)。

    $route.name

    Router构造配置

    Router 实例

    当前路由的名称,如果有的话。

    你可能感兴趣的:(Vue)