mpvue快速入门

mac2025-09-01  14

主要特性

使用 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>
最新回复(0)