引用微信開放平臺文檔
樣式文件(類似CSS)
WXSS 具有 CSS 大部分的特性,小程序在 WXSS 也做了一些擴(kuò)充和修改。
更詳細(xì)的文檔可以參考 WXSS 。
模板文件(類似HTML)
從事過網(wǎng)頁編程的人知道,網(wǎng)頁編程采用的是 HTML + CSS + JS 這樣的組合,其中 HTML 是用來描述當(dāng)前這個頁面的結(jié)構(gòu), CSS 用來描述頁面的樣子, JS 通常是用來處理這個頁面和用戶的交互。
和 HTML 非常相似, WXML 由標(biāo)簽、屬性等等構(gòu)成。但是也有很多不一樣的地方,我們來一一闡述一下:
往往寫 HTML 的時候,經(jīng)常會用到的標(biāo)簽是 div , p , span ,開發(fā)者在寫一個頁面的時候可以根據(jù)這些基礎(chǔ)的標(biāo)簽組合出不一樣的組件,例如日歷、彈窗等等。換個思路,既然大家都需要這些組件,為什么我們不能把這些常用的組件包裝起來,大大提高我們的開發(fā)效率。
從上邊的例子可以看到,小程序的 WXML 用的標(biāo)簽是 view , button , text 等等,這些標(biāo)簽就是小程序給開發(fā)者包裝好的基本能力,我們還提供了地圖、視頻、音頻等等組件能力。
在網(wǎng)頁的一般開發(fā)流程中,我們通常會通過 JS 操作 DOM (對應(yīng) HTML 的描述產(chǎn)生的樹),以引起界面的一些變化響應(yīng)用戶的行為。例如,用戶點擊某個按鈕的時候, JS 會記錄一些狀態(tài)到 JS 變量里邊,同時通過 DOM API 操控 DOM 的屬性或者行為,進(jìn)而引起界面一些變化。當(dāng)項目越來越大的時候,你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量,顯然這不是一個很好的開發(fā)模式,因此就有了 MVVM 的開發(fā)模式(例如 React, Vue),提倡把渲染和邏輯分離。簡單來說就是不要再讓 JS 直接操控 DOM , JS 只需要管理狀態(tài)即可,然后再通過一種模板語法來描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可。
小程序的框架也是用到了這個思路,如果你需要把一個 Hello World 的字符串顯示在界面上。
WXML 是這么寫 :
<text>{{msg}}</text>
JS 只需要管理狀態(tài)即可:
this.setData({ msg: "Hello World" })
通過 {{ }} 的語法把一個變量綁定到界面上,我們稱為數(shù)據(jù)綁定。僅僅通過數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系,還需要 if / else , for 等控制能力,在小程序里邊,這些控制能力都用 wx: 開頭的屬性來表達(dá)。
一個服務(wù)僅僅只有界面展示是不夠的,還需要和用戶做交互:響應(yīng)用戶的點擊、獲取用戶的位置等等。在小程序里邊,我們就通過編寫 JS (JavaScript)腳本文件來處理用戶的操作。
<view>{{ msg }}</view> <button bindtap="clickMe">點擊我</button>
點擊 button 按鈕的時候,我們希望把界面上 msg 顯示成 "Hello World" ,于是我們在 button 上聲明一個屬性: bindtap ,在 JS 文件里邊聲明了 clickMe 方法來響應(yīng)這次點擊操作
Page({ clickMe: function() { this.setData({ msg: "Hello World" }) } })
此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API,利用這些 API 可以很方便的調(diào)起微信提供的能力,例如獲取用戶信息、本地存儲、微信支付等。在前邊的 QuickStart 例子中,在 pages/index/index.js 就調(diào)用了 wx.getUserInfo 獲取微信用戶的頭像和昵稱,最后通過 setData 把獲取到的信息顯示到界面上。更多 API 可以參考文檔 小程序的API 。
json數(shù)據(jù)類型,用于靜態(tài)配置
是當(dāng)前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現(xiàn)、網(wǎng)絡(luò)超時時間、底部 tab 等。QuickStart 項目里邊的 app.json 配置內(nèi)容
—— 用于描述當(dāng)前小程序所有頁面路徑,這是為了讓微信客戶端知道當(dāng)前你的小程序頁面定義在哪個目錄。
—— 定義小程序所有頁面的頂部背景顏色,文字顏色定義等。
通常大家在使用一個工具的時候,都會針對各自喜好做一些個性化配置,例如界面顏色、編譯配置等等,當(dāng)你換了另外一臺電腦重新安裝工具的時候,你還要重新配置。
考慮到這點,小程序開發(fā)者工具在每個項目的根目錄都會生成一個 project.config.json ,你在工具上做的任何配置都會寫入到這個文件,當(dāng)你重新安裝工具或者換電腦工作時,你只要載入同一個項目的代碼包,開發(fā)者工具就自動會幫你恢復(fù)到當(dāng)時你開發(fā)項目時的個性化配置,其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項
參考文檔: 文檔
這里的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關(guān)的配置。
如果你整個小程序的風(fēng)格是藍(lán)色調(diào),那么你可以在 app.json 里邊聲明頂部顏色是藍(lán)色即可。實際情況可能不是這樣,可能你小程序里邊的每個頁面都有不一樣的色調(diào)來區(qū)分不同功能模塊,因此我們提供了 page.json ,讓開發(fā)者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顏色、是否允許下拉刷新等等。
工作日 8:30-12:00 14:30-18:00
周六及部分節(jié)假日提供值班服務(wù)