mpvue写一个CPASS小程序

2,143 阅读3分钟

本文是对CPASS项目的技术要点和所踩的坑做一些总结。


项目

一个提供移动办公场地的小程序平台。

使用美团mpvue框架,mpvue:1.0.13,mpvue-loader:1.0.15

静态资源(除了tabbar图标)放在阿里云oss



组件(页面)间通信

四种方式:

  1. Vuex状态管理(mapActions,mapGetters)
  2. 本地缓存(setStorage,getStorage,removeStorage)
  3. Bus集中式的事件中间件($emit,$on,$off)
  4. 路由query传值


这里说一下比较少用的第三种通信方式。Bus应用于非父子组件通信,利用$emit,$on,$off分别来分发、监听、取消监听。


第一步:在mixins(混合)建一个文件event-bus.js

import Vue from 'vue';
export default new Vue();


第二步:在需要分发的组件中引入event-bus,再传递分发事件

import Bus from '@/mixins/event-bus'

// 需要传递给兄弟组件的值
let params = { 
    ***
}
Bus.$emit('getParams', params)


第三步:在需要监听的组件中引入event-bus,在created周期去监听事件(小程序周期监听无效),在beforeDestroy 周期取消监听事件

import Bus from '@/mixins/event-bus'
created () {
  // 监听事件
  Bus.$on('getParams', params => {
    // to do something

  })
},beforeDestroy () {
  // 清除监听
  Bus.$off('getParams');
}


swiper选项卡 + 无限加载

利用微信官方提供的swiper封装一个无限数据加载的swiperTab选项卡。


空态下:



技术难点:

swiper需要设置固定高度,触底onReachBottom无限加载又需要高度。所以需要在swiper标签设置动态高度:style="{height: swiperHeight + 'px'}"onLoad周期获取单个list-item的高度。假如所渲染数据有n组数据,则swiper高度为:swiperHeight = baseHeight * n + 加载提示占位高度

// swiper动态设置高度,list为需要渲染的数据
autoHeight(list) {
  let num = list.length;
  // this.loadHeight加载提示语的高度
  let listHeight = this.baseItemHeight * num + this.loadHeight
  this.swiperHeight = Math.max(this.windowHeight, listHeight);
},
// 获取静态高度
calcStaticHeight() {
  return new Promise((resolve) => {
    let self = this;
    let tabListHeight; // 获取tab高度
    // 获取除去tabList高度,全屏高度(空态状态时需要)
    wx.createSelectorQuery().select('#tab-list').fields({
      size: true
    }, function (res) {
      tabListHeight = res.height
      wx.getSystemInfo({
        success: function(resp) {
          self.windowHeight = resp.windowHeight - tabListHeight
        }
      })
    }).exec()
    // 获取单个item高度
    wx.createSelectorQuery().select('#base-item').fields({
      size: true
    }, function (res) {
      self.baseItemHeight = res.height
      resolve()
    }).exec()
  })
}

如果频繁切换swiper会导致卡死,是因为触摸滑动swiper和点击选项卡时赋值swiperIndex都会触发swiperbindchange事件,这里做了判断处理。

// 滑动切换
swiperTab (e) {
  // 如果是触摸滑动切换
  if (e.mp.detail.source === 'touch') {
    if (this.currentTab === e.mp.detail.current) {
      return false;
    } else {
      this.currentTab = e.mp.detail.current
      this.isLoading = false
      this.allLoaded = false
      this.pageNum = 1
      this.loadTips = '上拉加载更多'
      this.getDataList(this.loadTips);
    }
  }
},
// 点击切换
clickTab (tab) {
  if (this.currentTab === tab) {
    return false;
  } else {
    this.currentTab = tab
    this.allLoaded = false
    this.pageNum = 1
    this.loadTips = '上拉加载更多'
    this.getDataList(this.loadTips);
  }
},


scroll-view封装indexList

实现两种定位方式:点击定位,按住右侧字母indexList滑动定位。


技术难点:按住右侧indexList滑动定位,获取字母indexList的上边距offsetTop,按住滑动时获取手指距离屏幕顶部的距离clientY,手指移动距离为moveY=clientY-offsetTop,具体实现如下:

// 索引定位(滑动开始) @touchstart="handlerStart"
handlerStart (e) {
  this.targetIndex = e.mp.target.id
},
// 索引定位(滑动过程) @touchmove="handlerMove"
handlerMove(e) {
  let keyList = this.keyList;
  // 手指滑动垂直距离
  let moveY = e.mp.touches[0].clientY;
  let rY = moveY - this.offsetTop;
  if (rY >= 0) {
    // apHeight为字母表indexList中单个字母块高度,计算结果向上取整
    let index = Math.ceil((rY - this.apHeight) / this.apHeight);
    if (index >= 0 && index < keyList.length) {
      this.targetIndex = keyList[index];
    }
  } else {
    this.targetIndex = keyList[0]
  }
},


view或者text设置border-radius=50%有时候在真机会变形(排除flex布局的影响)。

wxml不支持复杂逻辑,如模版字符串,字符串截取等等。

text设置行高的时候会出现样式异常,替换成view便可解决此问题。

wx.showLoading和wx.showToast的属性title不可为空,线上会报错,影响js执行。


总结

本文只是简单讲一下项目中涉及到的几处技术要点,欢迎交流。

打一波广告: