Vue.js 2.0 教程


兼容性

Vue.js 不支持 IE8 及其以下版本,因为 Vue.js 使用了 IE8 不能实现的 ECMAScript 5 特性。 Vue.js 支持所有兼容 ECMAScript 5 的浏览器

更新日志

每个版本的更新日志见 GitHub

独立版本

直接下载并用 <script> 标签引入,Vue 会被注册为一个全局变量。重要提示:在开发时请用开发版本,遇到常见错误它会给出友好的警告。

开发环境不要用最小压缩版,不然就失去了错误提示和警告!

开发版本包含完整的警告和调试模式

生产版本删除了警告,22.86kb min+gzip

CDN

推荐:unpkg, 会保持和 npm 发布的最新的版本一致。可以在 unpkg.com/vue/ 浏览 npm 包资源。

也可以从 jsdelivrcdnjs 获取,不过这两个服务版本更新可能略滞后。

NPM

在用 Vue.js 构建大型应用时推荐使用 NPM 安装, NPM 能很好地和诸如 WebpackBrowserify 模块打包器配合使用。 Vue.js 也提供配套工具来开发单文件组件。

  1. # 最新稳定版
  2. $ npm install vue

独立构建 vs 运行时构建

有两种构建方式,独立构建和运行构建。

  • 独立构建包括编译和支持 template 选项。 它也依赖于浏览器的接口的存在,所以你不能使用它来为服务器端渲染。

  • 运行时构建不包括模板编译,不支持 template 选项。运行时构建,可以用 render 选项,但它只在单文件组件中起作用,因为单文件组件的模板是在构建时预编译到 render 函数中,运行时构建只有独立构建大小的30%,只有 16 Kb min+gzip大小。

默认 NPM 包导出的是 运行时 构建。为了使用独立构建,在 webpack 配置中添加下面的别名:

  1. resolve: {
  2. alias: {
  3. 'vue$': 'vue/dist/vue.js'
  4. }
  5. }
对于Browserify,可以用 aliasify

不要用 import Vue from 'vue/dist/vue.js' - 用一些工具或第三方库引入 Vue ,这可能会导致应用程序在同一时间加载运行时和独立构建并造成错误。

CSP 环境

有些环境,如 Google Chrome Apps ,强制应用内容安全策略 (CSP) ,不能使用 new Function() 对表达式求值。这时可以用 CSP 兼容版本。独立的构建取决于该功能编译模板,所以无法使用这些环境。

另一方面,运行时构建的是完全兼容 CSP 的。当通过 Webpack + vue-loader 或者 Browserify + vueify 构建时,在 CSP 环境中模板将被完美预编译到 render 函数中。

命令行工具

Vue.js 提供一个官方命令行工具,可用于快速搭建大型单页应用。该工具提供开箱即用的构建工具配置,带来现代化的前端开发流程。只需一分钟即可启动带热重载、保存时静态检查以及可用于生产环境的构建配置的项目:

  1. # 全局安装 vue-cli
  2. $ cnpm install --global vue-cli
  3. # 创建一个基于 webpack 模板的新项目
  4. $ vue init webpack my-project
  5. # 这里需要进行一些配置,默认回车即可
  6. This will install Vue 2.x version of the template.
  7.  
  8. For Vue 1.x use: vue init webpack#1.0 my-project
  9.  
  10. ? Project name my-project
  11. ? Project description A Vue.js project
  12. ? Author runoob <test@runoob.com>
  13. ? Vue build standalone
  14. ? Use ESLint to lint your code? Yes
  15. ? Pick an ESLint preset Standard
  16. ? Setup unit tests with Karma + Mocha? Yes
  17. ? Setup e2e tests with Nightwatch? Yes
  18.  
  19. vue-cli · Generated "my-project".
  20.  
  21. To get started:
  22. cd my-project
  23. npm install
  24. npm run dev
  25. Documentation can be found at https://vuejs-templates.github.io/webpack

开发版本

重要: 在发布后构建的文件在 Github 仓库的 /dist 文件夹。为了使用 Github 上 Vue 最新的资源,你得自己构建。

  1. git clone https://github.com/vuejs/vue.git node_modules/vue
  2. cd node_modules/vue
  3. npm install
  4. npm run build

Bower

  1. # 最新稳定版本
  2. $ bower install vue

AMD 模块加载器

独立下载版本或通过 Bower 安装的版本已用 UMD 包装,因此它们可以直接用作 AMD 模块。

Vue.js 目录结构

上一章节中我们使用了 npm 安装项目,我们再 IDE(Eclipse、Atom等) 中打开该目录,结构如下所示:

目录解析

目录/文件 说明
build 最终发布的代码存放位置。
config 配置目录,包括端口号等。我们初学可以使用默认的。
node_modules npm 加载的项目依赖模块
src

这里是我们要开发的目录,基本上要做的事情都在这个目录里。里面包含了几个目录及文件:

  • assets: 放置一些图片,如logo等。
  • commponents: 目录里面放了一个组件文件,可以不用。
  • App.vue: 项目入口文件,我们也可以直接将组建写这里,而不使用 commponents 目录。
  • main.js: 项目的核心文件。
static 静态资源目录,如图片、字体等。
test 初始测试目录,可删除
.xxxx文件 这些是一些配置文件,包括语法配置,git配置等。
index.html 首页入口文件,你可以添加一些 meta 信息或同统计代码啥的。
package.json 项目配置文件。
README.md 项目的说明文档,markdown 格式

在前面我们打开 APP.vue 文件,代码如下(解释在注释中):

src/APP.vue

  1. <!-- 展示模板 -->
  2. <template>
  3. <div id="app">
  4. <img src="./assets/logo.png">
  5. <hello></hello>
  6. </div>
  7. </template>
  8. <script>
  9. // 导入组件
  10. import Hello from './components/Hello'
  11. export default {
  12. name: 'app',
  13. components: {
  14. Hello
  15. }
  16. }
  17. </script>
  18. <!-- 样式代码 -->
  19. <style>
  20. #app {
  21. font-family: 'Avenir', Helvetica, Arial, sans-serif;
  22. -webkit-font-smoothing: antialiased;
  23. -moz-osx-font-smoothing: grayscale;
  24. text-align: center;
  25. color: #2c3e50;
  26. margin-top: 60px;
  27. }
  28. </style>

接下来我们可以尝试修改下初始化的项目,将 Hello.vue 修改为以下代码:

src/commponents/Hello.vue

  1. <template>
  2. <div class="hello">
  3. <h1>{{ msg }}</h1>
  4. </div>
  5. </template>
  6. <script>
  7. export default {
  8. name: 'hello',
  9. data () {
  10. return {
  11. msg: '欢迎来到手册网!'
  12. }
  13. }
  14. }
  15. </script>

重新打开页面 http://localhost:8080/,一般修改后会自动刷新。