24小時服務電話:17712205170 查看騰訊廣告代理商資質
  • 微信官網
    訪問微信官網
  • 小程序
    訪問小程序

南通微信小程序開發教您JSON 配置

 
2019-08-24人氣:所屬分類:行業新聞
JSON 配置
 
JSON 是一種數據格式,并不是編程語言,在小程序中,JSON扮演的靜态配置的角色。
 
我們可以看到在項目的根目錄有一個 app.json 和 project.config.json,此外在 pages/logs 目錄下還有一個 logs.json,我們依次來說明一下它們的用途。
 
小程序配置 app.json
 
app.json 是當前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等。QuickStart 項目裡邊的 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,讓開發者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顔色、是否允許下拉刷新等等。
 
其他配置項細節可以參考文檔 頁面配置 。
 
JSON 語法
 
這裡說一下小程序裡JSON配置的一些注意事項。
 
JSON文件都是被包裹在一個大括号中 {},通過key-value的方式來表達數據。JSON的Key必須包裹在一個雙引号中,在實踐中,編寫 JSON 的時候,忘了給 Key 值加雙引号或者是把雙引号寫成單引号是常見錯誤。
 
JSON的值隻能是以下幾種數據格式,其他任何格式都會觸發報錯,例如 JavaScript 中的 undefined。
 
數字,包含浮點數和整數
字符串,需要包裹在雙引号中
Bool值,true 或者 false
數組,需要包裹在方括号中 []
對象,需要包裹在大括号中 {}
Null
還需要注意的是 JSON 文件中無法使用注釋,試圖添加注釋将會引發報錯。
 
WXML 模闆
 
從事過網頁編程的人知道,網頁編程采用的是 HTML + CSS + JS 這樣的組合,其中 HTML 是用來描述當前這個頁面的結構,CSS 用來描述頁面的樣子,JS 通常是用來處理這個頁面和用戶的交互。
 
同樣道理,在小程序中也有同樣的角色,其中 WXML 充當的就是類似 HTML 的角色。打開 pages/index/index.wxml,你會看到以下的内容:
 
<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 這樣的屬性以及  這樣的表達式
 
在網頁的一般開發流程中,我們通常會通過 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 。
 
通過這個章節,你了解了小程序涉及到的文件類型以及對應的角色,在下個章節中,我們把這一章所涉及到的文件通過 “小程序的框架” 給 “串” 起來,讓他們都工作起來。