在 Weex 中使用 Vue.js

自2016年2月17日发布 WeexSDK v0.10.0 后， Weex 集成了 v2 版本的 Vue。Vue（读音 /vjuː/，类似于 view 的读音）是一套构建用户界面的渐进式框架。详情请参阅其官方网站。

如果没有特别指示，文章中的 “Vue.js” 或者 “Vue” 都指的是 v2 版本的 Vue。

只含有运行时的构建版本

如果你熟悉 Vue.js，你应该知道 Vue.js 有两种构建版本: 运行时 + 编译器 与 只包含运行时。它们之间的区别在于编译器是否需要能够在运行时编译template选项。由于运行时构建版本比完整版本的构建版本轻约30%，为了更好的性能和更少的代码尺寸，Weex用的是只包含运行时的方式构建Vue。

具体来说，差异如下：

• 定义组件时不支持template选项。
• 不支持使用x-templates。
• 不支持使用Vue.compile。

平台的差异

Vue.js最初是为Web平台设计的。虽然可以基于Weex开发原生应用程序，但是仍然存在许多Weex 与 Web 平台的差异。

与 Web 平台的主要差异是: 上下文、DOM、样式和事件。

上下文

Weex 主要用于编写多页的应用程序，每一页相当于原生开发中的 View 或者 Activity，并且它有着自己的上下文。尤其Vue实例在每个页面都是不同的，甚至 Vue 的”全局”配置（Vue.config.xxx）也只会影响 Weex 上的单个页面。

在此基础上，一些 Vue 的 SPA （单页面应用）技术，如 Vuex 和 vue-router 也将单页内生效。更通俗地说，“页面”概念在 SPA 技术中是虚拟的，但在 Weex 上却是真实的。

无论如何，Vuex 和 vue-router 都是独立的库，它们都有自己的概念和使用场景，你仍然可以在 Weex 里使用 Vuex 和 vue-router。

DOM

因为在 Android 和 iOS 上没有 DOM（Document Object Model），如果你要手动操作和生成 DOM 元素的话可能会遇到一些兼容性问题。在你使用现代前端框架的情况下，操作数据与组件而不是生成的元素是一个比较好的做法。

一些与 DOM 相关的特性，比如 v-html，vm.$el，template 选项，在不同的平台上可能无法获得相同的反应。

准确来说，vm.$el属性类型在web环境下是HTMLElement，但是在移动端并没有这个类型。实际上，它是一个由 Weex 文档对象模型 定义的特殊数据结构。

样式

样式表和 CSS 规则是由 Weex js 框架和原生渲染引擎管理的。要实现完整的 CSS 对象模型（CSSOM：CSS Object Model）并支持所有的 CSS 规则是非常困难的，而且没有这个必要。

出现性能考虑，Weex 目前只支持单个类选择器，并且只支持 CSS 规则的子集。详情请参阅 通用样式 与 文本样式。

在 Weex 里， 每一个 Vue 组件的样式都是 scoped。

事件

目前在 Weex 里不支持事件冒泡和捕获，因此 Weex 原生组件不支持事件修饰符，例如.prevent，.capture，.stop，.self 。

此外，按键修饰符以及系统修饰键 例如 .enter，.tab，.ctrl，.shift 在移动端基本没有意义，在 Weex 中也不支持。

Web 渲染器

如果你想在网络上呈现你的页面，你需要 weex-vue-render 来实现它。

weex-vue-render是 Vue DSL 的 Web 渲染器， 它在 Web 上实现了 Weex 的内置组件和内置模块。详情请参阅这里。

单文件组件

Vue 中的单文件组件（即*.vue文件）是一种特殊的文件格式，扩展名为.vue。这个模板会在构建时便于到render函数里。

此外，所有的编辑器里都支持一个好的语法高亮插件。

在 Weex 中使用单个文件组件语法是一种很好的做法。

编译目标

因为平台的差异以及为了提高网络性能，*.vue文件需要用两种不同的方式来编译：

• 对于 Web 平台来说，你可以用任何正式的方式来编译源文件，例如 使用 Webpack + vue-loader 或者 Browserify + vueify 来编译*.vue文件。
• 对于安卓与 iOS 平台来说， 你需要使用 weex-loader 来编译*.vue文件。

不同的平台使用不同的bundles，可以充分利用平台原有的特性，减少构建时的兼容性代码。但是源代码仍然是一样的，唯一的区别是编译它的方法。

使用weex-loader

weex-loader 是一个 webpack 的 loader，它能把*.vue文件转化为简单的javascript 模块用于安卓以及 iOS 平台。所有的特性和配置都是跟 vue-loader 一样的。

需要注意的是，如果您的Webpack配置的entry选项是一个*.vue文件的话，你仍需要传递一个额外的entry参数。

const webpackConfig = {
  // Add the entry parameter for the .vue file
  entry: './path/to/App.vue?entry=true'
  /* ... */
  use: {
    loaders: [{
      // matches the .vue file path which contains the entry parameter
      test: /\.vue(\?^^]+)?$/,
      loaders: ['weex-loader']
    }]
  }
}

如果你现在用的是.js文件做入口文件，你不需要写那些额外的参数。推荐 webpack 配置的入口文件使用 javascript 文件。

{
  entry: './path/to/entry.js'
}

支持的功能

全局配置

Vue “全局”配置只会影响 Weex 上的单一页面，配置不会在不同的 Weex 页面之间共享。

全局 API

选项

生命周期钩子

Vue 组件的实例生命周期钩子将在特定的阶段发出，详情请参考 Vue 组件的生命周期图示。

实例属性

实例方法

指令

特殊属性

内置组件