微信小程式-01-專案組成檔案介紹(入門篇)
阿新 • • 發佈:2018-12-10
自古開篇先說兩句,寫這些筆記不是學習用的,主要是後續分享一些遇到的坑,碰到過什麼樣的問題,怎麼去解決,如果你不是一個很耐心無看文章的人,建議去 網易雲課堂找一些課程,跟著別人的腳步或許會更有動力,我的筆記也是從哪裡學習,記一些小筆記,我覺得大學裡做這件事是最合適的了,當然最重要的是有沒有興趣,如果沒有興趣,就別把它當場一個學習的任務,找一項真正自己感興趣的,去深度瞭解,做到很精才是真正有意義的事
微信小程式-01-專案組成檔案介紹
JSON 配置檔案
- 我們可以看到在專案的根目錄有一個 app.json 和 project.config.json,此外在 pages/logs 目錄下還有一個 logs.json
- 我們依次來說明一下它們的用途。
小程式配置 app.json
- app.json 是當前小程式的全域性配置,包括了小程式的所有頁面路徑、介面表現、網路超時時間、底部 tab 等。新建的專案裡邊的 app.json 配置內容如下:
{
//頁面路徑
"pages":[
"pages/index/index",
"pages/logs/logs"
],
//介面表現
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText" : "WeChat",
"navigationBarTextStyle":"black"
}
}
我們簡單說一下這個配置各個項的含義:
- pages欄位 —— 用於描述當前小程式所有頁面路徑,這是為了讓微信客戶端知道當前你的小程式頁面定義在哪個目錄
- window欄位 —— 定義小程式所有頁面的頂部背景顏色,文字顏色定義等。 其他配置項細節可以參考文件 小程式的配置 app.json
工具配置 project.config.json
- 通常大家在使用一個工具的時候,都會針對各自喜好做一些個性化配置
- 例如介面顏色、編譯配置等等,當你換了另外一臺電腦重新安裝工具的時候,你還要重新配置
- 考慮到這點,小程式開發者工具在每個專案的根目錄都會生成一個 project.config.json,你在工具上做的任何配置都會寫入到這個檔案,當你重新安裝工具或者換電腦工作時,你只要載入同一個專案的程式碼包,開發者工具就自動會幫你恢復到當時你開發專案時的個性化配置,其中會包括編輯器的顏色、程式碼上傳時自動壓縮等等一系列選項
- 其他配置項細節可以參考文件 開發者工具的配置
頁面配置 page.json
- 這裡的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程式頁面相關的配置
- 如果你整個小程式的風格是藍色調,那麼你可以在 app.json 裡邊宣告頂部顏色是藍色即可。實際情況可能不是這樣,可能你小程式裡邊的每個頁面都有不一樣的色調來區分不同功能模組,因此我們提供了 page.json,讓開發者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顏色、是否允許下拉重新整理等等
- 其他配置項細節可以參考文件 頁面配置 。
WXML 模板
- 從事過網頁程式設計的人知道,網頁程式設計採用的是 HTML + CSS + JS 這樣的組合,其中 HTML 是用來描述當前這個頁面的結構,CSS 用來描述頁面的樣子,JS 通常是用來處理這個頁面和使用者的互動
- 同樣道理,在小程式中也有同樣的角色,其中 WXML 充當的就是類似 HTML 的角色。開啟 pages/index/index.wxml,你會看到以下的內容:
//view 想象成 div
<view class="container">
<view class="userinfo">
<button wx:if="{{!hasUserInfo && canIUse}}"> 獲取頭像暱稱 </button>
<block wx:else>
<image src="{{userInfo.avatarUrl}}" background-size="cover"></image>
<text class="userinfo-nickname">{{userInfo.nickName}}</text>
</block>
</view>
<view class="usermotto">
<text class="user-motto">{{motto}}</text>
</view>
</view>
- 和 HTML 非常相似,WXML 由標籤、屬性等等構成。但是也有很多不一樣的地方,我們來一一闡述一下:
- 標籤名字有點不一樣
- 往往寫 HTML 的時候,經常會用到的標籤是 div, p, span,開發者在寫一個頁面的時候可以根據這些基礎的標籤組合出不一樣的元件,例如日曆、彈窗等等。換個思路,既然大家都需要這些元件,為什麼我們不能把這些常用的元件包裝起來,大大提高我們的開發效率
- 從上邊的例子可以看到,小程式的 WXML 用的標籤是 view, button, text 等等,這些標籤就是小程式給開發者包裝好的基本能力,我們還提供了地圖、視訊、音訊等等元件能力
- 多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表示式
MVVM 的開發模式
- 在網頁的一般開發流程中,我們通常會通過 JS 操作 DOM (對應 HTML 的描述產生的樹),以引起介面的一些變化響應使用者的行為
- 例如,使用者點選某個按鈕的時候,JS 會記錄一些狀態到 JS 變數裡邊,同時通過 DOM API 操控 DOM 的屬性或者行為,進而引起介面一些變化
- 當專案越來越大的時候,你的程式碼會充斥著非常多的介面互動邏輯和程式的各種狀態變數,顯然這不是一個很好的開發模式,因此就有了 MVVM 的開發模式(例如 React, Vue),提倡把渲染和邏輯分離。簡單來說就是不要再讓 JS 直接操控 DOM,JS 只需要管理狀態即可,然後再通過一種模板語法來描述狀態和介面結構的關係即可
- 小程式的框架也是用到了這個思路,下面舉例
如果你需要把一個 Hello World 的字串顯示在介面上
- WXML 是這麼寫 :
//寫一個變數佔位
<text>{{msg}}</text>
- JS 只需要管理狀態即可:
this.setData({ msg: "Hello World" })
- 通過 {{ }} 的語法把一個變數繫結到介面上,我們稱為資料繫結。僅僅通過資料繫結還不夠完整的描述狀態和介面的關係,還需要 if/else, for等控制能力,在小程式裡邊,這些控制能力都用 wx: 開頭的屬性來表達。
- 更詳細的文件可以參考 WXML
WXSS 樣式
- WXSS 具有 CSS 大部分的特性,小程式在 WXSS 也做了一些擴充和修改
- 新增了尺寸單位。在寫 CSS 樣式時,開發者需要考慮到手機裝置的螢幕會有不同的寬度和裝置畫素比,採用一些技巧來換算一些畫素單位。WXSS 在底層支援新的尺寸單位 rpx ,開發者可以免去換算的煩惱,只要交給小程式底層來換算即可,由於換算採用的浮點數運算,所以運算結果會和預期結果有一點點偏差
- 提供了全域性的樣式和區域性樣式。和前邊 app.json, page.json 的概念相同,你可以寫一個 app.wxss 作為全域性樣式,會作用於當前小程式的所有頁面,區域性頁面樣式 page.wxss 僅對當前頁面生效
- 此外 WXSS 僅支援部分 CSS 選擇器
- 更詳細的文件可以參考 WXSS 。
JS 互動邏輯
- 一個服務僅僅只有介面展示是不夠的,還需要和使用者做互動:響應使用者的點選、獲取使用者的位置等等。在小程式裡邊,我們就通過編寫 JS 指令碼檔案來處理使用者的操作
<view>{{ msg }}</view>
<button bindtap="clickMe">點選我</button>
- 點選 button 按鈕的時候,我們希望把介面上 msg 顯示成 “Hello World”,於是我們在 button 上宣告一個屬性: bindtap ,在 JS 檔案裡邊聲明瞭 clickMe 方法來響應這次點選操作:
Page({
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
- 響應使用者的操作就是這麼簡單,更詳細的事件可以參考文件 WXML - 事件 。
- 此外你還可以在 JS 中呼叫小程式提供的豐富的 API,利用這些 API 可以很方便的調起微信提供的能力,例如獲取使用者資訊、本地儲存、微信支付等。在前邊的 QuickStart 例子中,在 pages/index/index.js 就呼叫了 wx.getUserInfo 獲取微信使用者的頭像和暱稱,最後通過 setData 把獲取到的資訊顯示到介面上
- 更多 API 可以參考文件 小程式的API