關于小程序開發的(de)一些經驗

作者：龍 時(shí)間：2018-07-28 浏覽：

引入iconfont

在小程序中引入字體圖标要比web麻煩一些，簡單說需要三步：

1. 下(xià)載iconfont，把iconfont.css複制到iconfont.wxss，在app.wxss中引入

2. 查看iconfont在unicode模式下(xià)的(de)在線鏈接，替換iconfont.wxss中的(de)鏈接爲遠(yuǎn)程鏈接

3. 在wxml文件中引入對(duì)應的(de)icon class

<icon class="iconfont icon-pay"></icon>
複制代碼

使用(yòng)less

vscode有一個(gè)easy less插件，是我感覺使用(yòng)less最簡單的(de)方式

1. vscode安裝easy less插件

2. 創建一個(gè)less目錄，用(yòng)于存放less文件

3. 文件頭部添加編譯注釋 // out: ../pages/index/index.wxss, compress: true, sourceMap: false

4. ctrl + s保存後自動編譯

編譯後的(de)結果

按鈕重置

小程序中的(de)按鈕功能強大(dà)，很多(duō)功能必須要用(yòng)按鈕，比如彈出用(yòng)戶授權，調用(yòng)客服功能。默認的(de)樣式一般無法滿足需求，可(kě)以把按鈕樣式統一重置，然後自己寫樣式

button {
  padding: 0;
  background: #fff;
  line-height: 0;
  &::after {
    border-color: transparent;
  }
}
.button-hover {
  background: #fff;
}
複制代碼

支持async-await

async-await是ES7的(de)語法，截止我寫這(zhè)篇文章(zhāng)爲止，小程序還(hái)是不支持async-await語法的(de)，所以需要使用(yòng)regenerator這(zhè)個(gè)庫

1. 下(xià)載regenerator，并把regenerator-runtime并放到utils目錄下(xià)

3. 封裝wxRequest，讓它支持async-await

const wxRequest = async (url, params = {}) => {
  Object.assign(params, {
    token: wx.getStorageSync('token')
  })
  // 所有的(de)請求，header默認攜帶token
  let header = params.header || {
    'Content-Type': 'application/json',
    'token': params.token || ''
  }
  let data = params.data || {}
  let method = params.method || 'GET'
  // hideLoading可(kě)以控制是否顯示加載狀态
  if (!params.hideLoading) {
   wx.showLoading({
     title: '加載中...',
   })
  }
  let res = await new Promise((resolve, reject) => {
    wx.request({
      url: url,
      method: method,
      data: data,
      header: header,
      success: (res) => {
        if (res && res.statusCode == 200) {
          resolve(res.data)
        } else {
          reject(res)
        }
      },
      fail: (err) => {
        reject(err)
      },
      complete: (e) => {
        wx.hideLoading()
      }
    })
  })
  return res
}

export {
  wxRequest
}
複制代碼

使用(yòng)方法：

import regeneratorRuntime from '../../utils/regenerator-runtime/runtime-module.js'
import {
  wxRequest
} from '../../utils/util.js'

Page({
  data: {
   list:[],
   count: 0,
   page: 1,
   limit: 10
  },
  onLoad: function() {
    this.getList()
    // 請求已經結束 做(zuò)其他(tā)事
  },
  getList: async function() {
    await wxRequest(app.globalData.baseUrl + '/test',{
      hideLoading: true,
      data: {
        limit: this.data.limit,
        page: this.data.page
      }
    }).then((ret) => {
      this.setData({
        list: ret.data.data,
        count: ret.data.num
      })
    })
  }
})
複制代碼

封裝之後用(yòng)起來(lái)還(hái)是很爽的(de)，擴展起來(lái)也(yě)方便

動态設置data中某個(gè)值

應用(yòng)場(chǎng)景：循環出來(lái)的(de)列表，需要根據點擊項，動态改變列表中對(duì)應id的(de)數據

// 動态傳遞id
<block wx:for="{{list}}" wx:key="{{index}}">
  <view catch:tap="onChangeName" data-id="{{item.id}}"></view>
</block>

Page({
  data: {
    list:[{
      id: 0,
      name: 'wang'
    },{
      id: 1,
      name: 'li'
    }]
  },
  onChangeName: function(event){
    // 拿到id
   let id = event.target.dataset.id
   let key = `list[${id}].name`, val = 'zhang'
   // 設置值
   this.setData({
    [key]: val
   })
  }
})
複制代碼

flex布局，溢出省略号無效

訂單列表一般都是左邊一個(gè)圖片，右邊是标題或描述。這(zhè)時(shí)候圖片寬度是固定的(de)，标題長(cháng)度自适應

.wrap {
  display: flex;
}
.sub {
  flex: 1;
  width: 0; // 寬度設爲0
}
.sub text {
  display: block; // 一定要設置成block
}

<view calss="wrap">
  <image src="i.png"/>
  <view class="sub">
    <text>一段文本一段文本一段文本一段文本一段文本一段文本</text>
    <view>其他(tā)</view>
  </view>
</view>
複制代碼

組件事件傳遞

任務：父組件向子組件傳遞初始數據，當子組件點擊以後可(kě)以triggerEvent自定義事件，父組件執行自定義事件，重新請求數據并傳給子組件

/* 子組件 */
<view>
  <view bind:tap="setId" data-id="1"></view>
</view>

properties: {
  list: {
    type: Array,
    default: []
  }
},

methods: {
  setId(e) {
    let id = e.currentTarget.dataset.id
    this.triggerEvent('deleteFav', id)
  }
}

/* 父頁面 */
<child bind:customEvent="deleteFav"></child>

data: {
  list: []
},
deleteFav(e) {
  let id = e.detail // 獲取傳遞過來(lái)的(de)數據
  // 根據id請求數據，然後重新setData
  let newData = [1,2,3]
  this.setData({
    list: newData
  })
}
複制代碼

使用(yòng)wxParse解析HTML

1. 下(xià)載 wxParse ，放到utils目錄下(xià)
2. 在JS頁面引入： import WxParse from '../../utils/wxParse/wxParse'

Page({
  data:{
    contentHTML:'' // 解析後的(de)HTML
  },
  onLoad: function() {
    // 請求到的(de)HTML數據
    let content = '<div>我是HTML代碼</div>', that = this;
    WxParse.wxParse('contentHTML', 'html', content, that, 0);
  }
})

複制代碼

3. 顯示解析内容

<import src="../../utils/wxParse/wxParse.wxml"/>
<view>
  <!-- 顯示内容 -->
  <template is="wxParse" data="{{wxParseData:contentHTML.nodes}}" />
</view>
複制代碼

圖片等比例

image标簽有個(gè)mode屬性，可(kě)以設置圖片如何顯示，如果文檔看的(de)不仔細還(hái)真容易發現

<image src="test.png" mode="widthFix"/>
複制代碼

上拉加載和(hé)下(xià)拉刷新

{
  "onReachBottomDistance": 0,
  "enablePullDownRefresh": true
}
複制代碼

data: {
  limit: 30,
  page: 1,
  list:[],
  count:0
},
// 下(xià)拉
onPullDownRefresh: function () {
  this.setData({
    page: 1,
    list:[]
  })
  this.getData()
},
// 上拉
onReachBottom: function () {
  if(this.data.list.length >= this.data.count) {
    return false
  }
  this.setData({
    page: this.data.page + 1
  })
  this.getData()
  wx.stopPullDownRefresh()
},
getData: async function () {
  await wxRequest(app.globalData.baseUrl + '/test', {
    data: {
      page: this.data.page,
      limit: this.data.limit,
    }
  }).then((ret) => {
    let list = this.data.list.concat(ret.data.list)
    this.setData({
      list: list,
      count: ret.data.count
    })
  })
}
複制代碼

上傳圖片

任務：小程序上傳圖片到服務器，最多(duō)上傳三張，前端可(kě)以删除圖片

使用(yòng)到的(de)API有兩個(gè)：wx.uploadFile wx.chooseImage

示例WXML：

<view class="sale after-pic">
  <block wx:for="{{imgList}}" wx:key="{{index}}">
    <view class="pic">
      <image src="{{item}}" />
      <icon type="clear" size="20" catchtap="clearImg" data-id="{{index}}"/>
    </view>
  </block>
  <image src="../../images/upload.png" catchtap="chooseImage" />
</view>
<button catchtap="onSub">提交</button>
複制代碼

imgList是wx.chooseImage成功後返回的(de)圖片臨時(shí)地址

示例JS

Page({
  data: {
    imgList:[]
  },
  // 使用(yòng)async await是因爲圖片上傳是異步的(de)
  onSub: async function() {
    // 點擊提交後，開始上傳圖片
     let imgUrls = []
     for (let index = 0; index < this.data.imgList.length; index++) {
       await this.uploadFile(this.data.imgList[index]).then((res) => {
         // 這(zhè)裏要注意把res.data parse一下(xià)，默認是字符串
         let parseData = JSON.parse(res.data)
         imgUrls.push(parseData.data) // 圖片地址
       })
     }
     console.log(imgUrls) // 3張圖片上傳成功後，執行其他(tā)操作
  },
  // 删除某張圖片
  clearImg: function (params) {
    let imgList = this.data.imgList
    let id = params.currentTarget.dataset.id // 圖片索引
    imgList.splice(id, 1) // 删除
    this.setData({
      imgList: imgList
    })
  },
  chooseImage: function (params) {
    wx.chooseImage({
      count: 3, // 做(zuò)多(duō)3張
      sizeType: ['original', 'compressed'],
      sourceType: ['album', 'camera'],
      success: (res) => {
        // 存儲臨時(shí)地址
        this.setData({
          imgList: res.tempFilePaths
        })
      }
    })
  },
  uploadFile: function (filePath) {
    // 返回Promise是爲了(le)解決圖片上傳的(de)異步問題
    return new Promise( (resolve, reject) => {
      wx.uploadFile({
        url: app.globalData.baseUrl + '/file/upload', // 上傳地址
        filePath: filePath,
        name: 'file', // 這(zhè)裏的(de)具體值，問後端人(rén)員(yuán)
        formData: {},
        header: {
          "Content-Type": "multipart/form-data"
        },
        success: (res) =>{
          // 圖片上傳成功後，後端會返回一個(gè)地址，可(kě)以把它存到imgUrls
          this.imgUrls.push(res.data.data)
        },
        fail:(err) => {
          console.log(err)
        }
      })
    })
  }
})
複制代碼

動态标題

onLoad的(de)時(shí)候動态設置标題

wx.setNavigationBarTitle({
  title: '新标題'
})
複制代碼