为了清楚起见,我们将要对vue-cli生成的代码做一个清理工作,具体如下:
删掉src/components、src/pages、src/utils三个目录下的所有代码文件
将src/App.vue文件中的内容重置成:
export default {}
</script>
<style>
</style>
- 将`src/main.js`文件中的内容重置成:
import App from './App'
Vue.config.productionTip = false
App.mpType = 'app'
const app = new Vue(App)
app.$mount()
export default {
config: {
pages: [],
window: {
backgroundTextStyle: 'light',
navigationBarBackgroundColor: '#fff',
navigationBarTitleText: '第一个小程序',
navigationBarTextStyle: 'black'
}
}
}
至此,我们的代码就成了一个小程序页面都没有的初始状态。
####程序入口
学习过使用小程序原生框架开发的朋友都知道,一个小程序的入口应该包含这三个最重要的部分:
1)app.json
2)app.js
3)首页
有了这三个部分,才能成功运行起一个最简单的小程序。
######app.json
`app.json`是小程序的全局配置文件,其包含了小程序的页面文件路径配置、窗口的全局样式信息、底部选项卡式菜单栏的配置,以及一些小程序网络超时的配置等等。`app.json`的配置详情我们可以[查阅参考小程序的官方文档来作进一步了解](https://developers.weixin.qq.com/miniprogram/dev/framework/config.html)。那么,在mpvue中我们如何来做与之等价的配置呢?
其实在`src/main.js`中,我们就可以完整的进行这些信息的配置,具体可以查看该文件的最底部代码:
// 这部分相当于原生小程序的 app.json
config: {
pages: [],
window: {
backgroundTextStyle: 'light',
navigationBarBackgroundColor: '#fff',
navigationBarTitleText: '第一个小程序',
navigationBarTextStyle: 'black'
}
}
}
在该代码中通过`export default`导出的对象的`config`属性下的值,就是这些小程序的配置信息了。
######app.js
`app.js`中包含了小程序的各种原生生命周期方法,如`onLaunch`、`onShow`等等。而在mpvue中,它使用了一个简单的Vue组件`App.vue`来实现等价的功能。我们在这个`App.vue`组件中可以编写小程序的生命周期方法(通常使用Vue的生命周期方法,但也兼容原生的生命周期方法),也可以在其中加入小程序的全局样式(等价于原生方式下的`app.wxss`):
/ 这部分相当于原生小程序的 app.js /
export default {
created () {
console.log('miniapp created!!!')
}
}
</script>
<style>
/ 这部分相当于原生小程序的 app.wxss /
.container {
background-color: #cccccc;
}
</style>
接着,这个`App.vue`组件被`src/main.js`引入并被设置了一个`mpType`的属性值,其值为`app`。这个值是为了与后面要讲的小程序页面组件所区分开来,因为小程序页面组件和这个`App.vue`组件的写法和引入方式是一致的,为了区分两者,需要设置`mpType`值。引入这个`App.vue`组件后,会用它作为参数来创建一个[Vue的实例](https://cn.vuejs.org/v2/guide/instance.html),并调用`$mount()`方法加载。下面是这个过程的关键代码行:
const app = new Vue(App)
app.$mount()
######首页、以及其他页面
每个小程序都需要至少有一个页面,第一个展示的页面被叫做*首页*。因为前面已经把所有的页面代码都删完了,所以我们现在要新建一个首页。在`src/pages`目录下,我们新建一个名为`index`的子目录(请遵循每个页面放入一个子目录的良好习惯),然后在该子目录下,新建2个文件:一个用于实现页面主体功能的`index.vue`组件,另一个则用于将这个页面组件生成Vue实例并加载的`main.js`。以后的每一个mpvue页面组件都会拥有这样的结构。
![](https://upload-images.jianshu.io/upload_images/3407939-db653d8b653c1824.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
然后在`main.js`中编写如下代码,非常简单的一段代码,它的功能是引入`index.vue`并创建Vue实例:
import App from './index'
const app = new Vue(App)
app.$mount()
接着,我们需要实现`index.vue`页面组件,它的写法是最典型的Vue组件写法。
<div class="container" @click="clickHandle">
<div class="message">{{msg}}</div>
</div>
</template>
<script>
export default {
data () {
return {
msg: 'Hello'
}
},
methods: {
clickHandle () {
this.msg = 'Clicked!!!!!!'
}
}
}
</script>
<style scoped>
.message {
color: red;
padding: 10px;
text-align: center;
}
</style>
可以看到,这个组件完全看不到小程序写法的影子,而是全部由Vue开发Web应用的写法来完成:数据绑定、事件处理、scoped局部样式、以及使用HTML标签来构建界面。这样最大化的保持和网页应用开发一致,减少了前端人员切换到小程序的学习理解成本,也为原先使用Vue开发的网页应用移植到小程序平台提供了降低迁移成本的可能。
模板部分我们通常可以用HTML标签来写,比如`div`、`span`等,它们会在编译的时候被自动转换成小程序的原生组件`view`、`text`之类;而那些小程序特有的组件如`swiper`、`rich-text`等,可以直接在模板中使用。
在原生小程序的页面(Page)中包含了很多页面的生命周期方法,如`onLoad`、`onUnload`、`onShow`、`onHide`、`onPullDownRefresh`等等,mpvue中推荐使用Vue组件生命周期方法,而像`onPullDownRefresh`、`onReachBottom `这类特殊功能的生命周期则需直接使用原生的。
回头再来看,当我们实现了这个`index.vue`页面组件后,其实还缺最后一个步骤,就是需要将这个页面组件指定为首页。如果我们的小程序只有一个页面的话,其实也可以省略这一步,因为mpvue会自动将`src/pages`目录下的页面组件路径添加到最终编译出来的小程序配置文件中去(可以打开`dist/app.json`文件观察一下):
"pages": [
"pages/index/main"
],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "第一个小程序",
"navigationBarTextStyle": "black"
}
}
但是,大多数情况下我们的小程序会由很多个页面组成,在`src/pages`目录下编写多个页面组件后,mpvue也会自动把它们都添加进配置文件,但是由于小程序有一个机制:
>配置文件中pages数组里的第一个page路径会被当做是首页
如果你期望的首页组件并没有被mpvue添加到第一个路径的话,就不会被当做首页显示。比如有多个页面,并在`dist/app.json`里生成的是下面的序列,则第一个`pages/articles/main`页面会被当做首页:
"pages/articles/main",
"pages/authors/main",
"pages/index/main",
"pages/kickstart/main"
]
为了解决这种情况,我们需要显式的去指定首页。可以在`src/main.js`的配置里,加入这样一行配置信息:
'^pages/index/main'
]
注意:以上配置中指定为首页的路径前面有个`^`符号。
加入这行配置之后,`pages/index/main`总是会在最终生成的`dist/app.json`中排在第一个位置,成为首页。
####小结
今天主要了解了作为一个最简单的可以运行的mpvue小程序所应该包含的各个代码部分,希望你可以动手实践一下,理解和掌握这些内容。Good Luck!
相关推荐
使用mpvue开发小程序简单的小教程,mpvue介绍、mpvue环境搭建 、mpvue项目转换成小程序项目导入运行,mpvue 源码分析 创建页面 绑定事件 循环数据 页面路由跳转 生命周期函数---
这是我第一次开发小程序,开发的产品是音频类的,在大佬的建议下采用了 mpvue ,一周时间把功能都做出来,由于不太熟悉mpvue和微信小程序,足足用了一周时间来改bug才出来一个能用的版本,在这里整理分享下我开发时...
mpvue从底层支持 Vue.js 语法和构建工具体系,同时再结合相关UI组件库,便可以高效的实现小程序开发。这篇文章主要介绍了基于mpvue搭建小程序项目框架 ,需要的朋友可以参考下
第三:mpvue小程序,小程序主要是用 mpvue 框架开发 mpvue 小程序运行步骤: 1、安装node环境 node 是8版本,这边开发版本是8.12.0,由于mpvue属于老牌小程序框架了,目前这边验证的只是这个node版本, 当然新的小...
mpvue是一个使用Vue.js开发小程序的前端框架(美团的开源项目)。框架基于Vue.js核心,mpvue修改了Vue.js的 runtime 和 compiler 实现,使其可以运行在小程序环境中,从而为小程序开发引入了整套Vue.js开发体验。 ...
这个框架支持Vue.js的基本语法和构建工具体系,使得开发者可以利用现有的Vue.js技能和生态系统来开发小程序。本资源旨在为开发者提供一个全面的Mpvue项目介绍和使用教程,帮助你快速上手和深入理解如何在微信小程序...
mpvue-vant记录了我们团队开发中在mpvue中使用Vant Weapp组件库所踩下的坑,在这里分享给大家,让mpvue开发者可以使用vant组件库进行开发,避免踩不必要的坑。 此教程是在dov-yih一同协助下完成。经过测试,Vant ...
并不允许,所以找了一个IM第三方框架,采用的是腾讯云的即时通信IM,但是目前腾讯云IM的小程序SDK并没有包含UI,因此就需要自己来开发页面样式和交互,腾讯云IM自己也提供了一个demo,但是使用mpvue框架写的。...
mpVue高仿美团小程序教程mpvue-meituan-master.zip uni APP自动更新并安装.vue uni-app nvue沉浸式状态栏(线性渐变色).vue uni-app 二维码生成器分享wxqrcode.zip uni-app 侧边导航分类,适合商品分类页面uni-app...
高仿美团小程序教程 APP自动更新并安装 沉浸式状态栏(线性渐变色) 二维码生成器分享 侧边导航分类,适合商品分类页面 自定义底部导航栏 全局变量的几种实现方式 富文本编辑器插件 自定义导航栏 聊天实例,支持图片,...
包含前端、后端、移动开发、操作系统、人工智能、物联网、信息化管理、数据库、硬件开发、大数据、课程资源、音视频、网站开发等各种技术项目的源码。 包括STM32、ESP8266、PHP、QT、Linux、iOS、C++、Java、python...
mpVue高仿美团小程序教程 见博客:
mpVue高仿美团小程序教程mpvue-meituan-master.zip uni APP自动更新并安装.vue uni-app nvue沉浸式状态栏(线性渐变色).vue uni-app 二维码生成器分享wxqrcode.zip uni-app 侧边导航分类,适合商品分类页面uni-app...
mpVue高仿美团小程序教程mpvue-meituan-master.zip uni APP自动更新并安装.vue uni-app nvue沉浸式状态栏(线性渐变色).vue uni-app 二维码生成器分享wxqrcode.zip uni-app 侧边导航分类,适合商品分类页面uni-app...
11k+ - 基于 Vue.js 的小程序开发框架,从底层支持 Vue.js 语法和构建工具体系Taro ★3.9k - 使用 React 的方式开发小程序的框架,同时支持生成多端应用Labrador ★1.5k - 支持 ES6/7 的微信小程序组件化开发框架...
使用 Vant Weapp 前,请确保你已经学习过微信官方的小程序简易教程 和自定义组件介绍 安装 方式一. 通过 npm 安装 (推荐) 小程序已经支持使用 npm 安装第三方包,详见npm 支持 # npm npm i vant-weapp -S --...