一．寫在前面

1.為什麼要學小程式開發？

    對於前端開發而言，微信小程式因為其簡單快速、開發成本低、使用者流量巨大等特點，也就成了前端開發工程師必會的一個技能。

2.先看看小程式效果

（1）歡迎頁

（2）首頁：輪播頭圖，天氣，豆瓣電影正在熱映

（3）全國城市切換頁

（4）天氣詳情頁

（5）地圖周邊服務

（6）豆瓣電影

（7）熱點新聞

（8）更多頁面

3.開發準備：

（1）有人開玩笑說，會vue小程式根本都不用學：

微信小程式雖然是騰訊自己搞的，但是核心的思想跟vue等框架是一樣一樣的哦~

（2）善於蒐集精美的小元件： “我們不生產程式碼，我們只是程式碼的搬運工”，善於找到想要的元件並把他們巧妙優雅的組裝成一個大專案，也算是程式設計師一項基本技能了。

具體怎麼找到想要的小程式demo，篇末會給大家推薦小程式的資源，有很多大神的專案哦

 擼起袖子開幹了

一.註冊小程式賬號，下載IDE

1.官網註冊https://mp.weixin.qq.com/，並下載IDE。

2.官方文件一向都是最好的學習資料。

注意：

（1）註冊賬號之後會有一個appid，新建專案的時候需要填上，不然很多功能是用不了的，比如不能預覽，不能上傳程式碼等等。

（2）如果你註冊過微信公眾號的話，一定要注意，微信公眾號和小程式是兩個賬號，二者的appid也是不同，小程式開發必須使用小程式的appid哦。

二.小程式框架介紹和執行機制

1.我們建立了“普通快速啟動模板”，然後整個專案目錄如下：

2.app.js

整個專案的啟動檔案，如註釋寫的onlaunch方法有三大功能，瀏覽器快取進行存和取資料；用登陸成功的回撥；獲取使用者資訊。

globalData是定義整個專案的全域性變數或者常量哦。

3.app.json

整個專案的配置檔案，比如註冊頁面，配置tab頁，設定整個專案的樣式，頁面標題等等；

！注意：小程式啟動預設的第一個頁面，就是app.json的pages中的第一個頁面哦。

4.pages

小程式的頁面元件，有幾個頁面就會有幾個子資料夾。比如快速啟動模板，就有兩個頁面，index和logs

5.開啟index目錄

可以看到有三個檔案，其實和我們web開發的檔案是一一對應的。

index.wxml對應index.html；

index.wxss對應index.css；

index.js就是js檔案哦。

一般我們還會給每個頁面元件新增一個.json檔案，作為該頁面元件的配置檔案，設定頁面標題等功能

6.雙擊index.js檔案

（1）var app = getApp(); 

引入整個專案的app.js檔案，用來取期中的公共變數等資訊。

如果要使用util.js工具庫中的某個方法，在util.js中module.exports匯出，然後在需要的頁面中require即可得到哦。

（2）比如，我們要獲取豆瓣電影的時候，我們需要呼叫豆瓣的api；我們先在app.js中的gloabData中定義doubanBase

然後在index.js中使用app.globaData.doubanBase即可取到這個值。

當然這些常量你也可以在頁面需要的時候，再用寫死的值，但是為了整個專案的維護，還是建議把這種公用引數統一寫在配置檔案中哦。

（3）接下來在整個page({})中，第一個data，就是本頁面元件的內部資料，會渲染到該頁面的wxml檔案中，類似於vue、react哦~

通過setData修改data資料，驅動頁面渲染

（4）一些生命週期函式

比如onload()， onready(), onshow(), onhide()等等，監聽頁面載入、頁面初次渲染、頁面顯示、頁面隱藏等等

更多的可以查官網API哦。其中用的最多的就是onload()方法，和onShareAppMessage()方法（設定頁面分享的資訊）

7 .wxml模板的使用。

比如本專案電影頁面，就是以最小的星級評價元件wxml當做模板，star到movie到movie-list，一級一級的巢狀使用。

 star-template.wxml頁面寫好name屬性；然後import引入的時候通過name獲得即可

8.常用的wxml標籤

view，text，icon，swiper，block，scroll-view等等，這些標籤直接查官網文件即可

三.小程式框架、各個頁面以及釋出上線的注意點

1.整個框架中的一些注意點

（1）整個wxml頁面，最底層的標籤是<page></page>哦。

（2） 每個頁面頂部導航欄的顏色，title在本頁面的json中配置，如果沒有配置的話，取app.json中的總配置哦。

（3）json中不能寫註釋哦，不然會報錯的。

（4）路由相關

1）使用wx.SwitchTab跳轉tab頁的話，在app.json中除了註冊pages頁面，還需要在tabBar中註冊tab頁，才能生效哦。

注意：tab最多5個，也就是我們說的頭部或者底部最多5個選單。其他的頁面只能通過其他路由方法開啟哦。

2）navigateTo是跳到某個非tab頁，比如歡迎頁，電影詳情頁，城市選擇頁；在app.json中註冊後，不能在tabBar裡註冊哦，不然同樣也是不能跳轉的哦。

3）reLaunch跳轉，新開的頁面左上角是沒有退回按鈕的，本專案只用了一次，切換城市的時候哦。

（5）頁面之間傳遞引數

引數寫在跳轉的url之中，然後另一個頁面在onload方法中的傳參option接收到。如下傳遞和獲取id

（6）data-開頭的自定義屬性的使用

比如wxml中我們怎麼寫 

點選的事件物件可以這麼取，var postId = event.currentTarget.dataset.postid;

注意： 大寫會轉換成小寫，帶_符號會轉成駝峰形式

（7）事件物件event，event.target和event.currentTarget的區別：

target指的是當前點選的元件 和currentTarget 指的是事件捕獲的元件。

比如，輪播圖元件，點選事件應該要繫結到swiper上，這樣才能監控任意一張圖片是否被點選，

這時target這裡指的是image（因為點選的是圖片），而currentTarget指的是swiper（因為繫結點選事件在swiper上）

（8）使用免費的網路介面：

本專案中用到了 和風天氣api，騰訊地圖api，百度地圖api，豆瓣電影api，聚合頭條新聞api等，具體用法可以看各自官網的介面文件哦，很詳細的

注意：免費介面是有訪問限制的，所以如果用別人的元件用了這種介面的話，最好還是自己註冊一個新的key替換上哦

附上一個免費介面大全：

https://github.com/jokermonn/-Api

！！另外還要注意，要把這些介面的域名配置到小程式的合法域名中，不然也是訪問不了的

（8）wxss有一個坑：無法讀取本地資源，比如背景圖片用本地就會報錯哦。

把本地圖片弄成網路圖片的幾種方式： 上傳到個人網站；QQ空間相簿等等也是可以的哦

2.切換城市頁面：

（1）首頁使用navigateTo跳轉到切換城市頁，由於首頁並沒有關閉，導致切換了城市返回來，天氣資訊還是舊的。

正確的處理邏輯如下：

1）使用reLaunch跳轉到切換城市頁面，實質是關閉所有頁面開啟新的頁面哦。

2）切換城市頁面，更新公共變數中城市資訊為手動切換的城區，再switchTab回到首頁，觸發首頁重新載入。

3）首頁獲取城市資訊的時候加一個判斷，全域性沒有才取定位的，全域性有（比如剛才設定了）就用全域性的哦。

（2）城市列表的滾動和回到頂部

基於scroll-view元件的scroll-top屬性，初始就是0，滾動就會增加的；點選回到頂部給它置為0即可回到頂部

3.天氣頁

（1）初始化頁面，天氣顯示的邏輯

首先呼叫小程式的wx.getLocation方法獲得當前的經緯度，然後呼叫騰訊地圖獲得當前的城市名稱和區縣名稱，並存到公共變數中，

再呼叫查詢天氣和空氣質量的方法哦。

（2）容錯處理

城市的名稱長短不一，有點名字特別長，比如巴彥淖爾市這種，需要動態的獲取完整的城市名稱；

有些偏僻的城市暫時沒有天氣資訊，我們需要對返回的結果進行判斷，沒有資訊的需要給使用者一個良好的提示資訊。

4.周邊-地圖服務頁面

（1）呼叫百度地圖的各種服務，查詢酒店，美食，生活服務三種資訊，更多資訊可以看百度地圖的文件

（2）點選時給被點中的圖示加個邊框，資料驅動檢視，所以使用一個長度為3的陣列儲存三個圖示當前是否被點中的狀態

然後wxml再根據資料來動態新增class，增加邊框樣式

5.豆瓣電影頁

（1）電影詳情頁的預覽圖片，用小程式本身的previewImage實現。

（2）詳情頁使用onReachBottom()方法，監控使用者上拉觸底事件，然後傳送請求繼續獲得資料，實現懶載入的效果

（3）使用者體驗方面的優化，js中將整數評分比如7分統一改為7.0分，然後wxml模板再判斷分數是否為0顯示“暫無評分”

（4）搜尋之後清空搜尋框

因為小程式中不能使用getelementbyId這種方式獲得元素，只能用資料來控制了

在data中加一個屬性searchText來儲存搜尋框的內容並和 input的value屬性繫結，搜尋完成或者點選X時，searchText變數清空即可實現清空輸入框的效果哦。

6.新聞頁面

（1）聚合頭條新聞的免費介面，只返回了新聞的基本資訊，新聞的主體內容是沒有的哦。

我找了好多新聞類的介面，好像都是沒有新聞主體內容的。如果誰知道更好的介面歡迎留言告訴我哈~

（2）當然，也可以自己去爬新聞網站的資料哦

7.更多頁面

 （1）小程式目前開放外鏈的功能只是給公司組織的小程式開放了，個人開發還是不能使用外鏈的哦。

 （2）彩蛋頁面，獲得使用者資訊

通過 wx.setStorageSync('userInfos', userInfos);  可以獲得登陸小程式的使用者的個人資訊，可以傳送給後臺存到資料庫中，方便對使用者進行分析

我這裡只是儲存到瀏覽器快取中哦，最大應該是10M快取；如果使用者把這個小程式從小程式列表中刪除掉，就會清空這個快取。

8.釋出注意

（1） 新版本小程式釋出的限制為2M，一般都是圖片最佔空間，所以儘量使用網路圖片

具體怎麼把本地圖片變成網路圖片，上面有講哦。

（2）在開發者工具上預覽測試沒問題，點選上傳；網頁版小程式個的人中心的左側“開發管理”選單，第三塊--開發版本就有了內容。

（3）點選提交，填寫小程式相關資訊，就可以提交稽核了哦。

注意：分類最好填寫準確，這樣才能更快的通過稽核哦。我這個小程式一天半時間過審上線的

至此，我就把兩天開發內碰到的坑和注意點都過了一遍，據說還有更多的坑，等之後更深入的開發再繼續研究咯。

四.寫在最後

1.推薦幾個小程式開發的資料

（1）知乎一篇小程式的資料：

https://www.zhihu.com/question/50907897

（2）小程式社群

http://www.wxapp-union.com/portal.php

（3）極樂小程式商店

http://store.dreawer.com/

2.本專案的github地址

 https://github.com/yllg/WXxcx