引言
在整理小程序開發(fā)教程的過(guò)程中忘伞,是按照一定的邏輯順序來(lái)整理的奶段。
首先得安裝自己的編輯器,不管是使用微信開發(fā)者工具
或是引入Jar包的WebStorm
伙狐。
假使涮毫,我使用的是微信官方開發(fā)者工具,需得了解編輯器的各種面板的功能贷屎。
另外罢防,需要了解HelloWorld
項(xiàng)目的代碼結(jié)構(gòu)及運(yùn)行方式。(主要是了解Wxml的代碼結(jié)構(gòu)與語(yǔ)法)
再后來(lái)才到Wxss
的樣式整理唉侄。
代碼構(gòu)成
項(xiàng)目里邊生成了不同類型的文件:
-
.json
后綴的 JSON 配置文件 -
.wxml
后綴的 WXML 模板文件 -
.wxss
后綴的 WXSS 樣式文件 -
.js
后綴的 JS 腳本邏輯文件
JSON 配置
我們可以看到在項(xiàng)目的根目錄有一個(gè) app.json
和 project.config.json
咒吐,此外在 pages/logs
目錄下還有一個(gè) logs.json
,我們依次來(lái)說(shuō)明一下它們的用途。
1. 小程序配置 app.json
app.json
是當(dāng)前小程序的全局配置恬叹,包括了小程序的所有頁(yè)面路徑候生、界面表現(xiàn)、網(wǎng)絡(luò)超時(shí)時(shí)間绽昼、底部 tab
等陶舞。QuickStart 項(xiàng)目里邊的 app.json 配置內(nèi)容如下:
{
"pages": ["pages/index/index", "pages/logs/logs"],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle": "black"
}
}
我們簡(jiǎn)單說(shuō)一下這個(gè)配置各個(gè)項(xiàng)的含義:
-
pages
字段 —— 用于描述當(dāng)前小程序所有頁(yè)面路徑,這是為了讓微信客戶端知道當(dāng)前你的小程序頁(yè)面定義在哪個(gè)目錄绪励。 -
window
字段 —— 定義小程序所有頁(yè)面的頂部背景顏色肿孵,文字顏色定義等。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 小程序的配置 app.json 疏魏。
2. 工具配置 project.config.json
通常大家在使用一個(gè)工具的時(shí)候停做,都會(huì)針對(duì)各自喜好做一些個(gè)性化配置,例如界面顏色大莫、編譯配置等等蛉腌,當(dāng)你換了另外一臺(tái)電腦重新安裝工具的時(shí)候,你還要重新配置只厘。
考慮到這點(diǎn)烙丛,小程序開發(fā)者工具在每個(gè)項(xiàng)目的根目錄都會(huì)生成一個(gè) project.config.json
,你在工具上做的任何配置都會(huì)寫入到這個(gè)文件羔味,當(dāng)你重新安裝工具或者換電腦工作時(shí)河咽,你只要載入同一個(gè)項(xiàng)目的代碼包,開發(fā)者工具就自動(dòng)會(huì)幫你恢復(fù)到當(dāng)時(shí)你開發(fā)項(xiàng)目時(shí)的個(gè)性化配置赋元,其中會(huì)包括編輯器的顏色忘蟹、代碼上傳時(shí)自動(dòng)壓縮等等一系列選項(xiàng)。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 開發(fā)者工具的配置 搁凸。
3. 頁(yè)面配置 page.json
這里的 page.json
其實(shí)用來(lái)表示 pages/logs
目錄下的 logs.json
這類和小程序頁(yè)面相關(guān)的配置媚值。
如果你整個(gè)小程序的風(fēng)格是藍(lán)色調(diào),那么你可以在
app.json
里邊聲明頂部顏色是藍(lán)色即可护糖。實(shí)際情況可能不是這樣褥芒,可能你小程序里邊的每個(gè)頁(yè)面都有不一樣的色調(diào)來(lái)區(qū)分不同功能模塊,因此我們提供了page.json
嫡良,讓開發(fā)者可以獨(dú)立定義每個(gè)頁(yè)面的一些屬性锰扶,例如剛剛說(shuō)的頂部顏色、是否允許下拉刷新等等皆刺。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 頁(yè)面配置 少辣。
WXML 模板
從事過(guò)網(wǎng)頁(yè)編程的人知道,網(wǎng)頁(yè)編程采用的是 HTML + CSS + JS
這樣的組合羡蛾,其中HTML
是用來(lái)描述當(dāng)前這個(gè)頁(yè)面的結(jié)構(gòu)漓帅,CSS
用來(lái)描述頁(yè)面的樣子,JS
通常是用來(lái)處理這個(gè)頁(yè)面和用戶的交互。
同樣道理忙干,在小程序中也有同樣的角色器予,其中 WXML
充當(dāng)?shù)木褪穷愃?HTML
的角色。打開 pages/index/index.wxml
捐迫,你會(huì)看到以下的內(nèi)容:
<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
由標(biāo)簽、屬性等等構(gòu)成施戴。但是也有很多不一樣的地方反浓,我們來(lái)一一闡述一下:
1. 標(biāo)簽名字有點(diǎn)不一樣
往往寫 HTML
的時(shí)候,經(jīng)常會(huì)用到的標(biāo)簽是 div
, p
, span
赞哗,開發(fā)者在寫一個(gè)頁(yè)面的時(shí)候可以根據(jù)這些基礎(chǔ)的標(biāo)簽組合出不一樣的組件雷则,例如日歷
、彈窗
等等肪笋。換個(gè)思路月劈,既然大家都需要這些組件,為什么我們不能把這些常用的組件包裝起來(lái)藤乙,大大提高我們的開發(fā)效率猜揪。
從上邊的例子可以看到,小程序的 WXML
用的標(biāo)簽是 view
, button
, text
等等坛梁,這些標(biāo)簽就是小程序給開發(fā)者包裝好的基本能力而姐,我們還提供了地圖
、視頻
罚勾、音頻
等等組件能力毅人。
更多詳細(xì)的組件講述參考下個(gè)章節(jié) 小程序的能力
2. 多了一些 wx:if
這樣的屬性以及 {{ }}
這樣的表達(dá)式
在網(wǎng)頁(yè)的一般開發(fā)流程中,我們通常會(huì)通過(guò) JS
操作 DOM
(對(duì)應(yīng) HTML
的描述產(chǎn)生的樹)尖殃,以引起界面的一些變化響應(yīng)用戶的行為。
例如划煮,用戶點(diǎn)擊某個(gè)按鈕的時(shí)候送丰,JS
會(huì)記錄一些狀態(tài)到 JS
變量里邊,同時(shí)通過(guò) DOM
API 操控 DOM
的屬性或者行為弛秋,進(jìn)而引起界面一些變化器躏。當(dāng)項(xiàng)目越來(lái)越大的時(shí)候,你的代碼會(huì)充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量蟹略,顯然這不是一個(gè)很好的開發(fā)模式登失,因此就有了 MVVM
的開發(fā)模式(例如 React
, Vue
),提倡把渲染和邏輯分離挖炬。簡(jiǎn)單來(lái)說(shuō)就是不要再讓 JS
直接操控 DOM
揽浙,JS
只需要管理狀態(tài)即可,然后再通過(guò)一種模板語(yǔ)法來(lái)描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可。
小程序的框架也是用到了這個(gè)思路馅巷,如果你需要把一個(gè) Hello World
的字符串顯示在界面上膛虫。
WXML 是這么寫 :
<text>{{msg}}</text>
JS 只需要管理狀態(tài)即可:
this.setData({msg: 'Hello World'})
通過(guò) {{ }}
的語(yǔ)法把一個(gè)變量綁定到界面上,我們稱為數(shù)據(jù)綁定钓猬。
僅僅通過(guò)數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系稍刀,還需要 if
/else
, for
等控制能力,在小程序里邊敞曹,這些控制能力都用 wx:
開頭的屬性來(lái)表達(dá)账月。
更詳細(xì)的文檔可以參考 WXML
WXSS 樣式
WXSS
具有 CSS
大部分的特性,小程序在 WXSS
也做了一些擴(kuò)充和修改澳迫。
新增了尺寸單位捶障。在寫
CSS
樣式時(shí),開發(fā)者需要考慮到手機(jī)設(shè)備的屏幕會(huì)有不同的寬度和設(shè)備像素比纲刀,采用一些技巧來(lái)?yè)Q算一些像素單位项炼。WXSS
在底層支持新的尺寸單位rpx
,開發(fā)者可以免去換算的煩惱示绊,只要交給小程序底層來(lái)?yè)Q算即可锭部,由于換算采用的浮點(diǎn)數(shù)運(yùn)算,所以運(yùn)算結(jié)果會(huì)和預(yù)期結(jié)果有一點(diǎn)點(diǎn)偏差面褐。提供了全局的樣式和局部樣式拌禾。和前邊
app.json
,page.json
的概念相同,你可以寫一個(gè)app.wxss
作為全局樣式展哭,會(huì)作用于當(dāng)前小程序的所有頁(yè)面湃窍,局部頁(yè)面樣式page.wxss
僅對(duì)當(dāng)前頁(yè)面生效。此外
WXSS
僅支持部分CSS
選擇器
更詳細(xì)的文檔可以參考 WXSS 匪傍。
JS 交互邏輯
一個(gè)服務(wù)僅僅只有界面展示是不夠的您市,還需要和用戶做交互:響應(yīng)用戶的點(diǎn)擊、獲取用戶的位置等等役衡。在小程序里邊茵休,我們就通過(guò)編寫 JS
腳本文件來(lái)處理用戶的操作。
<view>{{ msg }}</view>
<button bindtap="clickMe">點(diǎn)擊我</button>
點(diǎn)擊 button
按鈕的時(shí)候手蝎,我們希望把界面上 msg
顯示成 "Hello World"榕莺,于是我們?cè)?button
上聲明一個(gè)屬性: bindtap
,在 JS 文件里邊聲明了 clickMe
方法來(lái)響應(yīng)這次點(diǎn)擊操作:
Page({
clickMe() {
this.setData({msg: 'Hello World'})
}
})
響應(yīng)用戶的操作就是這么簡(jiǎn)單棵介,更詳細(xì)的事件可以參考文檔 WXML - 事件 钉鸯。
此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API,利用這些 API 可以很方便的調(diào)起微信提供的能力邮辽,例如獲取用戶信息
唠雕、本地存儲(chǔ)
贸营、微信支付
等。在前邊的 QuickStart 例子中及塘,在 pages/index/index.js
就調(diào)用了 wx.getUserInfo
獲取微信用戶的頭像和昵稱莽使,最后通過(guò) setData
把獲取到的信息顯示到界面上。更多 API 可以參考文檔 小程序的API 笙僚。
通過(guò)這個(gè)章節(jié)芳肌,你了解了小程序涉及到的文件類型以及對(duì)應(yīng)的角色,在下個(gè)章節(jié)中肋层,我們把這一章所涉及到的文件通過(guò) “小程序的框架” 給 “串” 起來(lái)亿笤,讓他們都工作起來(lái)。