小程序的代碼組成結(jié)構(gòu)

2022-07-22    分類(lèi): 網(wǎng)站建設(shè)

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

.json 后綴的 JSON 配置文件

.wxml 后綴的 WXML 模板文件

.wxss 后綴的 WXSS 樣式文件

.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)的含義:

pages字段 —— 用于描述當(dāng)前小程序所有頁(yè)面路徑,這是為了讓微信客戶(hù)端知道當(dāng)前你的小程序頁(yè)面定義在哪個(gè)目錄。

window字段 —— 小程序所有頁(yè)面的頂部背景顏色,文字顏色定義在這里的。

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

工具配置 project.config.json

通常大家在使用一個(gè)工具的時(shí)候,都會(huì)針對(duì)各自喜好做一些個(gè)性化配置,例如界面顏色、編譯配置等等,當(dāng)你換了另外一臺(tái)電腦重新安裝工具的時(shí)候,你還要重新配置。

考慮到這點(diǎn),小程序開(kāi)發(fā)者工具在每個(gè)項(xiàng)目的根目錄都會(huì)生成一個(gè) project.config.json,你在工具上做的任何配置都會(huì)寫(xiě)入到這個(gè)文件,當(dāng)你重新安裝工具或者換電腦工作時(shí),你只要載入同一個(gè)項(xiàng)目的代碼包,開(kāi)發(fā)者工具就自動(dòng)會(huì)幫你恢復(fù)到當(dāng)時(shí)你開(kāi)發(fā)項(xiàng)目時(shí)的個(gè)性化配置,其中會(huì)包括編輯器的顏色、代碼上傳時(shí)自動(dòng)壓縮等等一系列選項(xiàng)。

其他配置項(xiàng)細(xì)節(jié)可以參考文檔 開(kāi)發(fā)者工具的配置 。

頁(yè)面配置 page.json

這里的 page.json 其實(shí)用來(lái)表示 pages/logs 目錄下的 logs.json 這類(lèi)和小程序頁(yè)面相關(guān)的配置。

如果你整個(gè)小程序的風(fēng)格是藍(lán)色調(diào),那么你可以在 app.json 里邊聲明頂部顏色是藍(lán)色即可。實(shí)際情況可能不是這樣,可能你小程序里邊的每個(gè)頁(yè)面都有不一樣的色調(diào)來(lái)區(qū)分不同功能模塊,因此我們提供了 page.json,讓開(kāi)發(fā)者可以獨(dú)立定義每個(gè)頁(yè)面的一些屬性,例如剛剛說(shuō)的頂部顏色、是否允許下拉刷新等等。

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

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è)面和用戶(hù)的交互。

同樣道理,在小程序中也有同樣的角色,其中 WXML 充當(dāng)?shù)木褪穷?lèi)似 HTML 的角色。打開(kāi) pages/index/index.wxml,你會(huì)看到以下的內(nèi)容:

<view class="container">  <view class="userinfo">    <button wx:if="{{!hasUserInfo && canIUse}}"> 獲取頭像昵稱(chēng) </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)一一闡述一下:

標(biāo)簽名字有點(diǎn)不一樣 往往寫(xiě) HTML 的時(shí)候,經(jīng)常會(huì)用到的標(biāo)簽是 div, p, span,開(kāi)發(fā)者在寫(xiě)一個(gè)頁(yè)面的時(shí)候可以根據(jù)這些基礎(chǔ)的標(biāo)簽組合出不一樣的組件,例如日歷、彈窗等等。換個(gè)思路,既然大家都需要這些組件,為什么我們不能把這些常用的組件包裝起來(lái),大大提高我們的開(kāi)發(fā)效率。 從上邊的例子可以看到,小程序的 WXML 用的標(biāo)簽是 view, button, text 等等,這些標(biāo)簽就是小程序給開(kāi)發(fā)者包裝好的基本能力,我們還提供了地圖、視頻、音頻等等組件能力 更多詳細(xì)的組件講述參考下個(gè)章節(jié) 小程序的能力

多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表達(dá)式 在網(wǎng)頁(yè)的一般開(kāi)發(fā)流程中,我們通常會(huì)通過(guò) JS 操作 DOM (對(duì)應(yīng) HTML 的描述產(chǎn)生的樹(shù)),以引起界面的一些變化響應(yīng)用戶(hù)的行為。例如,用戶(hù)點(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è)很好的開(kāi)發(fā)模式,因此就有了 MVVM 的開(kāi)發(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 是這么寫(xiě) :

<text></text>

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

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

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

WXSS 樣式

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

新增了尺寸單位。在寫(xiě) CSS 樣式時(shí),開(kāi)發(fā)者需要考慮到手機(jī)設(shè)備的屏幕會(huì)有不同的寬度和設(shè)備像素比,采用一些技巧來(lái)?yè)Q算一些像素單位。WXSS 在底層支持新的尺寸單位 rpx ,開(kāi)發(fā)者可以免去換算的煩惱,只要交給小程序底層來(lái)?yè)Q算即可,由于換算采用的浮點(diǎn)數(shù)運(yùn)算,所以運(yùn)算結(jié)果會(huì)和預(yù)期結(jié)果有一點(diǎn)點(diǎn)偏差。

提供了全局的樣式和局部樣式。和前邊 app.json, page.json 的概念相同,你可以寫(xiě)一個(gè) app.wxss 作為全局樣式,會(huì)作用于當(dāng)前小程序的所有頁(yè)面,局部頁(yè)面樣式 page.wxss 僅對(duì)當(dāng)前頁(yè)面生效。

此外 WXSS 僅支持部分 CSS 選擇器

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

JS 交互邏輯

一個(gè)服務(wù)僅僅只有界面展示是不夠的,還需要和用戶(hù)做交互:響應(yīng)用戶(hù)的點(diǎn)擊、獲取用戶(hù)的位置等等。在小程序里邊,我們就通過(guò)編寫(xiě) JS 腳本文件來(lái)處理用戶(hù)的操作。

<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)用戶(hù)的操作就是這么簡(jiǎn)單,更詳細(xì)的事件可以參考文檔 WXML - 事件 。

此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API,利用這些 API 可以很方便的調(diào)起微信提供的能力,例如獲取用戶(hù)信息、本地存儲(chǔ)、微信支付等。在前邊的 QuickStart 例子中,在 pages/index/index.js 就調(diào)用了 wx.getUserInfo 獲取微信用戶(hù)的頭像和昵稱(chēng),最后通過(guò) setData 把獲取到的信息顯示到界面上。更多 API 可以參考文檔 小程序的API 。

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

網(wǎng)站欄目:小程序的代碼組成結(jié)構(gòu)
網(wǎng)站路徑:http://www.muchs.cn/news25/181425.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供外貿(mào)建站、網(wǎng)站營(yíng)銷(xiāo)、用戶(hù)體驗(yàn)品牌網(wǎng)站建設(shè)、自適應(yīng)網(wǎng)站動(dòng)態(tài)網(wǎng)站

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶(hù)投稿、用戶(hù)轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀(guān)點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話(huà):028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)

小程序開(kāi)發(fā)