微信小程序實戰教程：火車票查詢（含demo）
微信小程序，雖然目前還不知道其在微信的接入口，但應該和訂閱號、服務號以及企業號會有所不同。搜索打開使用，用完關閉，沒有移動app的安裝、下載等過程，微信流量大，輕便、易用等特性是其優點。然而正是因為這個 ...
|
界面展示
結合動態圖描述一下目前實現的功能： 2.1 主頁上半部分顯示用戶頭像與用戶名（和微信中的信息一致，這部分組件是工具自帶的，我們可以修改這部分組件和內容，稍候會提到）；下半部分顯示一個經典的問候語“Hello World”，提供一個可點擊的按鈕“點擊獲取火車票”； 2.2 點擊按鈕后，通過事先指定的參數（調用了百度APIStore中去哪網火車票查詢接口，站-站查詢所需參數為始發地、目的地及時間）發送網絡請求，將獲取到的JSON數據按火車車次為節點進行解析并在新頁面顯示基本信息（除了詳細座位信息），為每個車次提供一個可點擊的按鈕“點擊查看座位信息”； 2.3 點擊某車次中的座位查詢按鈕后，會將該車次對應的所有座位信息顯示在新頁面中； 2.4 點擊后兩個頁面左上角的“返回”按鈕可回到上一頁，這個功能也是工具自帶的；
順便提一下在博客園中插入動畫，上面的演示過程是一張格式為gif的圖片，像添加普通圖片一樣操作即可。錄制工具使用的是靈者Gif錄制，可以指定開始、停止時所需操作與區域等錄制信息。
3. 要點分析 關于微信小程序工具的使用及初始項目的結構說明，網上資源已經很豐富，這里不打算再啰嗦
下面開始講講我個人在學習與開發過程中認為值得分享與記錄的點，歡迎大小神們一起討論與指正，特別是講得不對或有待改善的地方。下面只給出和講的點直接相關的代碼，整體代碼可以到項目工程中去查看，建議大家自己調試一遍。
3.1 index index是項目新建時自動生成的，作為小程序的啟動頁面。 3.1.1 index.wxml 首頁的頭像與用戶名，從上圖的演示過程可以看出我將微信的名字“***”改成了“用戶名”：
用戶名部分原本的內容為{{userInfo.nickName}}，{{key_name}}的作用是獲取關鍵字名為key_name對應的值（數據一般以key_name:value的形式定義在wxml文件同目錄下js文件的data成員中，后面會講解），image顯示的頭像資源也是通過這種方式指定為src="{{userInfo.avatarUrl}}"，程序中產生的數據可以在開發者工具頂部偏右的AppData欄中查看。 如果不需要從js文件中獲取數據，那么可以像代碼中“用戶名”那樣直接寫入數據值，不過一般不推薦這樣做，因為像Android等平臺App在開發時會將數據值放入strings.xml等文件，目的是為了將數據與布局分離，布局和功能實現代碼分離，方便開發與維護。 組件中的class項用來設置其樣式，屬性名對應的樣式信息定義在wxss文件中，除了可以使用定義在本目錄wxss文件中的樣式，還可以使用app.wxss文件中定義的。如果樣式只是在某頁面中使用，那么建議定義在其目錄下的wxss文件中，即局部作用域內；如果是多個頁面共同使用，即全局樣式，那么一般定義在主程序app.wxss文件中。class樣式可以指定組件的寬高、背景顏色等屬性，本文不再進行詳述。 在界面下方添加按鈕“點擊獲取火車票”組件：
按鈕的目標是為了讓用戶可以點擊進行交互，至于使用button、text或其他組件，視具體需求而定。這里是利用text組件，文本內容直接寫入了字串“點擊獲取火車票”，對于只有一個子組件的布局其實可以如下面代碼不用嵌套，一層布局搞定。一般來說嵌套層數越少，加載速度越快，這對移動程序的體驗是至關重要的。
但如果在父容器下有多個子組件共享其定義的樣式，那么嵌套可以另代碼簡潔很多：
組件若要有點擊交互功能，須為其綁定事件響應方法，常用的有單點--bindtap，長按--binglongtap。bindtap="getTrainInfo"，雙引號中的文本是方法名稱，在js文件中以該名定義方法，做需要的處理即可。 3.1.2 index.js 實現wxml布局中按鈕“點擊獲取火車票”綁定的函數功能：
我們先來看看微信小程序官網對于網絡請求方法--wx.request(OBJECT)的說明：
一般來說，wx api提供的方法默認會有一個Object參數，需要時傳入，不需要時不傳便是。不過這對于像我這種Android開發者來說一開始有點不適應，怎么函數調用時都傳入一個{...}參數，內部各個項之間用逗號“,”分隔，代碼中的url、data等。 從代碼中看，發起網絡請求時傳入了圖中列出的四項參數：url、header、data及success，不同需求傳入的參數也會不同。對于wx.request方法而言，需根據網絡請求目標來傳參數的是前四項：url、header、data及method。 以本案例利用百度APIStore去哪網火車票獲取站--站火車票信息來說（http://apistore.baidu.com/apiworks/servicedetail/697.html），其官網給出的接口調用的參數信息與格式如下：
將上面兩張圖中的信息結合起來看，參數是一一對應的： wx url——火車票查詢 接口地址； header——請求參數header； data——請求參數urlParam； method——請求方法； 因為wx中的method參數默認是GET，和火車票查詢接口指定的一致，所以調用時可以省略。 而對于最后三個回調函數：success、fail及comlete，代碼中添加了success，在請求成功時對數據進行處理。當然，一般的程序還得對請求失敗的情況做處理。下面就來分析success方法中的代碼，包括JSON數據的轉換與新頁面的跳轉，請求返回的數據以參數res的形式傳入到function中。先來看看res中包含了哪些信息，通過代碼console.log(res)可以將其打印在工具調試頁面的Console項中。
request--ok和statusCode--200表示請求成功，所以才會回調success方法。而data對象才是我們需要的數據，更精確地說，data.data.trainList對象才是真正的火車票信息。 var json = res.data，獲取data對象（網絡請求返回的數據一般為JSON格式），賦給變量json； var jsonString = JSON.stringify(json)，將JSON類型對象暫時轉換為String類型，用來作為url的參數部分進行傳遞；一開始在這里耽擱了很久，不進行轉換直接傳的話在目標頁面獲取不到想要的數據，下面會說明原因； url: '../train/train?trainInfos='+jsonString，通過url指定的信息跳轉到對應頁面，如果不需要額外參數，直接寫url: '../train/train'；如果只是傳遞簡單的值，可寫成url: '../train/train?param=123'； 至此，如果網絡沒有問題，點擊按鈕便可以進行火車票的查詢并攜帶結果數據跳轉到新頁面了。
3.2 train train是自定義新建的頁面，用來顯示火車票基本信息，注意新添的頁面需在app.json文件中進行配置。
3.2.1 train.wxml 由于站--站火車票所有車次的始發站和終點站是一樣，如北京--杭州東，所以先在頁面頂部顯示站點信息：
trainList對象會在js文件中定義成data成員，值為上面最后一張圖中的JSON對象--trainList，即火車票車次數組，每個元素包含一個車次的具體信息。 接下來顯示每個車次的信息，以橫線作分隔（由于是以學習和測試為目的，所以就沒有在布局的美觀上下功夫，大家見諒）：
第1、11行很簡單，在站點與車次、車次與車次之間添加橫線。 當布局中的組件個數和js中的數據有關，即在wxml中寫死組件不能滿足需求時，可以利用block和wx:for來進行組件的動態生成。 第2行wx:for="{{trainList}}"表示block塊中的組件可以使用數組trainList中的內容，從下標0開始迭代，數據中有幾個元素，就會動態生成幾套組件。wx:for-item="train"指定數組中元素的名稱為train（默認的是item，指定的意義之一是可讀性強），后續獲取屬性值時可通過train.key_name的形式。 第3行開始添加組件，類型是text，值為{{index+1}}. 車次：{{train.trainNo}}，前半部分用來標明每個車次的序號，從1開始；而index和item類似，是默認的迭代索引名稱，其實就是數組元素當前的下標，從0開始。 后面幾行添加text組件和第3行差不多，但第8行有兩個點說一下： *1 bindtap="getSeatInfo"，綁定一個回調函數，點擊時跳轉到新頁面，顯示當前車次對應的座位信息； *2 id="trainindex-{{index}}"，給組件指定id，可以看到之前的組件都沒有設置過該屬性（不需要就可以不設置），那么什么時候需要呢？其中一種情況，當js中某組件綁定的回調方法需要得知是哪個組件觸發了自己的時候，比如第一點中的方法getSeatInfo，要想點擊某車次的查看座位信息按鈕后顯示出對應的座位信息，就得知道點擊組件對應的trainList數組下標，而這個需求，正好可以借助id和index屬性來實現； 3.2.2 train.js 首先定義data成員trainList，用來接收index頁面傳遞過來的數據： trainList: [] 頁面啟動時若有數據需要載入，那么得添加onLoad方法（一開始自動運行，在其中實現數據的加載與處理），否則可以不添加。
當方法的調用者有參數傳入時，我們可以通過添加方法參數的形式來獲取。對于參數名，自動啟方法一般為options，組件回調方法一般為e（event）。 第2行獲取index頁面在打開train頁面時傳入的火車票信息參數trainInfos。 第4行將String類型對象轉換回JSON格式，之前在index頁面提到過，url傳的參數是由JSON格式對象轉換過來的String類型。 第6行將真正的火車票車次信息數組取出，賦給數據成員trainList。 注意：給數據成員賦值時，必須調用頁面自身的setData方法，否則就算賦值了也不會同步到wxml文件中去，這一點容易出錯且不好定位原因。 車次數組得到后，wxml文件就會根據組件的屬性設置顯示對應的信息。再來看實現按鈕“點擊查看座位信息”對應的回調方法：
第2、3行獲取之前定義的組件id中的index部分，即點擊組件對應的trainList數組的下標。當然原先定義時也可以不添加前綴'trainindex-'，完全是為了可讀性，因為當項目越來越大時有個一目了然的標示總是不錯的。 第6、7行分別獲取車次信息的列車號與座位信息，他們稍候會被傳遞到seat頁面。 第9行同樣地將得到的JSON格式對象先轉換為String類型，讓其可以在url中作為可被正確傳遞的參數。 第11行打開新的頁面seat顯示座位信息，多個參數之間以“&”符號分隔。 3.2.3 train.json 主程序中app.json文件除了配置需要調用onLoad方法的頁面外，還指定了一些全局的window樣式。若某個頁面在自己的json文件中沒有定義局部的window屬性，或根本沒有json文件，那默認將使用全局的。 項目初始沒有為index生成json文件，因為其作為啟動頁，直接用全局的“WeChat”就好，其實index標題應該是小程序的名稱，我們自己真正開發的程序肯定得取另一個名字。 可以看到，logs、train及seat都對標題進行了定義，結果就是會覆蓋掉全局的值。以train為例，其在json文件中定義標題為“站-站火車查詢信息”：
還有一點，頁面的json文件不需要也不能頁面配置屬性（Pages），只能設置window屬性，所以就可以省略window名稱，直接像上述代碼用{...}形式即可。
3.3 seat seat頁面用來顯示某車次的座位信息，包括座位等級、票價及余票。通過train頁面的分析，相信大家對網絡請求，數據在頁面與頁面、wxml與js文件之間的傳遞漸漸熟悉了。而seat和train類似，沒有什么特別的地方，所以和logs一樣這里就不再講什么了。
4. 小感悟 微信小程序，雖然目前還不知道其在微信的接入口，但應該和訂閱號、服務號以及企業號會有所不同。搜索打開使用，用完關閉，沒有移動app的安裝、下載等過程，微信流量大，輕便、易用等特性是其優點。然而正是因為這個優點，開發者擔心這有可能使得小程序不能夠像app那樣強大，畢竟接入口、審核機制、推廣成本以及最大允許內存等這些還未確定的因素對一款應用來說都是至關重要的。 對于初學者（如原先搞android開發），暫且不管上面提到的那些，在弄明白應用需求的同時，得邁開并加快對前端知識學習的腳步了。 |
