主要特性

使用 mpvue 开发小程序，你将在小程序技术体系的基础上获取到这样一些能力：

• 彻底的组件化开发能力：提高代码复用性
• 完整的 Vue.js 开发体验
• 方便的 Vuex 数据管理方案：方便构建复杂应用
• 快捷的 webpack 构建机制：自定义构建策略、开发阶段 hotReload
• 支持使用 npm 外部依赖
• 使用 Vue.js 命令行工具 vue-cli 快速初始化项目
• H5 代码转换编译成小程序目标代码的能力

快速开始

# 1. 先检查下 Node.js 是否安装成功
$ node -v
v8.9.0

$ npm -v
5.6.0

# 2. 由于众所周知的原因，可以考虑切换源为 taobao 源
$ npm set registry https://registry.npm.taobao.org/

# 3. 全局安装 vue-cli
# 一般是要 sudo 权限的
$ npm install --global vue-cli@2.9
$ sudo npm install --global vue-cli@2.9

# 4. 创建一个基于 mpvue-quickstart 模板的新项目
# 新手一路回车选择默认就可以了
$ vue init mpvue/mpvue-quickstart my-project

# 5. 安装依赖，走你
$ cd my-project
$ npm install
$ npm run dev # 可查看package.json支持哪些命令编译

vue init 时：

? Project name 你项目的名字
? wxmp appid 你的小程序appid
? Project description 项目描述
? Author 作者信息
? Vue build runtime 仅限运行时：没有自定义呈现函数，只能在*.vue中编译模板
? Use Vuex? 是否使用vuex
? Use ESLint to lint your code? 是否使用eslint

运行成功后可以在dist目录下看到build好的文件目录，在相应的小程序开发工具导入即可使用

注意事项

新增的页面需要重新 npm run dev 来进行编译

生成的项目目录

├── README.md #描述文件
├── build #build时执行文件目录,根据环境执行不同文件
│   ├── build.js
│   ├── check-versions.js
│   ├── dev-client.js
│   ├── dev-server.js
│   ├── utils.js
│   ├── vue-loader.conf.js #vue-loader配置文件
│   ├── webpack.base.conf.js
│   ├── webpack.dev.conf.js #开发版本打包执行文件
│   └── webpack.prod.conf.js #线上版本打包执行文件
├── config #项目配置文件
│   ├── dev.env.js #开发环境
│   ├── index.js #core代码
│   └── prod.env.js #线上环境
├── dist #生成各种小程序到此目录
│   └── wx #生成的微信小程序项目目录,可在微信开发者工具直接导入
│
├── index.html #挂载index
├── package.json
├── package.swan.json
├── project.config.json #微信项目配置文件
├── project.swan.json #百度项目配置文件
├── src #项目核心目录
│   ├── App.vue #项目初始化时先执行组件
│   ├── app.json #页面路径配置文件
│   ├── components #组件目录
│   │   └── card.vue #纯vue组件
│   ├── main.js #项目入口文件
│   ├── pages #页面目录
│   │   └── logs
│   │       ├── index.vue #页面模版,纯vue开发
│   │       ├── main.js #页面入口文件
│   │       └── main.json #页面配置文件
│   └── utils #工具文件目录
│       └── index.js #index工具文件
├── static #静态资源目录
│   ├── images
│   │   └── user.png
│   └── tabs
│       ├── home-active.png
│       ├── home.png
│       ├── orders-active.png
│       └── orders.png
└── tree.txt #项目结构树文件

生命周期

除了 Vue 本身的生命周期外，mpvue 还兼容了小程序生命周期，这部分生命周期钩子的来源于微信小程序的 Page， 除特殊情况外，不建议使用小程序的生命周期钩子。

注意事情

1、小程序里所有的 BOM／DOM 都不能用，也就是说 v-html 指令不能用。

2、 template 中的 {{}} 双花括号的部分，直接编码到 wxml 文件中，由于微信小程序的能力限制(数据绑定)，所以无法支持复杂的 JavaScript 表达式。目前可以使用的有 + - * % ?: ! == === > < [] .。

事件处理

// 事件映射表，左侧为 WEB 事件，右侧为 小程序 对应事件
{
    click: \'tap\',
    touchstart: \'touchstart\',
    touchmove: \'touchmove\',
    touchcancel: \'touchcancel\',
    touchend: \'touchend\',
    tap: \'tap\',
    longtap: \'longtap\',
    input: \'input\',
    change: \'change\',
    submit: \'submit\',
    blur: \'blur\',
    focus: \'focus\',
    reset: \'reset\',
    confirm: \'confirm\',
    columnchange: \'columnchange\',
    linechange: \'linechange\',
    error: \'error\',
    scrolltoupper: \'scrolltoupper\',
    scrolltolower: \'scrolltolower\',
    scroll: \'scroll\'
}

事件修饰符

• .stop 的使用会阻止冒泡，但是同时绑定了一个非冒泡事件，会导致该元素上的 catchEventName 失效！
• .prevent 可以直接干掉，因为小程序里没有什么默认事件，比如submit并不会跳转页面
• .capture 支持 1.0.9
• .self 没有可以判断的标识
• .once 也不能做，因为小程序没有 removeEventListener, 虽然可以直接在 handleProxy 中处理，但非常的不优雅，违背了原意，暂不考虑

小程序组件

mpvue 可以支持小程序的原生组件，比如： picker,map 等，需要注意的是原生组件上的事件绑定，需要以 vue 的事件绑定语法来绑定，如 bindchange="eventName" 事件，需要写成 @change="eventName"

示例代码：

<picker mode="date" :value="date" start="2015-09-01" end="2017-09-01" @change="bindDateChange">
    <view class="picker">
      当前选择: {{date}}
    </view>
</picker>