uni-app 结合 colorUI 开发项目的总体基本流程

时间  2019-11-06
标签 uni app 结合 colorui 开发 项目 总体 基本 流程 繁體版
原文   原文链接

1、环境搭建

使用 HBuilderX可视化界面快速建立项目，HBuilderX内置处理了相关环境依赖。css

  • HBuilderX：内置uni-app编辑及项目模板，下载地址html

  • 微信开发者工具：调试预览工具。下载地址前端

2、建立uni-app项目

建立

在HBuilderX编辑器中点击工具栏里的文件 -> 新建 -> 项目：vue

选择uni-app，输入项目名称，这里有不少模板，选择你所须要的。为了以后表述方便，这里先建立了ColorUI模板，为了方便之后引用ColorUI。而后有建立了一个默认模板，这个默认模板文件不多，方便之后自由开发。以下两图所示。git

项目目录

文件 做用
pages.json 配置页面路由、导航条、选项卡等页面类信息
manifest.json 配置应用名称、appid、logo、版本等打包信息
App.vue 应用配置，用来配置App全局样式以及监听应用的生命周期
main.js Vue初始化入口文件
static目录 存放应用引用静态资源（如图片、视频等）的地方，注意：静态资源只能存放于此
pages目录 业务页面文件存放目录
components目录 组件文件存放目录

注意：在开发过程当中，当你写登陆功能后，某个页面你须要常常进入而且屡次修改，你每次修改都须要登陆后的信息，因此就很麻烦了。你须要一直从登陆开始操做，直到你到达这个界面。这时候你就能够用这个了condition。github

如今来介绍一下condition：web

condition 启动模式配置，仅开发期间生效，用于模拟直达页面的场景，如：小程序转发后，用户点击所打开的页面。json

属性说明：小程序

属性 类型 是否必填 描述
current Number 是 当前激活的模式，list节点的索引值
list Array 是 启动模式列表

list说明：后端

属性 类型 是否必填 描述
name String 是 启动模式名称
path String 是 启动页面路径
query String 否 启动参数，可在页面的 onLoad 函数里得到

在 5+App 里真机运行可直接打开配置的页面，微信开发者工具里须要手动改变编译模式，过程：微信开发工具 -> 工具 -> 编译配置 -> 找到在condition里配置的name。

在pages.josn里配置condition，代码以下：

"condition": { //模式配置，仅开发期间生效
    "current": 0, //当前激活的模式（list 的索引项）
    "list": [{
             "name": "jingdian_detail", //模式名称
	     "path": "pages/jingdian_detail/jingdian_detail", //启动页面，必选
	     "query": "id=5d1483336d724301607b2c23" //启动参数，在页面的onLoad函数里面获得。
	   }
    ]
}
复制代码

3、引用ColorUI

有了第二步建立好的模板，咱们就能够引用了。

ColorUI的引入

首先复制一下ColorUI项目目录下的colorui目录，而后粘贴到demo项目的根目录下，与pages目录同级。

使用顶部操做条

若是喜欢ColorUI里自定义的navigationBar，即cu-custom组件，那就须要在demo项目中的main.js里导入。建议仍是使用cu-custom组件。

/* demo/main.js */
import cuCustom from './colorui/components/cu-custom.vue'
Vue.component('cu-custom',cuCustom)
复制代码

下图就是ColorUI的状态栏：

你能够直接复制ColorUI项目里的App.vue文件，由于这里面设置好了cu-custom组件的高度以及定义了全局的颜色。而且还须要将pages.json配置取消系统导航栏。（开启 custom 后，全部窗口均无导航栏）

"globalStyle": {
	"navigationStyle": "custom"
},
复制代码

若是不想用cu-custom组件，那就直接在demo项目里的App.vue文件的<style></style>里引入这两句话就OK了。固然上面也须要加。

@import "colorui/main.css";
@import "colorui/icon.css";
复制代码

关于引用ColorUI的介绍，也能够查看引用ColorUI

底部操做条。

首先咱们来看一下这部分的代码。 

/*  ColorUI/pages/index/index.vue  */
<template>
	<view>
	
	    //使用v-if条件判断，来显示相应的界面 
	    //若是点击了底部中的“操做条元素->basics”、“组件->component” 或者 “扩展->plugin”，界面会出现相应的主界面。如上图所示。
		<basics v-if="PageCur=='basics'"></basics>
		<components v-if="PageCur=='component'"></components>
		<plugin v-if="PageCur=='plugin'"></plugin>

            //这里的“元素”，“组件”，“扩展”三个操做都是绑定一个点击事件NavChange，经过设置PageCur的值再结合:class属性来改变图片的路径，进而改变了按钮的颜色
		<view class="cu-bar tabbar bg-white shadow foot">
			<view class="action" @click="NavChange" data-cur="basics">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/basics' + [PageCur=='basics'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='basics'?'text-green':'text-gray'">元素</view>
			</view>
			<view class="action" @click="NavChange" data-cur="component">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/component' + [PageCur == 'component'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='component'?'text-green':'text-gray'">组件</view>
			</view>
			<view class="action" @click="NavChange" data-cur="plugin">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/plugin' + [PageCur == 'plugin'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='plugin'?'text-green':'text-gray'">扩展</view>
			</view>
		</view>
	</view>
</template>
<script>
	export default {
		data() {
		return {
				PageCur: 'basics'
			}
		},
		methods: {
			NavChange: function(e) {
				this.PageCur = e.currentTarget.dataset.cur
			}
		}
	}
</script>
<style>
</style>

复制代码

当点击“元素”，“组件”，“扩展”三个按钮的其中之一时，都会出现相应的页面，缘由就是在ColorUI的项目里mian.js里要引入下面的代码：

import basics from './pages/basics/home.vue'
Vue.component('basics',basics)

import components from './pages/component/home.vue'
Vue.component('components',components)

import plugin from './pages/plugin/home.vue'
Vue.component('plugin',plugin)

复制代码

这个底部操做条还有其它方式，能够查看这个底部操做条

4、结合后端基本操做的实现

实现用户登录注册

简单注册

上前端代码

<view class="list">
	<view class="list-call">
		<text class="cuIcon-mobile text-style "></text>
		<input class="biaoti" v-model="phoneNum" type="number" maxlength="11" placeholder="输入手机号" />
	</view>
	<view class="list-call">
		<text class="cuIcon-lock text-style "></text>
		<input class="biaoti" v-model="password" type="text" 
		       maxlength="32" placeholder="输入密码" :password='tfpsw' />
		<image class="img" 
		       :src="showPassword?'../../static/login-reg-forget/op.png':'../../static/login-reg-forget/cl.png'"
		       @tap="display"></image>
	</view>
	<view class="list-call">
		<text class="cuIcon-people text-style "></text>
		<input class="biaoti" v-model="username" type="text" placeholder="输入用户名" />
	</view>
</view>
	
<view class="dlbutton bg-color" hover-class="dlbutton-hover" @tap="bindReg">
	<text>注册</text>
</view>
<script>

export default {
	data() {
		return {
			phoneNum:'',
			password:'',
			username:'',
			tfpsw:true,
			xieyi:true,
			showPassword:false,
		};
	},
	methods: {
		//密码显示或打马	
		display() {
		    this.showPassword = !this.showPassword
			this.tfpsw =!this.tfpsw
		},
		//协议
		xieyitong(){
			this.xieyi = !this.xieyi;
		},
		//注册
	        bindReg() {
	        //简单验证
			if (this.xieyi == false) {
			    uni.showToast({
			        icon: 'none',
			        title: '请先阅读《软件用户协议》'
			    });
			    return;
			}
			if (this.phoneNum.length !=11) {
			    uni.showToast({
			        icon: 'none',
			        title: '手机号不正确'
			    });
			    return;
			}
			if (this.password.length < 6) {
			    uni.showToast({
			        icon: 'none',
			        title: '密码位数至少6位'
			        
			    });
			    return;
			}
			//将信息传到后台
			uni.request({
			//this.websiteUrl是全局api，在mian.js里设置
			    url: this.websiteUrl+'/user/signup',
			    data: {
			        mobile:this.phoneNum,
			        password:this.password,
			        username:this.username,
			    },
			    method: 'POST',
			    dataType:'json',
			    success: (res) => {
    			    if(res.statusCode==200){
    			        uni.reLaunch({
    			            url: "../login/login" //跳转到首页
    			    });
			        uni.showToast({title:"注册成功！",icon:'none'});
			    }else{
			        uni.showToast({title:"注册失败",icon:'wrong'});
			    }
			}
		});
	 }
    }
}
</script>
//样式表就不加啦
复制代码

uni.request 是发起网络请求 查看更多，在这里我就提一下url: this.websiteUrl+'/user/signup',这个url里的this.websiteUrl,这个是在main.js里定义的全局api。

//设置全局的api地址
Vue.prototype.websiteUrl = 'http://10.4.14.132:7000';
复制代码

其中10.4.14.132是本地的IPV4，:7000是后端的端口号。

结合运行界面，更加直观（图有点大......）

登录

此次换了一个手机类型，如今小了不少，先看看界面吧！

撂主要的代码，以下： 

<view class="list">
    <view class="list-call">
        <text class="cuIcon-mobile text-style "></text>
	<input class="biaoti" v-model="phoneNum" type="number" maxlength="11" placeholder="输入手机号" />
    </view>
    <view class="list-call">
	<text class="cuIcon-lock text-style "></text>
	<input class="biaoti" v-model="password" type="text" maxlength="32" placeholder="输入密码" password="true" />
    </view>
</view>
<view class="dlbutton bg-color" hover-class="dlbutton-hover" @tap="bindLogin()">
    <text>登陆</text>
</view>

<script>
export default {
    data() {
        return {
		phoneNum: '',
		password: ''
	    };
	},
	
	methods: {
	    bindLogin() {
		if (this.phoneNum.length != 11) {
		    uni.showToast({
			icon: 'none',
			title: '手机号不正确'
		    });
		    return;
		}
		if (this.password.length < 6) {
			uni.showToast({
			    icon: 'none',
			    title: '密码不正确'
			});
			return;
		}
		uni.request({
			url: this.websiteUrl+'/user/login',
			data: {
				mobile: this.phoneNum,
				password: this.password
			},
			method: 'POST',
			dataType: 'json',
			success: (res) => {
			    console.log("登陆返回数据",res);
			    if (res.data.data.code == 1) {
				uni.showToast({
			            title: "登陆成功！",
			    	    icon: 'none'
				});
			        uni.setStorageSync('token', res.data.data.token);
			        uni.setStorageSync('loginUser',res.data.data.userinfo);
			        uni.reLaunch({
			            url: "../index/index" //跳转到首页
			        });
			    } else {
				uni.showToast({
				    title: "登陆失败！",
				    icon: 'wrong'
				});
			 }
		    }
	       });
        }
    }
}
</script>
复制代码

在登录的时候用到了uni.setStorageSync，uni.setStorageSync将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。当使用uni.setStorageSync接口将数据存到本地缓存中时，就须要uni.getStorageSync来获取信息。查看更多

class 与 style 的绑定

在开发中会使用到class 与 style 的绑定，来介绍一下：

class 支持的语法:

<view :class="{ active: isActive }">111</view>
<view class="static" v-bind:class="{ active: isActive, 'text-danger': hasError }">222</view>
<view class="static" :class="[activeClass, errorClass]">333</view>
<view class="static" v-bind:class="[isActive ? activeClass : '', errorClass]">444</view>
<view class="static" v-bind:class="[{ active: isActive }, errorClass]">555</view>
复制代码

style 支持的语法:

<view v-bind:style="{ color: activeColor, fontSize: fontSize + 'px' }">666</view>
<view v-bind:style="[{ color: activeColor, fontSize: fontSize + 'px' }]">777</view>
复制代码

接下来咱们来写个例子：

当咱们提交“申请”以前，按钮的颜色是绿色的，符合用户的习惯。当点击按钮以后，会进行一系列的操做，好比与后端进行交互，这个例子比较简单，就是普通的改变样式。

html:

<button class="static" 
        :class="[isSubmit ? Submited: '', NoSubmit]"
        @click="submitFile">{{text}}</button>
复制代码

js: 必定要在data里注册后，再在class里使用，这样才会被渲染出来。

export default {
	data() {
		return {
			Submited: 'Submited',
			NoSubmit: 'NoSubmit',
			isSubmit:false,
			text:'申请'
		}
	},
	methods: {
	    submitFile(){
			this.text ='已申请';
			this.isSubmit = true;
		}
	}
}
复制代码

页面的跳转

这里就简单说一下路由跳转问题，详情能够看官网。

uni.navigateTo() : 跳转非tarBar页面

保留当前页面，跳转到应用内的某个页面，使用uni.navigateBack能够返回到原页面。

示例：

//在起始页面跳转到test.vue页面并传递参数
uni.navigateTo({
    url: 'test?id=1&name=uniapp'
});
复制代码
// 在test.vue页面接受参数
export default {
    onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
        console.log(option.id); //打印出上个页面传递的参数。
        console.log(option.name); //打印出上个页面传递的参数。
    }
}
复制代码

uni.redirectTo() : 跳转非tarBar页面

关闭当前页面，跳转到应用内的某个页面。 示例:

uni.redirectTo({
    url: 'test?id=1'
});
复制代码

uni.reLaunch()

关闭全部页面，打开到应用内的某个页面。

须要跳转的应用内页面路径 , 路径后能够带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不一样参数用&分隔；如 path?key=value&key2=value2，若是跳转的页面路径是 tabBar 页面则不能带参。

uni.switchTab(OBJECT)

跳转到 tabBar 页面，并关闭其余全部非 tabBar 页面。 示例：

pages.json

{
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    },{
      "pagePath": "pages/other/other",
      "text": "其余"
    }]
  }
}

复制代码

other.vue

uni.switchTab({
    url: '/pages/index/index'
});
复制代码

小总结：

  • navigateTo, redirectTo 只能打开非 tabBar 页面。
  • switchTab 只能打开 tabBar 页面。
  • reLaunch 能够打开任意页面。
  • 页面底部的 tabBar 由页面决定，即只要是定义为 tabBar 的页面，底部都有 tabBar。
  • 不能在 App.vue 里面进行页面跳转。

页面传参

就好比点击这个景点的卡片，会进入这个景点的详情页面，这个过程当中就用到了页面的传参。

主要代码以下：

//index.vue
<template>
<view class="cu-card case "  v-for="(item, index) in jingdian" :key="index"  @click="jd_Detial(item)">
	<view class="cu-item shadow">
		<view class="image">
			<image :src="item.img" mode="widthFix"></image>
			<view class="cu-tag bg-red">Hot</view>
		</view>
		<view class="cu-list menu-avatar">
			<view class="cu-item">
				<view class="content flex-sub" style="left: 20px;">
					<view class="text-grey">{{item.name}}</view>
					<view class="text-gray text-sm flex justify-between">
						<view class="text-gray text-sm">
							<text class="icon-icon_like-copy margin-lr-xs"></text>收藏
						</view>
					</view>
				</view>
			</view>
		</view>
	</view>
</view>
</template>

<script>
	export default {
		data() {
			return {
			    jingdian:[]
			}
		},
		created:function () {
			try {
			    //获取全部景点的数据
				uni.request({
					url: this.websiteUrl+'/api/showCityTickets/'+ this.cityId,
					method: 'GET',
					dataType: 'json',
					success: (res) => {
						this.jingdian = res.data.data;
					}
				})
			} catch (e) {
				// error
				console.log('error',e)
			}
		},
		methods: {
		    jd_Detial(item){
				console.log('id',item._id);
				//页面跳转以及传到下一页面所须要的参数_id，
				uni.navigateTo({
					url:"../jingdian_detail/jingdian_detail?id=" + item._id
				})
			}
		}
	}
</script>			
复制代码

下面是jingdian_detail.vue的详情页面

jingdian_detail.vue页面经过 onLoad()生命周期函数来获取上一页面传过来的参数 _id。主要代码以下： 

onLoad(options) {
	var _this = this;
	this.ticketId = options.id;
	//根据这个ID来获取相应的景点的详情数据，根据详情数据再来渲染出详情页面
	uni.request({
		url: this.websiteUrl + '/api/ticketsShowDetial/' + options.id,
		method: 'GET',
		dataType: 'json',
		success: function success(res) { 
			if (res.statusCode == 200) {
				_this.detail = res.data.data;
			}
		}
	});
	console.log('&&&&&&&&this.detail&&&&&&', this.detail);
}
复制代码

获取位置

本身写了一个简单的定位，只是为了方便你们了解这一功能是如何实现的。

这个获取位置只能在手机端进行测试，H5端没有GPS。

上代码：

<template>
<view style="margin: 10px auto;">
	<button @click="getLocal()">定位</button>
	<p>经度:{{longitude}} </p>
	<p>纬度：{{latitude}}</p>
	<p>详细地址{{address.country+address.province+address.city + address.district+ address.street}}</p>
</view>
</template>
<script>
	export default {
	    data() {
		return {
		    latitude:'',//纬度
		    longitude:'',//经度
		    address:{},//地址信息			
		 }
	    },
        methods: {
        	getLocal(){
        		// 获取当前的地理位置、速度。 
        		let that = this;
        		try{
        			uni.getLocation({
        			    type: 'wgs84',
        			    geocode:true,//解析地址信息
        			    success: function (res) {
        					that.latitude =  res.latitude
        					that.longitude = res.longitude
        					that.address = res.address
        					//查看地图
        					 uni.openLocation({
        					            latitude: that.latitude,
        					            longitude: that.longitude,
        					            success: function () {
        					                console.log('打开地图success');
        					            }
        					 });
        			    },
        			    fail:function(res){
        				    console.log("fail====",res)
        			    }
        			});
        		}catch(e){
        			console.log("error",e)
        		}
            }
        }
    }
复制代码

点击定位按钮，获取本地的经纬度和详细地址，而后会自动跳到地图页面。

具体想要知道 获取位置和 查看地图的API，能够查看官网哦!

运行和发布

对于运行和发布，官网上的“快速上手”中有介绍，请点击查看

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程