天天看點

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&cps_key=128419a2e140e43270be962309035fcb&from=activity

本文引用自:https://www.cnblogs.com/gulei/p/6589177.html

微信小程式已經火了一段時間了,之前一直也在關注,就這半年的發展來看,相對原生APP大部分公司還是不願意将主營業務放到微信平台上,以免受制于騰訊,不過就小程式的應用場景(用完即走和二維碼分發等)還是很值得我們學習的,技術上面如果了解React的話,會發現他們在元件化上面有很多雷同之處。說白了,小程式就是基于微信平台的H5輕應用,微信将系統底層功能(裝置、位置、媒體、檔案等)和微信自身功能(登入、支付、分享等)封裝成相應API供小程式調用。

自己根據官方文檔寫過一個DOME,借助和風天氣開放API接口,實作天氣預報,僅供學習交流使用,謝謝~

一、小程式基本概念

1、開發工具:為了配合小程式開發,微信專門配備了自己的開發工具,自行選擇對應版本安裝。

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&cps_key=128419a2e140e43270be962309035fcb&from=activity

2、建立項目應用:安裝完成後,打開并掃碼登入。小程式釋出需要企業級的認證公衆号,是以個人訂閱号是不能釋出的。是以我這裡選擇無AppID,建立項目選擇一個本地空檔案夾,勾選建立quick start 項目生成一個demo。

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&cps_key=128419a2e140e43270be962309035fcb&from=activity

3、編寫小程式:demo初始化并包含了一些簡單的代碼檔案,其中app.js、app.json、app.wxss 這三個是必不可少的,小程式會讀取這些檔案初始化執行個體。

  app.js是小程式的初始化腳本,可以在這個檔案中監聽小程式的生命周期,申請全局變量和調用API等

  app.json是對小程式的全局配置,pages設定頁面路徑組成(預設第一條為首頁),window設定預設頁面的視窗表現等

  app.wxss 是整個小程式的公共樣式表。類似網站開發中的common.css

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&cps_key=128419a2e140e43270be962309035fcb&from=activity

4、建立頁面:在pages目錄下,由一個檔案夾中的四個同名不同類型檔案組成。

.js

是腳本檔案,

.json

是配置檔案,

.wxss

是樣式表檔案,

.wxml

是頁面結構檔案,其中json和wxss檔案為非必須(預設會繼承app的json和wxss預設設定)。

二、小程式的架構

1、小程式的配置

  app.json主要分為五個部分:pages:頁面組,window:架構樣式(狀态欄、導覽列、标題、視窗背景色),tabBar:底部菜單,networkTimeout:網絡逾時設定,debug:開啟debug模式

  page.json針對頁面單獨設定,層疊掉app.json的全局設定

//app.json
{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#000",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle":"white"
  }
}
           

2、小程式的邏輯

  使用App()來注冊一個小程式,必須在

app.js

中注冊,且不能注冊多個

App({//如下為小程式的生命周期
  onLaunch: function() { },//監聽初始化
  onShow: function() {  },//監聽顯示(進入前台)
  onHide: function() {  },//監聽隐藏(進入背景:按home離開微信)
  onError: function(msg) {  },//監聽錯誤
  //如下為自定義的全局方法和全局變量  
  globalFun:function(){},
  globalData: 'I am global data'
})
           

  使用Page()注冊一個頁面,在每個頁面的js檔案中注冊

Page({
  data: {text: "This is page data."},//頁面資料,用來維護視圖,json格式
  onLoad: function(options) {  },//監聽加載
  onReady: function() {  },//監聽初次渲染完成
  onShow: function() {  },//監聽顯示
  onHide: function() {  },//監聽隐藏
  onUnload: function() {  },//監聽解除安裝
  onPullDownRefresh: function() {  },//監聽下拉
  onReachBottom: function() {  },//監聽上拉觸底
  onShareAppMessage: function () {  },//監聽右上角分享
  //如下為自定義的事件處理函數(視圖中綁定的)
  viewTap: function() {//setData設定data值,同時将更新視圖
    this.setData({text: 'Set some data for updating view.'})
  }
})
           

  

3、小程式的視圖與事件綁定

  在每個頁面中的wxml檔案中,對頁面js中data進行資料綁定,以及自定義事件綁定

<!--{{}}綁定data中的指定資料并渲染到視圖-->
<view class="title">{{text}}</view>

<!--wx:for擷取數組資料進行循環渲染,item為數組的每項-->
<view wx:for="{{array}}"> {{item}} </view>

<!--wx:if條件渲染-->
<view wx:if="{{view == 'WEBVIEW'}}"> WEBVIEW </view>
<view wx:elif="{{view == 'APP'}}"> APP </view>
<view wx:else="{{view == 'MINA'}}"> MINA </view>

<!--模闆-->
<template name="staffName">
  <view>FirstName: {{firstName}}, LastName: {{lastName}}</view>
</template>
<template is="staffName" data="{{...template.staffA}}"></template>
<template is="staffName" data="{{...template.staffB}}"></template>

<!--bindtap指定tap事件處理函數為ViewTap-->
<view bindtap="ViewTap"> 點我點我 </view>
           
Page({
  data: {//data資料主要用于視圖綁定
    text:"我是一條測試",
    array:[0,1,2,3,4],
    view:"APP",
    template:{
        staffA: {firstName: 'Hulk', lastName: 'Hu'},
        staffB: {firstName: 'Shang', lastName: 'You'}
    }
  },
  ViewTap:function(){console.log('額,點到我了了~')}//自定義事件,主要用于事件綁定
})
           

4、小程式的樣式

  在每個頁面中的wxss檔案中,對wxml中的結構進行樣式設定,等同于css,擴充了rpx機關。其中app.wxss預設為全局樣式,作用所有頁面。

開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&cps_key=128419a2e140e43270be962309035fcb&from=activity

三、小程式實戰-天氣預報(利用和風天氣API)

先看看完成後的效果,一共三個頁面,測試demo不求美觀,不喜勿噴~

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&amp;cps_key=128419a2e140e43270be962309035fcb&amp;from=activity
微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&amp;cps_key=128419a2e140e43270be962309035fcb&amp;from=activity
微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&amp;cps_key=128419a2e140e43270be962309035fcb&amp;from=activity

1、設定底部菜單和頁面

我們就在quick start生成的demo基礎上進行修改即可,因為涉及圖示icon,我們建立一個images檔案夾來存放圖檔

在原先pages檔案夾中,删除index和log頁面檔案夾,建立weather、city、about三個頁面檔案夾,及三個頁面對應的四個檔案類型,檔案結構如下圖

微信小程式-開發入門(一)開發微信小程式,必備騰訊雲伺服器,優惠購買位址:https://cloud.tencent.com/redirect.php?redirect=10172&amp;cps_key=128419a2e140e43270be962309035fcb&amp;from=activity

接下來配置app.json檔案

/*app.json,該檔案不能含有任何注釋,是以正式應用需删除所有注釋内容*/
{
  "pages":[//小程式的頁面路徑數組,第一條預設為首頁,所有頁面均需寫在這裡,否則不能加載
    "pages/weather/weather",
    "pages/about/about",
    "pages/city/city"
  ],
  "window":{//小程式架構設定
    "navigationBarBackgroundColor": "#000",
    "navigationBarTitleText": "天氣預報",
    "navigationBarTextStyle":"#fff",
    "backgroundColor":"#666",
    "backgroundTextStyle":"light",
    "enablePullDownRefresh":true
  },
  "tabBar": {//小程式底部菜單設定
    "color": "#666",
    "selectedColor": "#56abe4",
    "backgroundColor": "#ddd",
    "borderStyle":"black",
    "list": [{
      "pagePath": "pages/weather/weather",
      "iconPath": "images/tabbar/weather1.png",
      "selectedIconPath": "images/tabbar/weather2.png",
      "text": "天氣預報"
    }, {
      "pagePath": "pages/city/city",
      "iconPath": "images/tabbar/city1.png",
      "selectedIconPath": "images/tabbar/city2.png",
      "text": "設定城市"
    }, {
      "pagePath": "pages/about/about",
      "iconPath": "images/tabbar/about1.png",
      "selectedIconPath": "images/tabbar/about2.png",
      "text": "關于我"
    }],
    "position":"bottom"
  }
}
           

2、注冊小程式和整體樣式

修改app.js和app.wxss兩個檔案如下

//app.js
App({
  //1、系統事件部分
  onLaunch: function () {//小程式初始化時執行
    var that=this;
    that.curid = wx.getStorageSync('curid') || that.curid;//API:擷取本地緩存,若不存在設定為全局屬性
    that.setlocal('curid', that.curid);//調用全局方法
  },
  //2、自定義全局方法部分
  setlocal:function(id,val){
    wx.setStorageSync(id, val);//API:設定本地緩存
  },
  //3、自定義全局屬性部分
  curid:"CN101010100",
  version:"1.0"
})
           
/**app.wxss**/
.container {margin: 0; padding: 0;}
.title{font-size: 14px; font-weight: bold;}
           

3、頁面的結構(wxml)、樣式(wxss)、邏輯(js)和配置(json)

小程式中的wxml摒棄了HTML标簽, 改用view(類似div)、text(類似span)、icon等等,class同html指定樣式,bindtap綁定事件(類似onclick),該頁面無特殊配置,json檔案内容為空(非必須檔案)

<!--weather.wxml-->
<view class="container">
  <view class="city" bindtap="bindViewTap">
    <text>目前城市:{{basic.city}}</text><!--{{}}用來擷取同頁js檔案中注冊頁面data中的資料-->
    <text class="update">{{basic.update.loc}}</text>
  </view>
</view>
<!--省略。。。-->
           
/**weather.wxss**/
.city {padding: 3% 5%; background: #ddd;}
.city text{font-size: 16px; color: #666;}
.city .update{ font-size: 12px; float: right;}
           
//weather.js
var app = getApp();//擷取目前小程式執行個體,友善使用全局方法和屬性
Page({
  //1、頁面資料部分,将綁定到視圖wxml中
  data:{cur_id:app.curid,basic:"",now:""},//設定頁面資料,後面空值将在頁面顯示時通過請求伺服器擷取
  //2、系統事件部分
  onShow:function(){
    var that = this;
    wx.showToast({title: '加載中',icon: 'loading',duration: 10000})//設定加載模态框
    that.getnow(function(d){//回調函數,根據資料設定頁面data,更新到視圖
      wx.hideToast();//隐藏加載框
      d.now.cond.src="http://files.heweather.com/cond_icon/"+d.now.cond.code+".png";
      that.setData({basic:d.basic,now:d.now})//更新資料,視圖将同步更新
    })},
  //3、自定義頁面方法:擷取目前天氣API
  getnow:function(fn){
    wx.request({//請求伺服器,類似ajax
      url: 'https://free-api.heweather.com/v5/now', 
      data: {city:app.curid,key:'01a7798b060b468abdad006ea3de4713'},//和風天氣提供使用者key,可自行注冊獲得
      header: {'Content-Type': 'application/json'},
      success: function(res) {fn(res.data.HeWeather5[0]);}//成功後将資料傳給回調函數執行
    })
  },
  //4、頁面事件綁定部分
  bindViewTap:function(){wx.switchTab({url: '../city/city'})}//跳轉菜單頁面 
})
           

 其他頁面代碼略,項目源檔案見GitHub:https://github.com/gavin125/wxtest

4、注意防坑

跳轉并重新整理頁面:需使用onshow來代替onload執行邏輯,onload隻在首次打開頁面時執行一次。如:B頁面操作全局資料并跳轉A頁面,A頁面onshow中擷取全局資料更新視圖。