4. 小程序:頁(yè)面構(gòu)成

在上一章中,我們通過開發(fā)者工具快速創(chuàng)建了一個(gè) QuickStart 項(xiàng)目系任。你可以留意到這個(gè)項(xiàng)目里邊生成了不同類型的文件:

  1. .json 后綴的 JSON 配置文件
  2. .wxml 后綴的 WXML 模板文件
  3. .wxss 后綴的 WXSS 樣式文件
  4. .js 后綴的 JS 腳本邏輯文件

接下來(lái)我們分別看看這4種文件的作用丙躏。

JSON 配置

我們可以看到在項(xiàng)目的根目錄有一個(gè) app.json 和 project.config.json,此外在 pages/logs 目錄下還有一個(gè) logs.json,我們依次來(lái)說(shuō)明一下他們的用途腰耙。

小程序配置 app.json

app.json 是對(duì)當(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)的含義:

  1. pages字段 —— 用于描述當(dāng)前小程序所有頁(yè)面路徑挠阁,這是為了讓微信客戶端知道當(dāng)前你的小程序頁(yè)面定義在哪個(gè)目錄。
  2. window字段 —— 小程序所有頁(yè)面的頂部背景顏色溯饵,文字顏色定義在這里的侵俗。

其他配置項(xiàng)細(xì)節(jié)可以參考文檔 小程序的配置 app.json

工具配置 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ā)者工具的配置 磷箕。

頁(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é)可以參考文檔 小程序的配置 page.json

WXML 模板

從事過網(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 非常相似斑响,有標(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ì)通過 JS 操作 DOM (對(duì)應(yīng) HTML 的描述產(chǎn)生的樹)运翼,以引起界面的一些變化響應(yīng)用戶的行為。例如兴枯,用戶點(diǎn)擊某個(gè)按鈕的時(shí)候血淌,JS 會(huì)記錄一些狀態(tài)到 JS 變量里邊,同時(shí)通過 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)即可,然后再通過一種模板語(yǔ)法來(lái)描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可美侦。 小程序的框架也是用到了這個(gè)思路产舞,如果你需要把一個(gè) Hello World 的字符串顯示在界面上。 WXML 是這么寫 :

    <text></text>
    
    

    JS 只需要管理狀態(tài)即可:

    this.setData({ msg: "Hello World" })
    
    

    通過 {{ }} 的語(yǔ)法把一個(gè)變量綁定到界面上菠剩,我們稱為數(shù)據(jù)綁定易猫。僅僅通過數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系,還需要 if/else, for等控制能力具壮,在小程序里邊准颓,這些控制能力都用 wx: 開頭的屬性來(lái)表達(dá)。 更詳細(xì)的文檔可以參考 WXML

WXSS 樣式

WXSS 具有 CSS 大部分的特性棺妓,小程序在 WXSS 也做了一些擴(kuò)充和修改攘已。

  1. 新增了尺寸單位。在寫 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)偏差幌陕。
  2. 提供了全局的樣式和局部樣式诵姜。和前邊 app.json, page.json 的概念相同,你可以寫一個(gè) app.wxss 作為全局樣式搏熄,會(huì)作用于當(dāng)前小程序的所有頁(yè)面棚唆,局部頁(yè)面樣式 page.wxss 僅對(duì)當(dāng)前頁(yè)面生效。
  3. 此外 WXSS 僅支持部分 CSS 選擇器

更詳細(xì)的文檔可以參考 WXSS 心例。

JS 交互邏輯

一個(gè)服務(wù)僅僅只有界面展示是不夠的宵凌,還需要和用戶做交互:響應(yīng)用戶的點(diǎn)擊、獲取用戶的位置等等止后。在小程序里邊瞎惫,我們就通過編寫 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: function() {
    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 獲取微信用戶的頭像和昵稱,最后通過 setData 把獲取到的信息顯示到界面上喳逛。更多 API 可以參考文檔 小程序的API 瞧捌。

通過這個(gè)章節(jié),你了解了小程序涉及到的文件類型以及對(duì)應(yīng)的角色润文,在下個(gè)章節(jié)中姐呐,我們把這一章所涉及到的文件通過 “小程序的框架” 給 “串” 起來(lái),讓他們都工作起來(lái)典蝌。

小程序開發(fā)目錄

1. 小程序:快速創(chuàng)建第一個(gè)小程序

2. 小程序:文件結(jié)構(gòu)

3. 小程序:配置

4. 小程序:頁(yè)面構(gòu)成

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末曙砂,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子骏掀,更是在濱河造成了極大的恐慌鸠澈,老刑警劉巖柱告,帶你破解...
    沈念sama閱讀 211,639評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異笑陈,居然都是意外死亡际度,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,277評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門涵妥,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)乖菱,“玉大人,你說(shuō)我怎么就攤上這事蓬网≈纤” “怎么了?”我有些...
    開封第一講書人閱讀 157,221評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵帆锋,是天一觀的道長(zhǎng)吵取。 經(jīng)常有香客問我,道長(zhǎng)窟坐,這世上最難降的妖魔是什么海渊? 我笑而不...
    開封第一講書人閱讀 56,474評(píng)論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮哲鸳,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘盔憨。我一直安慰自己徙菠,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,570評(píng)論 6 386
  • 文/花漫 我一把揭開白布郁岩。 她就那樣靜靜地躺著婿奔,像睡著了一般。 火紅的嫁衣襯著肌膚如雪问慎。 梳的紋絲不亂的頭發(fā)上萍摊,一...
    開封第一講書人閱讀 49,816評(píng)論 1 290
  • 那天,我揣著相機(jī)與錄音如叼,去河邊找鬼冰木。 笑死,一個(gè)胖子當(dāng)著我的面吹牛笼恰,可吹牛的內(nèi)容都是我干的踊沸。 我是一名探鬼主播,決...
    沈念sama閱讀 38,957評(píng)論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼社证,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼逼龟!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起追葡,我...
    開封第一講書人閱讀 37,718評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤腺律,失蹤者是張志新(化名)和其女友劉穎奕短,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體匀钧,經(jīng)...
    沈念sama閱讀 44,176評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡翎碑,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,511評(píng)論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了榴捡。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片杈女。...
    茶點(diǎn)故事閱讀 38,646評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖吊圾,靈堂內(nèi)的尸體忽然破棺而出达椰,到底是詐尸還是另有隱情,我是刑警寧澤项乒,帶...
    沈念sama閱讀 34,322評(píng)論 4 330
  • 正文 年R本政府宣布啰劲,位于F島的核電站,受9級(jí)特大地震影響檀何,放射性物質(zhì)發(fā)生泄漏蝇裤。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,934評(píng)論 3 313
  • 文/蒙蒙 一频鉴、第九天 我趴在偏房一處隱蔽的房頂上張望栓辜。 院中可真熱鬧,春花似錦垛孔、人聲如沸藕甩。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,755評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)狭莱。三九已至,卻和暖如春概作,著一層夾襖步出監(jiān)牢的瞬間腋妙,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,987評(píng)論 1 266
  • 我被黑心中介騙來(lái)泰國(guó)打工讯榕, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留骤素,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,358評(píng)論 2 360
  • 正文 我出身青樓瘩扼,卻偏偏與公主長(zhǎng)得像谆甜,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子集绰,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,514評(píng)論 2 348

推薦閱讀更多精彩內(nèi)容