Uni-App-02

条件编译

条件编译概念

不同的运行平台终归有些专有的特性,无法实现跨平台完全兼容,例如:微信小程序导航栏右上角的关闭图标。

uni-app提供了一种"条件编译"机制,可以针对特定的平台编译执行特定的代码,否则不执行。

条件编译语法

语法如下:

#ifdef H5 仅在H5平台下编译执行的代码 #endif
#ifdef H5 || APP || MP-WEIXIN 仅在H5和APP和微信小程序平台下编译执行的代码 #endif
#ifndef H5 仅在非H5平台下编译执行的代码 #endif

说明:

​ ①条件编译语句可以编写在template / style / script 等各类代码中。

​ ②更多的条件编译平台可以参见手册:https://uniapp.dcloud.io/platform

条件编译示例

html中使用

js中使用

css中使用

项目开发准备

标准开发流程

大型项目的软件生命周期:

阶段名称 负责人 主要内容 主要产出
1 可行性研究 产品经理、项目经理、项目设计师 技术、人员、时间、资金、投入产出比、政策法规、风俗、用户 《可行性研究报告》
2 需求分析 需求分析师 功能性需求点:要完成的功能 非功能性需求点:性能、安全、可用性 《需求规约》 《需求规格说明书》
3 概要设计 项目架构师 系统结构、网络、硬件、前端、后端、子系统、模块、技术选型 《概要设计说明书》
4 详细设计 项目设计师 页面体系、功能体系、组件、类、方法和属性、具体算法 《详细设计说明书》
5 开发实现 UI设计师 前端工程师 后端工程师 出设计图、 编写前端页面、前后端联调 编写后端接口、前后端联调 《开发卷宗》 《开发日志》
6 测试 测试工程师 测试功能性需求、非功能性需求 《测试报告》
7 项目部署 项目实施工程师 布置网络环境、硬件设备、软件环境、项目部署 《项目实施报告》
8 维护阶段 系统运维工程师 监控系统性能、安全、小功能点维护 《项目运维日志》

小型项目的简化版流程:

阶段名称 负责人 主要内容 主要产出
1 项目设计 项目架构师/设计师/产品经理 体系结构、前后端技术选型、子系统划分、模块化、功能点设计 《项目原型设计》
2 UI设计 UI/UE设计师 图标、图片、页面布局、用户交互反馈 《项目设计稿》
3 前端开发 前端开发工程师 编写页面、调用后台接口数据 《项目开发日志》
4 后端开发 后端开发工程师 编写数据库、开发后台接口、实现业务逻辑 《项目开发日志》
5 测试 测试工程师 手工测试、自动化测试各项功能、非功能 《测试报告》
6 部署实施 项目实施工程师 搭建软硬件环境、部署项目、监控性能

项目前端团队每日的工作流程:

人员 工作内容
项目创始人 ①创建空白项目 ②创建所有必需的页面组件(pages),分配好路由词典 ③创建所有必需的公共组件(components),每个组件的功能说明完成 ④创建后台接口的封装模块,规定好每个方法的名称/参数/返回值 ⑤创建全局的样式变量、公共样式 ⑥把上述内容提交的项目仓库
项目组员 ①早上:开晨会,讲解项目背景、目标任务,分解职责 ②上午:拉取项目仓库中的内容到本地仓库,开始一天的工作 ③晚上:把自己的工作成果提交公共仓库,下班回家 ④第二天早上:开晨会,汇总进度、目标任务,分解职责 ⑤第二天上午:从公共仓库拉取最新内容,开始一天的工作 ...

开发流程手册

配置uni.scss

uni.scss中配置了全局样式变量用于在其他页面中引用,便于统一管理

很多第三方组件也会使用此处的样式变量

/* 颜色变量 */
$zh-theme-color: #090;				//智慧社区项目的主题色
$zh-theme-color-light: #6EDA0C;		//主题色的浅色
$zh-theme-color-lighter: #7AC67A;	//主题色的更浅色
$zh-theme-color-inverse: #CCCC99;	//主题色的反色
$zh-theme-grey-dark:#000000;		//主题灰的深色
$zh-theme-grey:#363636;				//主题灰
$zh-theme-grey-light:#8A8A8A;		//主题灰的浅色
$zh-theme-grey-lighter:#F2F2F2;		//主题灰的更浅色

/* 行为相关颜色 */
$uni-color-primary: #007aff;		//TODO: 此值应该根据设计稿进行修改
$uni-color-success: #4cd964;		//TODO: 此值应该根据设计稿进行修改
$uni-color-warning: #f0ad4e;		//TODO: 此值应该根据设计稿进行修改
$uni-color-error: #dd524d;			//TODO: 此值应该根据设计稿进行修改

/* 文字基本颜色 */
// $uni-text-color:#333;			//基本色
$uni-text-color: $zh-theme-grey;	//基本色,#363636
$uni-text-color-inverse:#fff;		//反色
// $uni-text-color-grey:#999;		//辅助灰色,如加载更多的提示信息
$uni-text-color-grey:$zh-theme-grey-light;			//辅助灰色,#8A8A8A
// $uni-text-color-placeholder: #808080;
$uni-text-color-placeholder: $zh-theme-grey-light;  //#8A8A8A
$uni-text-color-disable:#c0c0c0;

/* 背景颜色 */
$uni-bg-color:#ffffff;
// $uni-bg-color-grey:#f8f8f8;
$uni-bg-color-grey:$zh-theme-grey-lighter;	//#f2f2f2
$uni-bg-color-hover:#f1f1f1;				//点击状态颜色	
$uni-bg-color-mask:rgba(0, 0, 0, 0.4);		//遮罩颜色

/* 边框颜色 */
$uni-border-color:#c8c7cc;					//边框颜色
$uni-border: 1px  solid  $uni-border-color;	//边框样式

/* 尺寸变量 */

/* 文字尺寸 */
$uni-font-size-sm:12px;
$uni-font-size-base:14px;
$uni-font-size-lg:16px;						//注意:此处需要补全px

/* 图片尺寸 */
$uni-img-size-sm:20px;
$uni-img-size-base:26px;
$uni-img-size-lg:40px;

/* Border Radius */
$uni-border-radius-sm: 2px;
$uni-border-radius-base: 3px;
$uni-border-radius-lg: 6px;
$uni-border-radius-circle: 50%;

/* 水平间距 */
$uni-spacing-row-sm: 5px;				//横向间距-小号(small)
$uni-spacing-row-base: 10px;			//横向间距-中等号
$uni-spacing-row-lg: 15px;				//横向间距-大号(large)

/* 垂直间距 */
$uni-spacing-col-sm: 4px;				//纵向间距-小号
$uni-spacing-col-base: 8px;				//纵向间距-中等号
$uni-spacing-col-lg: 12px;				//纵向间距-大号

/* 透明度 */
$uni-opacity-disabled: 0.3; // 组件禁用态的透明度

/* 文章场景相关 */
$uni-color-title: #2C405A; // 文章标题颜色
$uni-font-size-title:20px;
$uni-color-subtitle: #555555; // 二级标题颜色
$uni-font-size-subtitle:26px;
$uni-color-paragraph: #3F536E; // 文章段落颜色
$uni-font-size-paragraph:15px;

配置全局样式App.vue

1、uni-app支持的尺寸单位:em、vw/vh、%、px、rpx

2、多个页面或组件共享的样式变量编写在 uni.scss;

3、多个页面或组件共享的样式编写在 App.vue;

4、uni-app中禁止使用 * { } 选择器 ------ 小程序不支持;使用 :not(not){ } 来代替

5、uni-app中禁止使用 body { } 选择器 ------ 小程序不支持;使用 page{ } 来代替

6、uni-app或所有的移动端应用中,推荐在容器上使用"弹性布局"

<!-- 注意:此处必须声明使用SCSS!!否则无法使用SCSS变量!! -->
<style lang="scss">
	/*每个页面共用的公共样式 */
	//选择所有的元素
	:not(not) {
		//提示:uni-app提供的内置组件默认都不带内外边距
		//简化盒子模型的计算方案,由默认的内容盒子改为边框盒子
		// box-sizing: content-box;//默认值,总宽度=margin+bordder+padding+width
		box-sizing: border-box;  //总宽度=margin+width
	}
	//选择每个页面的根元素(用page代替body)
	page {
		background-color: $uni-bg-color-grey;
	}
	//选择所有的容器元素,都采用弹性布局
	view {
		//显示模式:弹性容器
		display: flex;
		//弹性容器中的子元素主轴方向:横向
		flex-direction: row;
	}
	//选择每个页面最外层的容器元素,弹性主轴改为纵向
	view.content {
		//弹性容器中子元素的排列主轴方向:纵向
		flex-direction: column;
	}
</style>

小程序、uni-app支持的全新尺寸单位:Responsive Pixel ------ rpx,响应式像素数

因为不同的手机屏幕尺寸不同,如果做适配的话,传统的尺寸很麻烦;小程序引入了全新的尺寸单位,rpx ------ 不论实际物理屏幕尺寸有多大,一律认为是750rpx

320px <=> 750rpx

360px <=> 750rpx

414px <=> 750rpx

这样一来,假设有个图片占屏幕宽度一半,width应该设定为 750rpx/2 = 375rpx

小测验:

有个按钮在360px的屏幕下,显示宽度是200px;如果转换为rpx的话,应该是多少?

360px 750rpx

-------- = -------- ? = 750*200/360 = 416.667

200px ?rpx

登录功能开发

状态栏开发

<!-- F1:手机系统状态栏设定 -->
<view class="status-bar" :style="{height: statusBarHeight+'px'}"></view>

<script>
	export default {
		data(){
			return {
				statusBarHeight: 0,		//系统状态栏高度
			}
		},
		//生命周期方法 ------ 页面挂载完成
		onLoad(){    //此处此方法类似于mounted()
			//console.log('login组件挂载完成')
			//获取系统信息,读取其中的"状态栏高度"
			let {statusBarHeight} = uni.getSystemInfoSync()
			// console.log('屏幕高度:', screenHeight);
			this.statusBarHeight = statusBarHeight
		},
		methods: {
		}
	}
</script>

.status-bar {
	background-color: $zh-theme-color;
	width: 750rpx;		//宽度占满一整行
	//height: 30rpx;		//高度:临时
	position: fixed;	//固定定位
}

logo图片开发

①默认image的尺寸都是320px*240px,不论原始尺寸

②默认情况下,修改图片的宽度,高度不会自动等比例缩放

③可以指定mode="widthFix",实现"宽度固定,高度自动等比例缩放"

<!-- F2:LOGO -->
<!-- mode:图片的缩放模式  widthFix:宽度使用指定的固定值,高度自动等比例缩放 -->
<image src="../../static/img/logo.png" class="logo" mode="widthFix"/>

.logo {
	width: 450rpx;
	// height: 450rpx;
	// block或inline-block使用左右margin:auto实现水平居中
	margin: $uni-spacing-col-lg*6   auto   0;
}

手机号输入框开发

input:输入框组件,注意:它的属性与HTML5中的input是不一样的

例如:type="text/number/digit/idcard"指定的是弹出来的键盘类型
uni-icons

扩展组件,代表图标的组件,需要提前安装

内置了大量图标可以直接使用

<!-- F3:手机号码输入框组 -->
<!-- 提示:真正的App开发中,input就是没有初始样式的,都需要自己指定 -->
<view class="input-group">
    <input class="input" placeholder="请输入手机号"/>
    <uni-icons class="icon left" type="phone-filled" size="25px" color="#090"/>
    <uni-icons class="icon right" type="clear" size="22px" color="#1296DB"/>
</view>

.input-group {
	position: relative;
	margin: $uni-spacing-col-lg*3  $uni-spacing-row-lg   0;
	//弹性容器中的子元素在交叉轴上居中对齐
	align-items: center;
	.input {
		font-size: $uni-font-size-base;
		border: 1px solid $zh-theme-color;
		border-radius: $uni-border-radius-base;
		width: 100%;
		padding: 0  $uni-spacing-row-base*3;
		height: $uni-font-size-lg*2.2;  //注意:此处不能使用line-height
	}
	.icon {
		position: absolute;
		&.left { left:$uni-spacing-row-sm; }
		&.right { right:$uni-spacing-row-sm; }
	}
}

密码输入框开发

<!-- F4:密码输入框组  -->
<view class="input-group pwd-group">
    <input :password="hidePwd" class="input" placeholder="请输入密码"/>
    <uni-icons class="icon left" type="locked-filled" size="25px" color="#090"/>
    <uni-icons class="icon right" :type="hidePwd ? 'eye-slash-filled' : 'eye-filled'"  
    	@click="hidePwd = !hidePwd" size="22px" color="#8a8a8a"/>
</view>

export default {
		data(){
			return {
				statusBarHeight: 0,		//系统状态栏高度
				hidePwd: true,			//是否隐藏密码
			}
		},
		//生命周期方法 ------ 页面挂载完成
		onLoad(){    //此处此方法类似于mounted()
			//console.log('login组件挂载完成')
			//获取系统信息,读取其中的"状态栏高度"
			let {statusBarHeight} = uni.getSystemInfoSync()
			// console.log('屏幕高度:', screenHeight);
			this.statusBarHeight = statusBarHeight
		},
		methods: {
		}
	}
</script>

.input-group {
	position: relative;
	margin: $uni-spacing-col-lg*3  $uni-spacing-row-lg   0;
	//弹性容器中的子元素在交叉轴上居中对齐
	align-items: center;
	&.pwd-group {
		margin-top: $uni-spacing-col-lg*2;
	}
	.input {
		font-size: $uni-font-size-base;
		border: 1px solid $zh-theme-color;
		border-radius: $uni-border-radius-base;
		width: 100%;
		padding: 0  $uni-spacing-row-base*3;
		height: $uni-font-size-lg*2.2;  //注意:此处不能使用line-height
	}
	.icon {
		position: absolute;
		&.left { left:$uni-spacing-row-sm; }
		&.right { right:$uni-spacing-row-sm; }
	}
}

提交按钮开发

<!-- F5:提交按钮 -->
<button class="btn" @click="doLogin">登 录</button>

.btn {
	margin: $uni-spacing-col-lg*2.5  $uni-spacing-row-lg 0;
	background: $zh-theme-color;
	color: $uni-text-color-inverse;
	font-size: $uni-font-size-base;
	//SCSS函数:darken(颜色, 百分比),返回一个更深的颜色值
	//SCSS函数:lighten(颜色, 百分比),返回一个更浅的颜色值
	&:active {
		background-color: darken($zh-theme-color, 5%);
	}
}

找回密码开发

navigator:导航器,功能类似于HTML5中的超链接a

<!-- F6:找回密码 -->
<!-- 导航跳转/保留跳转 -->
<navigator class="find" open-type="navigate" url="/pages/feePay/feePay">找回密码</navigator>
<!-- 重定向跳转/销毁跳转 -->
<!-- <navigator class="find" open-type="redirect" url="/pages/feePay/feePay">找回密码2</navigator> -->
<!-- 切换页签页 -->
<!-- <navigator class="find" open-type="switchTab" url="/pages/my/my">找回密码3</navigator> -->

.find {
	text-align: center;
	color: $zh-theme-color;
	margin-top: $uni-spacing-col-lg*2;
}

媒体自适应(屏幕适配)

//针对高度小于500px的屏幕,减小顶部留白
@media screen and (max-height: 500px) {
	.logo {
		margin-top: $uni-spacing-col-lg;
	}
}
//针对高度大于700px的屏幕,增大顶部留白
@media screen and (min-height: 700px) {
	.logo {
		margin-top: $uni-spacing-col-lg*12;
		margin-bottom: $uni-spacing-col-lg*4;
	}
}

登录功能实现

接口参数 参考 <<智慧社区API说明书.docx>>
数据双向绑定获取电话号和密码

点击登录按钮,校验电话号密码

如果格式错误,弹出吐司提示

如果格式正确,发出Ajax请求登录用户

登录失败,弹出吐司提示

登录成功呢,跳转到主页

<!-- F3:手机号码输入框组 -->
<!-- 提示:真正的App开发中,input就是没有初始样式的,都需要自己指定 -->
<view class="input-group">
    <input v-model="phone" class="input" placeholder="请输入手机号"/>
    <uni-icons class="icon left" type="phone-filled" size="25px" color="#090"/>
    <uni-icons class="icon right" type="clear" size="22px" color="#1296DB"/>
</view>
<!-- F4:密码输入框组  -->
<view class="input-group pwd-group">
    <input v-model="pwd" :password="hidePwd" class="input" placeholder="请输入密码"/>
    <uni-icons class="icon left" type="locked-filled" size="25px" color="#090"/>
    <uni-icons class="icon right" :type="hidePwd ? 'eye-slash-filled' : 'eye-filled'"  
    	@click="hidePwd = !hidePwd" size="22px" color="#8a8a8a"/>
</view>

<script>
	export default {
		data(){
			return {
				statusBarHeight: 0,		//系统状态栏高度
				hidePwd: true,			//是否隐藏密码
				phone: "13501234567",	//用户输入的登录手机号
				pwd:"123456",			//用户输入的登录密码
			}
		},
		//生命周期方法 ------ 页面挂载完成
		onLoad(){    //此处此方法类似于mounted()
			//console.log('login组件挂载完成')
			//获取系统信息,读取其中的"状态栏高度"
			let {statusBarHeight} = uni.getSystemInfoSync()
			// console.log('屏幕高度:', screenHeight);
			this.statusBarHeight = statusBarHeight
		},
		methods: {
			async doLogin(){
				//console.log('当前输入:',this.phone, this.pwd)
				//1.验证手机号是否合法,不合法就弹出提示框,退出执行
				if(!/^1[3-9]\d{9}$/.test(this.phone)){
					uni.showToast({
						title: '手机号非法',		//提示标题
						icon: 'none',			//图标
						duration: 3000			//持续时长 
					})
					return
				}
				//2.验证密码是否合法,不合法就弹出提示框,退出执行
				if(this.pwd.length < 6){
					uni.showToast({
						title:'密码格式非法',
						icon: 'none',
						duration: 3000
					})
					return 
				}
				//3.把手机号/密码提交给服务器端数据API,进行登录验证
				let url = "https://www.codeboy.com/zhsqapi/user/list"
				let [err, res] = await uni.request({
					url
				})
				if(err){
					console.log('异步请求失败!错误原因:'+err.errMsg)
				}else {
					console.log("请求成功!服务器返回响应消息主体: " + res.data)
				}
				//4.登录成功,提示"欢迎回来",跳转到首页
			},
		}
	}
</script>

完整代码

<template>
	<view class="content">
		<!-- F1:手机系统状态栏设定 -->
		<view class="status-bar" :style="{height: statusBarHeight+'px'}"></view>
		
		<!-- F2:LOGO -->
		<!-- mode:图片的缩放模式  widthFix:宽度使用指定的固定值,高度自动等比例缩放 -->
		<image src="../../static/img/logo.png" class="logo" mode="widthFix"/>
		
		<!-- F3:手机号码输入框组 -->
		<!-- 提示:真正的App开发中,input就是没有初始样式的,都需要自己指定 -->
		<view class="input-group">
			<input v-model="phone" class="input" placeholder="请输入手机号"/>
			<uni-icons class="icon left" type="phone-filled" size="25px" color="#090"/>
			<uni-icons class="icon right" type="clear" size="22px" color="#1296DB"/>
		</view>
		<!-- F4:密码输入框组  -->
		<view class="input-group pwd-group">
			<input v-model="pwd" :password="hidePwd" class="input" placeholder="请输入密码"/>
			<uni-icons class="icon left" type="locked-filled" size="25px" color="#090"/>
			<uni-icons class="icon right" :type="hidePwd ? 'eye-slash-filled' : 'eye-filled'"  @click="hidePwd = !hidePwd" size="22px" color="#8a8a8a"/>
		</view>
		<!-- F5:提交按钮 -->
		<button class="btn" @click="doLogin">登 录</button>
		<!-- F6:找回密码 -->
		<!-- 导航跳转/保留跳转 -->
		<navigator class="find" open-type="navigate" url="/pages/feePay/feePay">找回密码</navigator>
		<!-- 重定向跳转/销毁跳转 -->
		<!-- <navigator class="find" open-type="redirect" url="/pages/feePay/feePay">找回密码2</navigator> -->
		<!-- 切换页签页 -->
		<!-- <navigator class="find" open-type="switchTab" url="/pages/my/my">找回密码3</navigator> -->
	</view>
</template>

<script>
	import { userLogin } from '../../service/'
	export default {
		data(){
			return {
				statusBarHeight: 0,		//系统状态栏高度
				hidePwd: true,			//是否隐藏密码
				phone: "13501234567",	//用户输入的登录手机号
				pwd:"123456",			//用户输入的登录密码
			}
		},
		//生命周期方法 ------ 页面挂载完成
		onLoad(){    //此处此方法类似于mounted()
			//console.log('login组件挂载完成')
			//获取系统信息,读取其中的"状态栏高度"
			let {statusBarHeight} = uni.getSystemInfoSync()
			// console.log('屏幕高度:', screenHeight);
			this.statusBarHeight = statusBarHeight
		},
		methods: {
			async doLogin(){
				//console.log('当前输入:',this.phone, this.pwd)
				//1.验证手机号是否合法,不合法就弹出提示框,退出执行
				if(!/^1[3-9]\d{9}$/.test(this.phone)){
					uni.showToast({
						title: '手机号非法',		//提示标题
						icon: 'none',			//图标
						duration: 3000			//持续时长 
					})
					return
				}
				//2.验证密码是否合法,不合法就弹出提示框,退出执行
				if(this.pwd.length < 6){
					uni.showToast({
						title:'密码格式非法',
						icon: 'none',
						duration: 3000
					})
					return 
				}
				//3.把手机号/密码提交给服务器端数据API,进行登录验证
				let url = "https://www.codeboy.com/zhsqapi/user/login"
				let [err, res] = await uni.request({ 
					url,
					method: 'POST',
					//header: { 'Content-Type': 'application/json'},
					header: { }, //请求内容类型默认就是JSON格式
					//data: `{"phone":"${this.phone}", "pwd":"${this.pwd}"}`
					//JSON系列化:把普通的JS对象转换为JSON格式的字符串
					//data: JSON.stringify( {phone:this.phone, pwd:this.pwd})
					//uni.request方法会自动根据请求内容类型,把数据转换为需要的格式
					data: {phone:this.phone, pwd:this.pwd}
				})
				if(err){
					console.log('执行失败:', err);
				}else {
					console.log('异步请求成功:', res);
				}
				//4.登录成功,提示"欢迎回来",跳转到首页
				if(data.code===2000){  	//登录成功
					//弹出一个"吐司"对话框
					uni.showToast({
						title: '欢迎回来',
						icon: 'none',			//图标:不要
						duration: 3000,			//持续时间:3s
						complete(){				//对话框成功关闭
							//跳转到"首页" ------ 切换页签
							uni.switchTab({
								url:'/pages/index/index'
							})
						}
					})
				}else {					//登录失败
					//弹出一个"模态"对话框
					uni.showModal({
						title: '错误',
						content: '登录失败!服务器返回消息:'+data.msg
					})
				}
			},
		}
	}
</script>

<style lang="scss" scoped>
.status-bar {
	background-color: $zh-theme-color;
	width: 750rpx;		//宽度占满一整行
	//height: 30rpx;		//高度:临时
	position: fixed;	//固定定位
}
.logo {
	width: 450rpx;
	// height: 450rpx;
	// block或inline-block使用左右margin:auto实现水平居中
	margin: $uni-spacing-col-lg*6   auto   0;
}
//针对高度小于500px的屏幕,减小顶部留白
@media screen and (max-height: 500px) {
	.logo {
		margin-top: $uni-spacing-col-lg;
	}
}
//针对高度大于700px的屏幕,增大顶部留白
@media screen and (min-height: 700px) {
	.logo {
		margin-top: $uni-spacing-col-lg*12;
		margin-bottom: $uni-spacing-col-lg*4;
	}
}
.input-group {
	position: relative;
	margin: $uni-spacing-col-lg*3  $uni-spacing-row-lg   0;
	//弹性容器中的子元素在交叉轴上居中对齐
	align-items: center;
	&.pwd-group {
		margin-top: $uni-spacing-col-lg*2;
	}
	.input {
		font-size: $uni-font-size-base;
		border: 1px solid $zh-theme-color;
		border-radius: $uni-border-radius-base;
		width: 100%;
		padding: 0  $uni-spacing-row-base*3;
		height: $uni-font-size-lg*2.2;  //注意:此处不能使用line-height
	}
	.icon {
		position: absolute;
		&.left { left:$uni-spacing-row-sm; }
		&.right { right:$uni-spacing-row-sm; }
	}
}
.btn {
	margin: $uni-spacing-col-lg*2.5  $uni-spacing-row-lg 0;
	background: $zh-theme-color;
	color: $uni-text-color-inverse;
	font-size: $uni-font-size-base;
	//SCSS函数:darken(颜色, 百分比),返回一个更深的颜色值
	//SCSS函数:lighten(颜色, 百分比),返回一个更浅的颜色值
	&:active {
		background-color: darken($zh-theme-color, 5%);
	}
}
.find {
	text-align: center;
	color: $zh-theme-color;
	margin-top: $uni-spacing-col-lg*2;
}
</style>

export let base = 'https://www.codeboy.com/zhsqapi/'
export let userLogin = async (phone, pwd)=>{
	//1.准备请求URL
	let url = base + 'user/login'
	//console.log(url)
	//2.显示"加载中"提示框
	uni.showLoading({
		title: '用户登录中'
	})
	//3.发起异步请求消息
	let [err, res] = await uni.request({
		url,
		method: 'POST',
		data: {phone, pwd}
	})
	//4.隐藏"加载中"提示框
	uni.hideLoading()
	//5.返回响应消息主体
	return res.data
}

导航跳转方式

导航跳转

在访问历史栈中保存当前页面,再打开下一个页面

<navigator open-type="navigate" url="">

返回跳转

返回访问历史栈中的上一个页面

<navigator  open-type="navigateBack">

重定向跳转/销毁跳转

不在历史栈中记录当前页面,直接跳转到下一个页面(无法返回)

<navigator  open-type="redirect"  url="">

切换页签跳转

查看指定页签页是否打开过,若有则再次显示;若无则打开并放到访问栈中

<navigator  open-type="switchTab"  url="">

重启跳转

销毁历史栈中的所有记录,重启应用,打开指定页面

<navigator  open-type="reLaunch"  url="">

提示信息

吐司提示

显示一个吐司对话框(不太严重,仅做提示)

uni.showToast({
	title: '标题',
	duration: 2000
});

OBJECT参数说明

参数 类型 必填 说明 平台差异说明
title String 提示的内容,长度与 icon 取值有关。
icon String 图标,有效值详见下方说明,默认:success。
image String 自定义图标的本地路径(app端暂不支持gif) App、H5、微信小程序、百度小程序
mask Boolean 是否显示透明蒙层,防止触摸穿透,默认:false App、微信小程序
duration Number 提示的延迟时间,单位毫秒,默认:1500
position String 纯文本轻提示显示位置,填写有效值后只有 title 属性生效,且不支持通过 uni.hideToast 隐藏。有效值详见下方说明。 App
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

icon 值说明

说明 平台差异说明
success 显示成功图标,此时 title 文本在小程序平台最多显示 7 个汉字长度。 支付宝小程序无长度无限制
error 显示错误图标,此时 title 文本在小程序平台最多显示 7 个汉字长度。 支付宝小程序、快手小程序、字节小程序、百度小程序、京东小程序、QQ小程序不支持
fail 显示错误图标,此时 title 文本无长度显示。 支付宝小程序、字节小程序
exception 显示异常图标。此时 title 文本无长度显示。 支付宝小程序
loading 显示加载图标,此时 title 文本在小程序平台最多显示 7 个汉字长度。 支付宝小程序不支持
none 不显示图标,此时 title 文本在小程序最多可显示两行,App仅支持单行显示。

模态提示

显示一个模态对话框(很严重,必需用户做出选择)

javascript 复制代码
uni.showModal({
	title: '提示',
	content: '这是一个模态弹窗',
	success: function (res) {
		if (res.confirm) {
			console.log('用户点击确定');
		} else if (res.cancel) {
			console.log('用户点击取消');
		}
	}
});

OBJECT参数说明

参数 类型 必填 说明 平台差异说明
title String 提示的标题
content String 提示的内容
showCancel Boolean 是否显示取消按钮,默认为 true
cancelText String 取消按钮的文字,默认为"取消"
cancelColor HexColor 取消按钮的文字颜色,默认为"#000000" H5、微信小程序、百度小程序、字节小程序(2.62.0+)
confirmText String 确定按钮的文字,默认为"确定"
confirmColor HexColor 确定按钮的文字颜色,H5平台默认为"#007aff",微信小程序平台默认为"#576B95",百度小程序平台默认为"#3c76ff" H5、微信小程序、百度小程序、字节小程序(2.62.0+)
editable Boolean 是否显示输入框 H5 (3.2.10+)、App (3.2.10+)、微信小程序 (2.17.1+)、字节小程序(2.62.0+)
placeholderText String 显示输入框时的提示文本 H5 (3.2.10+)、App (3.2.10+)、微信小程序 (2.17.1+)、字节小程序(2.62.0+)
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明

参数 类型 说明 平台差异说明
confirm Boolean 为 true 时,表示用户点击了确定按钮
cancel Boolean 为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭)
content String editable 为 true 时,用户输入的文本 H5 (3.2.10+)、App (3.2.10+)、微信小程序 (2.17.1+)、字节小程序(2.62.0+)

Ajax实现

uni.request(OBJECT)

发起网络请求。

OBJECT 参数说明

参数名 类型 必填 默认值 说明 平台差异说明
url String 开发者服务器接口地址
data Object/String/ArrayBuffer 请求的参数 App 3.3.7 以下不支持 ArrayBuffer 类型
header Object 设置请求的 header,header 中不能设置 Referer App、H5端会自动带上cookie,且H5端不可手动修改
method String GET 有效值详见下方说明
timeout Number 60000 超时时间,单位 ms H5(HBuilderX 2.9.9+)、APP(HBuilderX 2.9.9+)、微信小程序(2.10.0)、支付宝小程序
dataType String json 如果设为 json,会尝试对返回的数据做一次 JSON.parse
responseType String text 设置响应的数据类型。合法值:text、arraybuffer 支付宝小程序不支持
sslVerify Boolean true 验证 ssl 证书 仅App安卓端支持(HBuilderX 2.3.3+),不支持离线打包
withCredentials Boolean false 跨域请求时是否携带凭证(cookies) 仅H5支持(HBuilderX 2.6.15+)
firstIpv4 Boolean false DNS解析时优先使用ipv4 仅 App-Android 支持 (HBuilderX 2.8.0+)
enableHttp2 Boolean false 开启 http2 微信小程序
enableQuic Boolean false 开启 quic 微信小程序
enableCache Boolean false 开启 cache 微信小程序、字节跳动小程序 2.31.0+
enableHttpDNS Boolean false 是否开启 HttpDNS 服务。如开启,需要同时填入 httpDNSServiceId 。 HttpDNS 用法详见 移动解析HttpDNS 微信小程序
httpDNSServiceId String HttpDNS 服务商 Id。 HttpDNS 用法详见 移动解析HttpDNS 微信小程序
enableChunked Boolean false 开启 transfer-encoding chunked 微信小程序
forceCellularNetwork Boolean false wifi下使用移动网络发送请求 微信小程序
enableCookie Boolean false 开启后可在headers中编辑cookie 支付宝小程序 10.2.33+
cloudCache Object/Boolean false 是否开启云加速(详见云加速服务 百度小程序 3.310.11+
defer Boolean false 控制当前请求是否延时至首屏内容渲染后发送 百度小程序 3.310.11+
success Function 收到开发者服务器成功返回的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明

参数 类型 说明
data Object/String/ArrayBuffer 开发者服务器返回的数据
statusCode Number 开发者服务器返回的 HTTP 状态码
header Object 开发者服务器返回的 HTTP Response Header
cookies Array.<string> 开发者服务器返回的 cookies,格式为字符串数组

data 数据说明

最终发送给服务器的数据是 String 类型,如果传入的 data 不是 String 类型,会被转换成 String。转换规则如下:

  • 对于 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。

示例

javascript 复制代码
uni.request({
    url: 'https://www.example.com/request', //仅为示例,并非真实接口地址。
    data: {
        text: 'uni.request'
    },
    header: {
        'custom-header': 'hello' //自定义请求头信息
    },
    success: (res) => {
        console.log(res.data);
        this.text = 'request success';
    }
});
相关推荐
Backstroke fish4 小时前
Token刷新机制
前端·javascript·vue.js·typescript·vue
小曲程序4 小时前
vue3 封装request请求
java·前端·typescript·vue
Lysun0015 小时前
[less] Operation on an invalid type
前端·vue·less·sass·scss
耶啵奶膘5 小时前
uniapp+vue2全局监听退出小程序清除缓存
小程序·uni-app
程序视点12 小时前
【Vue3新工具】Pinia.js:提升开发效率,更轻量、更高效的状态管理方案!
前端·javascript·vue.js·typescript·vue·ecmascript
我开心就好o12 小时前
uniapp点左上角返回键, 重复来回跳转的问题 解决方案
前端·javascript·uni-app
Random_index12 小时前
#Uniapp篇:支持纯血鸿蒙&发布&适配&UIUI
uni-app·harmonyos
刚刚好ā13 小时前
js作用域超全介绍--全局作用域、局部作用、块级作用域
前端·javascript·vue.js·vue
ZwaterZ16 小时前
vue el-table表格点击某行触发事件&&操作栏点击和row-click冲突问题
前端·vue.js·elementui·c#·vue
惜.己18 小时前
Jmeter中的断言(二)
测试工具·jmeter·1024程序员节