作者:叶小钗
https://www.cnblogs.com/yexiaochai/p/9419368.html
前言
接上文:
微信小程序开发(5):日历组件的实现
github地址:https://github.com/yexiaochai/wxdemo
这里来说一说我们的理念,我们也学习小程序开发有一周多了,从近期的使用上来说,小程序可以作为底层,但是缺少一个框架层,这个框架层需要提供:
① 组件库
② 更好的代码组织方式,也就是让我们可以做到轻松的组件化开发
我们从最开始到现在,都在沿着这个方向去分解小程序学习,其实小程序本身的东西差不多了,但是我们代码过程中有时候却越高越复杂,多了很多封装,其实这所有的复杂都是为了设置一个基本的架构,一个标准的开发模式,让后面写业务代码的同学能更高效的写代码,经过一年多的发展,事实上这种较为成熟的框架已经有了,比如我们正在使用的:
https://tencent.github.io/wepy/
但是,可以看到小程序基本还是原生JS,这其实是个非常好的学习整理机会,所以我这边一步步和大家对小程序进行了拆分,期望能形成一套还能用的雏形,帮助大家理解,所以我们继续今天的学习吧,为了降低单页面难度,我们将首页进行下改造。
首页
首页做了一点改造,变成了这个样式了:
这里需要三个点击时间点,因为日历组件,我们昨天就做好了,而他这个出发日期事实上就是我们日历组件的selecedDate,处理这块逻辑:
<template name="searchbox">
<view class="c-row search-line" data-flag="start">
<view class="c-span3">
出发</view>
<view class="c-span9 js-start search-line-txt">
请选择出发地</view>
</view>
<view class="c-row search-line" data-flag="arrive">
<view class="c-span3">
到达</view>
<view class="c-span9 js-arrive search-line-txt">
请选择到达地</view>
</view>
<view class="c-row search-line" data-flag="arrive">
<view class="c-span3">
出发日期</view>
<view class="c-span9 js-arrive search-line-txt">
{{calendarSelectedDate || '请选择出发日期'}} </view>
</view>
<view class="c-row " data-flag="arrive">
<span class="btn-primary full-width js_search_list">查询</span>
</view>
</template>
<view class="c-row search-line" data-flag="arrive">
<view class="c-span3">
出发日期</view>
<view class="c-span9 js-arrive search-line-txt">
{{calendarSelectedDate || '请选择出发日期'}} </view>
</view>
点击时候我们弹出我们的日历,这个时候我们日历模块释放一个事件显示日历:
PS:template不与页面级别WXML共享一个作用域,所以我暂时都采用的include引入
<view class="c-row search-line" data-flag="start">
<view class="c-span3">
出发</view>
<view class="c-span9 js-start search-line-txt">
请选择出发地</view>
</view>
<view class="c-row search-line" data-flag="arrive">
<view class="c-span3">
到达</view>
<view class="c-span9 js-arrive search-line-txt">
请选择到达地</view>
</view>
<view class="c-row search-line" data-flag="arrive" ontap="showCalendar">
<view class="c-span3">
出发日期</view>
<view class="c-span9 js-arrive search-line-txt">
{{calendarSelectedDateStr}}</view>
</view>
<view class="c-row " data-flag="arrive">
<span class="btn-primary full-width js_search_list">查询</span>
</view>
<include src="./mod/calendar.wxml" />
<include src="../../utils/abstract-page.wxml" />
<view class="c-row search-line" data-flag="arrive" ontap="showCalendar">
<view class="c-span3">
出发日期</view>
<view class="c-span9 js-arrive search-line-txt">
{{calendarSelectedDateStr}}</view>
</view>
/*
事实上一个mod就只是一个对象,只不过为了方便拆分,将对象分拆成一个个的mod
一个mod对应一个wxml,但是共享外部的css,暂时如此设计
所有日历模块的需求全部再此实现
*/
const util = require('../../../utils/util.js')
let selectedDate = new Date();
module.exports = {
showCalendar: function () {
this.setData({
isCalendarShow: ''
});
},
onCalendarDayTap: function (e) {
let data = e.detail;
var date = new Date(data.year, data.month, data.day);
console.log(date)
this.setData({
calendarSelectedDate: date,
calendarSelectedDateStr: util.dateUtil.format(date, 'Y年M月D日')
});
},
data: {
isCalendarShow: 'none',
calendarDisplayMonthNum: 2,
calendarDisplayTime: new Date(),
calendarSelectedDate: selectedDate,
calendarSelectedDateStr: util.dateUtil.format(selectedDate, 'Y年M月D日')
}
}
显然,这里的日历这样摆设有点丑,我们这里将其封装成一个弹出层,所以我们这里再做一个容器类组件,专门用于装载页面样式用:
<view class="cm-modal " style="z-index: {{uiIndex}}; position: fixed; display: {{isShow}}; ">
<slot ></slot>
</view>
<view class="cm-overlay" bindtap="onMaskEvent" style="z-index: {{maskzIndex}}; display: {{isShow}}" >
</view>
<ui-container bindonContainerHide="onContainerHide" is-show="{{isCalendarShow}}" >
<view class="calendar-wrapper-box">
<view class="box-hd">
<text class="fl icon-back js_back "></text>
<text class="fr icon-next js_next"></text>
</view>
<ui-calendar bindonDayTap="onCalendarDayTap" displayTime="{{calendarDisplayTime}}"
selectedDate="{{calendarSelectedDate}}" displayMonthNum="{{calendarDisplayMonthNum}}"
is-show="{{isCalendarShow}}"></ui-calendar>
</view>
</ui-container>
但是这里也引起了其他问题,因为引入了shadow-dom概念,我的样式不能重用,组件内部样式与外部是不能通信的,但是这里是页面级别容器,内容的样式肯定是来源页面的,这里没什么问题,所以我们这里显示的是正确的,但是我这里想做一个出格一点的操作,我想用样式将这里日历月标题换个位置:
而日历组件和外部是不能通信的,我们这里该如何处理呢,我这里想了两个方案:
① 设置一个全局使用的组件库样式,让所有组件继承,但是不知道这里对性能是否有影响,因为这样的话体积不会太小
② 小程序设计了可以传入组件的方法,比如我们这里的日历组件我们可以这样改变其样式
.calendar-cm-month {
position: absolute;
top: 0;
height: 90rpx;
line-height: 90rpx;
width: 100%;
color: #00b358;
text-align: center;
}
Component({
externalClasses: ['ex-class'],
behaviors: [
View
],
properties: {
displayMonthNum: {
type: Number
},
displayTime: {
type: Date
},
selectedDate: {
type: Date
}
},
data: {
weekDayArr: ['日', '一', '二', '三', '四', '五', '六'],
},
attached: function () {
//console.log(this)
// debugger
},
methods: {
onDayTap: function (e) {
this.triggerEvent('onDayTap', e.currentTarget.dataset)
}
}
})
<ui-container bindonContainerHide="onContainerHide" is-show="{{isCalendarShow}}" >
<view class="calendar-wrapper-box">
<view class="box-hd">
<text class="fl icon-back js_back "></text>
<text class="fr icon-next js_next"></text>
</view>
<ui-calendar ex-class="calendar-cm-month" bindonDayTap="onCalendarDayTap"
displayTime="{{calendarDisplayTime}}" selectedDate="{{calendarSelectedDate}}"
displayMonthNum="{{calendarDisplayMonthNum}}" is-show="{{isCalendarShow}}"></ui-calendar>
</view>
</ui-container>
具体各位去github上查看,总而言之,我们的页面变成了这个样子了:
PS:这里发现一个不知道是不是坑点的点,我们这里属性传递的是一个date对象,但是到了组件层之间变成了对象,不知微信底层做了什么:
calendarDisplayTime: new Date()
好像变成了一个空对象,这里可能发生的情况是,经过传递的日期对象会被某种特殊处理,但是具体发生了什么事情就不知道了,这个却引起了我们不小的麻烦,这里大概去翻开了一下源码:
极有可能,小程序本身就不支持date属性的传递,我们的日历组件能跑起来的原因是什么,我这里都有点疑惑了……
而且就算以对象方式传递到组件的date类型都会变成莫名其妙的东西:
ttt: {
key: 'date',
value: selectedDate
},
这个特性有点令人抓不住头脑了,这里根据探查,很有可能Component将date对象传入WXML解释时候,自动转为了日期字符串了,所以我们这里看上去是对象的东西其实是字符串,这里的建议是:跟组件的date传递,暂时全部使用字符串代替,以免自我麻烦,然后我们先将之前的日历操作全部变成字符串,再为我们的前后按钮加上事件:
module.exports = {
showCalendar: function () {
this.setData({
isCalendarShow: ''
});
},
hideCalendar: function () {
this.setData({
isCalendarShow: 'none'
});
},
preMonth: function () {
this.setData({
calendarDisplayTime: util.dateUtil.preMonth(this.data.calendarDisplayTime).toString()
});
},
nextMonth: function () {
this.setData({
calendarDisplayTime: util.dateUtil.nextMonth(this.data.calendarDisplayTime).toString()
});
},
onCalendarDayTap: function (e) {
let data = e.detail;
var date = new Date(data.year, data.month, data.day);
console.log(date)
this.setData({
isCalendarShow: 'none',
calendarSelectedDate: date.toString(),
calendarSelectedDateStr: util.dateUtil.format(date, 'Y年M月D日')
});
},
onContainerHide: function () {
this.hideCalendar();
},
data: {
ttt: {
key: 'date',
value: selectedDate
},
isCalendarShow: '',
calendarDisplayMonthNum: 1,
calendarDisplayTime: new Date(2018, 9).toString(),
calendarSelectedDate: selectedDate,
calendarSelectedDateStr: util.dateUtil.format(new Date(selectedDate), 'Y年M月D日')
}
}
虽然看上去恶心了一点,但是总是不会出什么明显的问题,忍一忍吧……日期部分基本结束了,还有些小的限制没有做上,比如哪些时段能选,哪些不能,这块就有待各位发现吧,我们这里毕竟是学习,做细了很花功夫,我们接下来做出发目的地选择部分。
数据请求
城市列表
城市列表这里看起来需要新开一个页面,但是我这里想做在一个页面中,考虑篇幅,我们使用弹出层容器组件看并且尽量削弱一些特性,几天下来别说写的还有些累……
这个又作为首页的一个模块而存在:
<view style="display: {{isCityShow}}; " class="city-wrapper" >
<view class="city-list">
<view class="list-name">A</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
</view>
<view class="city-list">
<view class="list-name">A</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
<view class="list-item">成都</view>
</view>
</view>
/*
事实上一个mod就只是一个对象,只不过为了方便拆分,将对象分拆成一个个的mod
一个mod对应一个wxml,但是共享外部的css,暂时如此设计
所有日历模块的需求全部再此实现
*/
const util = require('../../../utils/util.js')
let selectedDate = new Date().toString();
module.exports = {
showCitylist: function (e) {
let flag = e.currentTarget.dataset.flag;
if(flag === 'start') {
} else {
}
},
//用于设置城市数据
setCityData: function (data) {
},
showCity: function () {
this.setData({
isCityShow: ''
});
},
shideCity: function () {
this.setData({
isCityShow: 'none'
});
},
data: {
isCityShow: ''
}
}
首页调用代码:
//获取公共ui操作类实例
const _page = require('../../utils/abstract-page.js');
let modCalendar = require('./mod/calendar.js');
let modCity = require('./mod/city.js');
//获取应用实例
const app = getApp()
Page(_page.initPage({
data: {
},
// methods: uiUtil.getPageMethods(),
methods: {
},
onShow: function () {
global.sss = this;
let scope = this;
},
onLoad: function () {
// this.setPageMethods();
}
}, {
modCalendar: modCalendar,
modCity: modCity
}))
这里我们开始有数据请求模块了,小程序使用这个接口请求数据,这里比较尴尬的是他要设置域名白名单:
wx.request(OBJECT)
而我们使用的是测试账号没有可以设置的地方,所以我们还是去申请个小程序账号吧…配置成功,我们继续代码:
可以看到数据请求已经回来了,但是我们一般来说一个接口不止会用于一个地方,每次重新写好像有些费事,加之我这里想将重复的请求缓存起来,所以我们这里封装一套数据访问层出来
数据缓存(持久层)
之前在浏览器中,我们一般使用localstorage存储一些不太更改的数据,微信里面提供了接口处理这一切:
wx.setStorage(OBJECT)
我们这里需要对其进行简单封装,便与后面更好的使用,一般来说有缓存就一定要有过期,所以我们动态给每个缓存对象增加一个过期时间:
class Store {
constructor(opts) {
if(typeof opts === 'string') this.key = opts;
else Object.assign(this, opts);
//如果没有传过期时间,则默认30分钟
if(!this.lifeTime) this.lifeTime = 1;
//本地缓存用以存放所有localstorage键值与过期日期的映射
this._keyCache = 'SYSTEM_KEY_TIMEOUT_MAP';
}
//获取过期时间,单位为毫秒
_getDeadline() {
return this.lifeTime * 60 * 1000;
}
//获取一个数据缓存对象,存可以异步,获取我同步即可
get(sign){
let key = this.key;
let now = new Date().getTime();
var data = wx.getStorageSync(key);
if(!data) return null;
data = JSON.parse(data);
//数据过期
if (data.deadLine < now) {
this.removeOverdueCache();
return null;
}
if(data.sign) {
if(sign === data.sign) return data.data;
else return null;
}
return null;
}
/*产出页面组件需要的参数
sign 为格式化后的请求参数,用于同一请求不同参数时候返回新数据,比如列表为北京的城市,后切换为上海,会判断tag不同而更新缓存数据,tag相当于签名
每一键值只会缓存一条信息
*/
set(data, sign) {
let timeout = new Date();
let time = timeout.setTime(timeout.getTime() + this._getDeadline());
this._saveData(data, time, sign);
}
_saveData(data, time, sign) {
let key = this.key;
let entity = {
deadLine: time,
data: data,
sign: sign
};
let scope = this;
wx.setStorage({
key: key,
data: JSON.stringify(entity),
success: function () {
//每次真实存入前,需要往系统中存储一个清单
scope._saveSysList(key, entity.deadLine);
}
});
}
_saveSysList(key, timeout) {
if (!key || !timeout || timeout < new Date().getTime()) return;
let keyCache = this._keyCache;
wx.getStorage({
key: keyCache,
complete: function (data) {
let oldData = {};
if(data.data) oldData = JSON.parse(data.data);
oldData[key] = timeout;
wx.setStorage({
key: keyCache,
data: JSON.stringify(oldData)
});
}
});
}
//删除过期缓存
removeOverdueCache() {
let now = new Date().getTime();
let keyCache = this._keyCache;
wx.getStorage({
key: keyCache,
success: function (data) {
if(data && data.data) data = JSON.parse(data.data);
for(let k in data) {
if(data[k] < now) {
delete data[k];
wx.removeStorage({key: k, success: function(){}});
}
}
wx.setStorage({
key: keyCache,
data: JSON.stringify(data)
});
}
});
}
}
module.exports = Store
这个类的使用也非常简单,这里举个例子:
sss = new global.Store({key: 'qqq', lifeTime: 1})
sss.set({a: 1}, 2)
sss.get()//因为没有秘钥会是null
sss.get(2)//sss.get(2)
这个时候我们开始写我们数据请求的类:
首先还是实现了一个抽象类和一个业务基类,然后开始在业务层请求数据:
class Model {
constructor() {
this.url = '';
this.param = {};
this.validates = [];
}
pushValidates(handler) {
if (typeof handler === 'function') {
this.validates.push(handler);
}
}
setParam(key, val) {
if (typeof key === 'object') {
Object.assign(this.param, key);
} else {
this.param[key] = val;
}
}
//<a href='http://www.jobbole.com/members/wx610506454'>@override</a>
buildurl() {
return this.url;
}
onDataSuccess() {
}
//执行数据请求逻辑
execute(onComplete) {
let scope = this;
let _success = function(data) {
let _data = data;
if (typeof data == 'string') _data = JSON.parse(data);
// @description 开发者可以传入一组验证方法进行验证
for (let i = 0, len = scope.validates.length; i < len; i++) {
if (!scope.validates[i](data)) {
// @description 如果一个验证不通过就返回
if (typeof onError === 'function') {
return onError.call(scope || this, _data, data);
} else {
return false;
}
}
}
// @description 对获取的数据做字段映射
let datamodel = typeof scope.dataformat === 'function' ? scope.dataformat(_data) : _data;
if (scope.onDataSuccess) scope.onDataSuccess.call(scope, datamodel, data);
if (typeof onComplete === 'function') {
onComplete.call(scope, datamodel, data);
}
};
this._sendRequest(_success);
}
//删除过期缓存
_sendRequest(callback) {
let url = this.buildurl();
wx.request({
url: this.buildurl(),
data: this.param,
success: function success(data) {
callback && callback(data);
}
});
}
}
module.exports = Model
let Model = require('./abstract-model.js');
class DemoModel extends Model {
constructor() {
super();
let scope = this;
this.domain = 'https://apikuai.baidu.com';
this.param = {
head: {
version: '1.0.1',
ct: 'ios'
}
};
//如果需要缓存,可以在此设置缓存对象
this.cacheData = null;
this.pushValidates(function(data) {
return scope._baseDataValidate(data);
});
}
//首轮处理返回数据,检查错误码做统一验证处理
_baseDataValidate(data) {
if (typeof data === 'string') data = JSON.parse(data);
if (data.data) data = data.data;
if (data.errno === 0) return true;
return false;
}
dataformat(data) {
if (typeof data === 'string') data = JSON.parse(data);
if (data.data) data = data.data;
if (data.data) data = data.data;
return data;
}
buildurl() {
return this.domain + this.url;
}
getSign() {
let param = this.getParam() || {};
return JSON.stringify(param);
}
onDataSuccess(fdata, data) {
if (this.cacheData && this.cacheData.set)
this.cacheData.set(fdata, this.getSign());
}
//如果有缓存直接读取缓存,没有才请求
execute(onComplete, ajaxOnly) {
let data = null;
if (!ajaxOnly && this.cacheData && this.cacheData.get) {
data = this.cacheData.get(this.getSign());
if (data) {
onComplete(data);
return;
}
}
super.execute(onComplete);
}
}
class CityModel extends DemoModel {
constructor() {
super();
this.url = '/city/getstartcitys';
}
}
module.exports = {
cityModel: new CityModel
}
接下来是实际调用代码:
let model = models.cityModel;
model.setParam({
type: 1
});
model.execute(function(data) {
console.log(data);
debugger;
});
数据便请求结束了,有了这个类我们可以做非常多的工作,比如:
① 前端设置统一的错误码处理逻辑
② 前端打点,统计所有的接口响应状态
③ 每次请求相同参数做数据缓存
④ 这个对于错误处理很关键,一般来说前端出错很大可能都是后端数据接口字段有变化,而这种错误是比较难寻找的,如果我这里做一个统一的收口,每次数据返回记录所有的返回字段的标志上报呢,就以这个城市数据为例,我们可以这样做:
class CityModel extends DemoModel {
constructor() {
super();
this.url = '/city/getstartcitys';
}
//每次数据访问成功,错误码为0时皆会执行这个回调
onDataSuccess(fdata, data) {
super.onDataSuccess(fdata, data);
//开始执行自我逻辑
let o = {
_indate: new Date().getTime()
};
for(let k in fdata) {
o[k] = typeof fdata[k];
}
//执行数据上报逻辑
console.log(JSON.stringify(o));
}
}
这里就会输出以下信息:
{"_indate":1533436847778,"cities":"object","hots":"object","total":"number","page":"string"}
如果对数据要求非常严苛,对某些接口做到字段层面的验证,那么加一个Validates验证即可,这样对接口的控制会最大化,就算哪次出问题,也能很好从数据分析系统之中可以查看到问题所在,如果我现在想要一个更为具体的功能呢?我想要首次请求一个接口时便将其数据记录下来,第二次便不再请求呢,这个时候我们之前设计的数据持久层便派上了用处:
let Store = require('./abstract-store.js');
class CityStore extends Store {
constructor() {
super();
this.key = 'DEMO_CITYLIST';
//30分钟过期时间
this.lifeTime = 30;
}
}
module.exports = {
cityStore: new CityStore
}
class CityModel extends DemoModel {
constructor() {
super();
this.url = '/city/getstartcitys';
this.cacheData = Stores.cityStore;
}
//每次数据访问成功,错误码为0时皆会执行这个回调
onDataSuccess(fdata, data) {
super.onDataSuccess(fdata, data);
//开始执行自我逻辑
let o = {
_indate: new Date().getTime()
};
for(let k in fdata) {
o[k] = typeof fdata[k];
}
//执行数据上报逻辑
console.log(JSON.stringify(o));
}
}
这个时候第二次请求时候便会直接读取缓存了
接下来便可以回到我们的页面渲染逻辑了,这个时候就变得非常简单了:
<view style="display: {{isCityShow}}; " class="city-wrapper">
<block wx:for="{{cityData}}" wx:key="k">
<view class="city-list">
<block wx:for="{{item}}" wx:key="kk" wx:for-index="key" wx:for-item="value">
<view class="list-name">{{key}}</view>
<block wx:for="{{value}}" wx:key="kkk" wx:for-index="i" wx:for-item="v">
<view class="list-item" data-cnname="{{v.name}}" data-id="{{v.regionid}}">{{v.cnname}}</view>
</block>
</block>
</view>
</block>
</view>
//用于设置城市数据
setCityData: function(data) {
data = data.cities;
let citys = {}, sortCitys = [];
let k, gname, name, i, tmp = {}, index;
//首先处理每个name生成唯一K
for (k in data) {
name = data[k].name;
if (!name) {
continue;
}
gname = name[0].toUpperCase();
if (!citys[gname]) citys[gname] = [];
citys[gname].push(data[k]);
}
for (i = 65; i < 91; i++) {
tmp = {};
tmp[String.fromCharCode(i)] = [];
sortCitys.push(tmp);
}
for (k in citys) {
index = k.charCodeAt() - 65;
tmp = {};
tmp[k] = citys[k];
sortCitys[index] = tmp;
}
this.setData({
cityData: sortCitys,
isCityShow: ''
});
},
然后我们这里为组件绑定事件等就比较简单了,大家可以自己看github,于是我们首页的功能便完成了:
经过一个多星期的学习,我们慢慢的完成了我们的首页,好像也就几个元素,但是后面的一切却不简单啊,我们明天继续完成list页面逻辑,便开始总结小程序开发。
感兴趣的小伙伴,可以关注公众号【grain先森】,回复关键词 “小程序”,获取更多资料,更多关键词玩法期待你的探索~