1、关于uni-app 框架配置:(下面这个是创建uni-app项目的基本目录结构)
pages.json 文件用来对uni-app 进行全局配置,决定页面文件路径,窗口样式,原生导航栏,底部的tabbar 等等。(类似于小程序 中的 app.sjon )
example:(下面这个是包含了所有配置选项的 pages.json )
{
"pages":[{
"path":"pages/index/index",
"style":{ // 用于设置每个页面的状态栏,导航条,标题,窗口背景色等
"navigationBarTitleText":"入口文件" ,//导航栏标题文字内容
"enablePullDownRefresh":true, // 开启下拉刷新
}
},{
"path":"pages/home/home",
"style":{
"navigationBarTitleText":"首页"
}
},{
"path":"pages/classify/classify",
"style":{
"navigationBarTitleText":"分类"
}
}],
"globalStyle":{ //用于设置应用的状态栏,导航条,标题,窗口背景色等
"navigationBarTextStyle":"black", //导航栏标题颜色及状态栏前景颜色,仅支持black/white
"navigationBarTitleText":"demo", // 导航栏标题文字内容
"navigationBarBackgroundColor":"#f7f7f7", // 导航栏背景颜色默认是 #f7f7f7
"backgroundColor":"#ffffff", // 窗口的背景颜色
"usingComponents":{} //引用小程序组件
},
"tabBar":{
"color":"#ffffff", // tab 上面的文字默认颜色
"selectedColor":"#00cf89", //tab 上文字选中时的颜色
"backgroundColor":"#ffffff", //tab 的背景色
"borderStyle":"black", // tabbar 上边框的颜色,可选值 black ,white
"height":"50px", // tabbar 默认高度
"fontSize":"10px", // 文字默认大小
"iconWidth":"24px", //图标默认宽度 等比例缩放
"spacing":"3px", // 图标和文字的间距
"list":[{ // tab 列表
"pagePath":"pages/home/home",
"iconPath":"static/image/img.png",
"selectedIconPath":"static/image/img_on.png",
"text":"home"
},{
"pagePath":"pages/classify/classify",
"iconPath":"static/image/ify.png",
"selectedIconPath":"static/image/ify_on.png",
"text":"classify"
}],
"midButton":{ // 中间按钮 ,仅在 list 项为偶数时有效
"width":"80px",
"height":"50px",
"text":"text",
"iconPath:"static/image/btn.png",
"iconWidth":"24px",
"backgroundImage":"static/image/btn_on.png"
}
}
}
////////////////////////////////////////////////////
mainfest.json 文件是应用的配置的文件,用于指定应用的名称,图标,权限等。
name://应用名称
appid://应用标识,新建uni-app项目时,dcloud 云端分配。
description://应用描述
versionName://版本名称
versionCode://版本号
transformPX://是否转换项目的px,为true,将px转换为rpx.
////////////////////////////////////////////////////
package.json 文件增加 uni-app 扩展点,可实现自定义条件编译平台。
配置用法:
{
"uni-app":{
"scripts":{
"custom-platform":{
"title":"自定义扩展名称",
"BROWSER":"",//运行到目标浏览器
"env":{
"UNI_PLATFROM":"",//基准平台
},
"define":{
"CUSTOM-CONST":true //自定义条件编译常量
}
}
}
}
}
///////////////////////////////////////////////////
注意 vue.config.js 这个文件,如果打包的话,是需要这个的哦,一般用于配置 webpack 等编译选项
module.exports = function(){
publicPath:'/'
}
/////////////////////////////////////////////////
uni.scss 文件的用途是 为了方便 整体控制应用的风格。
需要在hbuilderx 里面安装 scss 插件;使用时还要在 style节点 加上 lang="scss"
////////////////////////////////////////////////
App.vue 是 uni-app的主组件,所有页面都是在 App.vue 下进行切换的,是页面入口文件。
但他本身不是页面,不能编写视图元素。
文件作用包括:调用 应用生命周期函数,配置全局样式,配置全局的存储 globalData.
应用生命周期仅在 App.vue 中监听,在页面监听无效。
应用生命周期函数:
onLaunch : 当uni-app初始化完成时触发 (全局只触发一次)
onShow : 当 uni-app启动,或从后台进入前台显示
onHide : 当 uni-app从前台进入后台
onError : 当 uni-app 报错时触发
在 App.vue 中定义 globalData 配置:
export default {
globalData:{
text:'text'
}
}
js 中操作 globalData 的方式如下 : getApp().globalData.text = 'test';
在应用 onLaunch 时,getApp 对象还未获取,暂时可以使用 this.$scope.globalData 获取globalData.
全局样式,在 App.vue 中,引用共同的css文件方式: @import '../../common/common.css';
//////////////////////////////////////////////
main.js 是uni-app 的入口文件,主要作用是初始化 vue 实例,定义全局组件,使用需要的插件如vuex。
首先引入了 vue库和App.vue ,创建了一个vue实例,并且挂载vue实例。
import Vue from 'vue';
import App from './App';
import pageHead from './components/page-head.vue';//全局引用page-head组件
Vue.config.productionTip = false;
Vue.component('page-head',pageHead);//全局注册 page-head 组件,每个页面将可以直接使用该组件
App.mpType = 'app';
const app = new Vue({
...App
})
app.$mount();//挂载Vue 实例
//////////////////////////////////////////////////
提示:
在 hbuilderx 中 ,输入 clog 可以直接输出 console.log();
输入 clogv 可直接输出 console.log(":"+ );
2、页面生命周期
onLoad(){} 监听页面加载,其参数为上个页面传递的数据,参数类型object,用于页面传参。
onShow(){} 监听页面显示。页面每次出现在屏幕上都触发,包括从下级页面点返回露出当前页面。
onReady(){} 监听页面初次渲染完成,注意如果渲染速度快,会在页面进入动画完成前触发。
onHide(){} 监听页面隐藏
onUnload(){} 监听页面卸载
onResize(){} 监听窗口尺寸变化 (app,微信小程序)
onPullDownRefresh(){} 监听用户下拉动作,一般用于下拉刷新
onReachBottom(){} 页面滚动到底部的事件不是scroll-view,常用语下拉下一页数据
onBackPress(){} 监听页面返回,返回 event = {from:backbutton,navigateBack},backbutton 表示来源是左上角返回按钮,navigateBack表示来源是 uni.navigateBack
3、组件生命周期
//uni-app 组件支持的生命周期与 vue的相同。
beforeCreate(){} 在实例初始化之后被调用
created(){} 在实例创建完成后被立即调用
beforeMount(){} 在挂载开始之前被调用
mounted(){} 挂载到实例上去之后调用
beforeUpdate(){} 数据更新时调用
updated(){} 由于数据更改导致的虚拟dom重新渲染和打补丁,在这之后会调用该钩子
beforeDestroy(){} 实例销毁之前调用
destroyed(){} vue 实例销毁后调用,调用后,vue实例指示的所有东西都会解绑定,所有的事件监听器都会被移除,所有的子实例也会被销毁。
4、页面
getApp() 函数用于获取当前应用实例,一般用于获取 globalData。
实例:
const app = getApp();
console.log(app.globalData);
getCurrentPages()函数用于获取当前页面栈的实例,以数组的形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。
getCurrentPages() 可以得到所有页面对象,然后根据数组,可以取指定的页面 webview 对象。
var pages = getCurrentPages();
var page = pages[pages.length-1];
var currentWebview = page.$getAppWebview();
consol.elog(currentWebview.id);//获取当前 webview 的id值。
注意:
navigateTo,redirectTo 只能打开非tabBar 页面。
switchTab 只能打开 tabBar 页面。
reLaunch 可以打开任意页面。
5、页面通讯
uni.$emit(eventName,object);//事件名,触发事件携带的附加参数 触发全局的自定事件。附加参数都会传给监听器回调。
uni.$emit('update',{msg:'页面更新'})
uni.$on(eventName,callback); //监听全局的自定义事件,事件可以由 uni.$emit触发,回调函数会接收所有传入事件触发函数的额外参数
uni.$on('update',function(data){
console.log('监听到事件来自 update ,携带参数为 ' +data.msg)
})
uni.$once(eventName,callback); // 监听全局的自定义事件。事件可以由 uni.$emit触发,但是只触发一次,在第一次触发之后移除监听器。
uni.$once('update',function(data){
console.log('监听 update 事件'+data.msg)
})
uni.$off([eventName,callback]) 移除全局自定义事件监听器
uni.$off('update',function(data){
})
注意: 使用时,要及时销毁事件监听,比如,页面 onLoad 里面uni.$on 注册监听,onUnload 里面 uni.$off 移除。 或一次性的事件,直接使用 uni.$once 监听 。
6、网络请求
//对于 get方法,会将数据转换为 query string 。 例如{ name:'name',age:18} 转换后的结果是 name=name&age=18
// 对于 post方法 且 header['content-type'] 为 application/json 的数据,会进行 JSON 序列化。
// 对于 post 方法 且 header['content-type'] 为 application/x-www-form-urlencoded 的数据,会将数据转换为 query string 。
example:
uni.request({
url:'',//接口地址,
data:{ // 参数
name:'name'
},
method:'GET',
header:{
'content-type':'applicaiton/json' //自定义请求头信息
},
success:(res)=>{
console.log(res,'success')
},
fail:(err)=>{
console.log(err,'fail')
}
})
7、上传,下载文件,图片类
//将本地资源上传到开发者服务器,客户端发起一个post请求,其中 content-type 为 multipart/form-data 。
uni.chooseImage({
count:1,
sizeType:['original','compressed'],
sourceType:['album','camera'],
success:(chooseImageRes)=>{
const tempFilePaths = chooseImageRes.tempFilePaths;
uni.uploadFile({
url:'',//服务器地址
filePath:tempFilePaths[0],
name:'file',
formData:{
'user':'test'
},
success:(uploadFileRes)=>{
console.log(uploadFileRes)
}
})
}
})
//下载文件资源到本地,客户端发起get请求,返回文件的本地临时路径
uni.downloadFile({
url:'',//接口地址
success:(res)=>{
console.log(res)
}
})
还有很多 api 要到官网看哦。
最近在用uni-app 开发,说一下自己的创建项目流程,以及打了一个测试demo版瞅瞅的过程
编辑器还是 选用的 HBuilderX 哒,左上角有个文件,点击文件,选择新建文件,再选择项目,会弹出下面这个框,然后选择uni-app哦。
填写项目名称,点击创建,至此,这个项目就创建成功了。
然后再该项目中新建一个 vue.config.json 文件,内容照1里面配置即可。
在HBuilderX 标题栏会看到一个 发行 ,点击 会出现一个 原生 App-打包,选择后,会弹出下面这个框,选择红框标记处,最后点击打包按钮即可。
注意: 打包成功后,会有一个地址下载该应用,但是只能下载5次哦。