66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
|
# vue-router [](https://circleci.com/gh/vuejs/vue-router)
|
||
|
|
|
||
|
|
> This is vue-router 2.0 which works only with Vue 2.0. For the 1.x router see the [1.0 branch](https://github.com/vuejs/vue-router/tree/1.0).
|
||
|
|
|
||
|
|
### Introduction
|
||
|
|
|
||
|
|
`vue-router` is the official router for [Vue.js](http://vuejs.org). It deeply integrates with Vue.js core to make building Single Page Applications with Vue.js a breeze. Features include:
|
||
|
|
|
||
|
|
- Nested route/view mapping
|
||
|
|
- Modular, component-based router configuration
|
||
|
|
- Route params, query, wildcards
|
||
|
|
- View transition effects powered by Vue.js' transition system
|
||
|
|
- Fine-grained navigation control
|
||
|
|
- Links with automatic active CSS classes
|
||
|
|
- HTML5 history mode or hash mode, with auto-fallback in IE9
|
||
|
|
- Customizable Scroll Behavior
|
||
|
|
|
||
|
|
Get started with the [documentation](http://vuejs.github.io/vue-router), or play with the [examples](https://github.com/vuejs/vue-router/tree/dev/examples) (see how to run them below).
|
||
|
|
|
||
|
|
### Development Setup
|
||
|
|
|
||
|
|
``` bash
|
||
|
|
# install deps
|
||
|
|
npm install
|
||
|
|
|
||
|
|
# build dist files
|
||
|
|
npm run build
|
||
|
|
|
||
|
|
# serve examples at localhost:8080
|
||
|
|
npm run dev
|
||
|
|
|
||
|
|
# lint & run all tests
|
||
|
|
npm test
|
||
|
|
|
||
|
|
# serve docs at localhost:8080
|
||
|
|
npm run docs
|
||
|
|
```
|
||
|
|
|
||
|
|
## Questions
|
||
|
|
|
||
|
|
For questions and support please use the [Discord chat server](https://chat.vuejs.org) or [the official forum](http://forum.vuejs.org). The issue list of this repo is **exclusively** for bug reports and feature requests.
|
||
|
|
|
||
|
|
## Issues
|
||
|
|
|
||
|
|
Please make sure to read the [Issue Reporting Checklist](https://github.com/vuejs/vue/blob/dev/.github/CONTRIBUTING.md#issue-reporting-guidelines) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
|
||
|
|
|
||
|
|
## Contribution
|
||
|
|
|
||
|
|
Please make sure to read the [Contributing Guide](https://github.com/vuejs/vue/blob/dev/.github/CONTRIBUTING.md) before making a pull request.
|
||
|
|
|
||
|
|
## Changelog
|
||
|
|
|
||
|
|
Details changes for each release are documented in the [release notes](https://github.com/vuejs/vue-router/releases).
|
||
|
|
|
||
|
|
## Stay In Touch
|
||
|
|
|
||
|
|
- For latest releases and announcements, follow on Twitter: [@vuejs](https://twitter.com/vuejs)
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
[MIT](http://opensource.org/licenses/MIT)
|
||
|
|
|
||
|
|
Copyright (c) 2013-present Evan You
|
||
|
|
|
||
|
|
|