MINA是微信开发小程序的框架:
MINA的目标是通过尽可能简单,高效的方式让开发者可以在微信中开发具有原生APP体验的服务。
运行MINA的项目必须要有微信web开发者工具和微信小程序的AppID,因为现在还处于内测阶段的原因,因此大部分数人还没有AppID,还好有大神已经破解了IDE,可以先体验下,详情请参考微信小程序开发资料收集
MINA框架中有四种类型的文件:
- .js文件 基于JavaScript的逻辑层框架
- .wxml 视图层文件,是MINA设计的一套标签语言
- .wxss 样式文件,用于描述WXML的组件样式
- .json 文件,配置文件,用于单个页面的配置和整个项目的配置
目录结构
为了减少配置项,小程序中一个页面中的四个文件必须要有相同的路径和文件名,使用微信web开发者工具新建一个项目,可以看到他的目录结构是这样的:
其中app.js是程序的入口,app.json是项目的配置文件,app.wxss是全局配置的样式文件,logs和index文件夹是是单个页面的文件,utils用来存放常用的工具类文件夹。
app.js
app.js使用App()函数注册一个小程序,可以指定小程序的生命周期
小程序的App()生命周期中三个事件可以监听:onLaunch,onShow,onHide。
- onLaunch:小程序加载完成之后调用,全局只触发一次
- onShow: 小程序启动,或者从后台到前台会触发一次
- onHide:小程序从前台到后台会触发一次
例如:
- App({
- onLaunch: function () {
- console.log('App Launch')
- },
- onShow: function () {
- console.log('App Show')
- },
- onHide: function () {
- console.log('App Hide')
- },
- globalData: {
- hasLogin: false
- }
- })
其中app.js的globalData可以设置全局的变量,在一个页面中可以通过getApp()函数获取小程序的实例,使用App的getCurrentPage()可以获取到当前页面的实例。
app.json
app.json是小程序的全局配置包括:页面的路径,窗口表现,设置网络超时,开发模式等...
- 页面配置pages:设置页面的路径
- "pages":[
- "pages/index/index",
- "pages/logs/logs"
- ]
配置的index和logs两个页面的路径,在这里使用相对路径配置页面路径。
- 窗口配置windows:用来配置状态栏的颜色,导航条的样式和颜色,标题,已经窗口的背景色:
- "window":{
- "backgroundTextStyle":"light",
- "navigationBarBackgroundColor": "#ffffff",
- "navigationBarTitleText": "WeChat",
- "navigationBarTextStyle":"black"
- }
使用的Color为十六进制的颜色值,比如"#ffffff"
注意:
其中navigationBarTextStyle,导航栏的颜色仅支持black/white。
而backgroundTextStyle,下拉背景的样式仅支持dark/light。
- tabBar: 设置tab应用,tabBar是一个数组,最少需要配置2个,最多能配置5个tab,tab按照数据的顺序排序:
- "tabBar":{
- "color":"#dddddd",
- "selectdColor":"#3cc51f",
- "borderStyle":"black",
- "backgroundColor":"#ffffff"
- ,"list":[
- {
- "pagePath":"pages/index/index",
- "iconPath":"image/wechat.png",
- "selectedIconPath":"image/wechatHL.png",
- "text":"主页"
- },{
- "pagePath":"pages/logs/logs",
- "iconPath":"image/wechat.png",
- "selectedIconPath":"image/wechatHL.png",
- "text":"日志"
- }]
- }
这里设置了两个tab页:index和log,效果如下:
- networkTimeout设置网络请求的超时时间,小程序有四种类型的网络请求
- wx.request普通的http请求,配置为request
- wx.connect stock链接,配置为connectSocket
- wx.uploadFile上传文件,配置为uploadFile
- wx.downloadFile下载文件,配置为downloadFile
配置单位为毫秒,例如:
- "networkTimeout": {
- "request": 10000,
- "connectSocket": 10000,
- "uploadFile": 10000,
- "downloadFile": 10000
- }
- debug:开发工具中开启debug模式,在控制台面板上可以看到调试信息,我们也可以使用console.log('onLoad')输入log帮助我们调试程序。
- "debug": true
app.wxss
app.wxss中定义的的样式为全局样式,作用在每一个页面,在page中定义的.wxss文件为局部样式,只作用在局部,局部样式中的定义会覆盖app.wxss中定义的样式。
样式的定义:
- .container {
- height: 100%;
- display: flex;
- flex-direction: column;
- align-items: center;
- justify-content: space-between;
- padding: 200rpx 0;
- box-sizing: border-box;
- }
其中200rpx中的rpx是reponslve pixel,可以根据屏幕的宽度进行自适应,在iPhone6上1rpx=0.5px=1物理像素。微信小程序建议设计以iPhone6为准
样式的使用:
- <view class="container">
- </view>
page
使用Page()函数来注册一个页面,为其指定页面的初始数据,生命周期函数,事件处理等。
- data 页面的初始数据,可以使用setData更新定义的数据
- onLoad 页面加载事件
- onReady 页面渲染完成
- onShow 页面显示
- onHide 页面隐藏
- onUnload 页面卸载
例如:
- Page({
- data: {
- logs: []
- },
- onLoad: function () {
- this.setData({
- logs: (wx.getStorageSync('logs') || []).map(function (log) {
- return util.formatTime(new Date(log))
- })
- })
- }
- })
page另外使用的文件.wxml是页面文件,使用定义好一套标签语言,.wxss是局部样式文件,.json局部配置文件比如需要在一个单独的页面中设置他的navigationBarTitleText,可以在.json文件中设置:
- {
- "navigationBarTitleText": "日志文件"
- }