微信小程序

小程序由四類文件組成,js,json,wxml,wxss。

  1. json是一種數據格式,並不是一種語言,在小程序中json起靜態配置的作用。如下爲一段json文件的內容。
{
  "pages": [
    "pages/start/start",
    "pages/index/index",
    "pages/mine/mine"
  ],
  "window": {
    "navigationBarTextStyle": "white",
    "navigationBarBackgroundColor": "#118fff",
    "navigationBarTitleText": "雲吸貓",
    "backgroundColor": "#fff"
  },
  "tabBar": {
    "color": "#9BABBA",
    "selectedColor": "#495056",
    "borderStyle": "white",
    "backgroundColor": "#ffffff",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首頁",
        "iconPath": "images/home.png",
        "selectedIconPath": "images/home_active.png"
      },
      {
        "pagePath": "pages/mine/mine",
        "text": "我的",
        "iconPath": "images/mine.png",
        "selectedIconPath": "images/mine_active.png"
      }
    ]
  },

page是每個頁面路徑列表,不需要把四種文件都寫出來,例如有一個start文件夾裏有start.js,start.json,start.wxss,start.wxml。
列表爲**“pages/starts/starts”**用,隔開

windows用於設置小程序的狀態欄,導航條,標題,窗口背景色等
例如“navigationBarTextStyle”代表導航欄文字的顏色,只有black和white兩種
"navigationBarBackgroundColor"代表導航欄的顏色,由#和6位16位數字表示。
navigationBarTitleText"代表導航欄文本
"backgroundColor"代表窗口背景色
具體的可以參考這篇文檔:微信小程序全局配置

頁面配置
每一個小程序頁面也可以用同名的.json文件進行配置相同的配置類型會覆蓋全局配置.json文件
工具配置 project.config.json
你在工具上做的任何配置都會寫入到這個文件,當你重新安裝工具或者換電腦工作時,你只要載入同一個項目的代碼包,開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置,其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。

JSON 語法
JSON文件都是被包裹在一個大括號中 {},通過key-value的方式來表達數據。JSON的Key必須包裹在一個雙引號中,在實踐中,編寫 JSON 的時候,忘了給 Key 值加雙引號或者是把雙引號寫成單引號是常見錯誤。

1.數字,包含浮點數和整數
2.字符串,需要包裹在雙引號中
3.Bool值,true 或者 false
4.數組,需要包裹在方括號中 []
5.對象,需要包裹在大括號中 {}
6.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 是這麼寫 :

{{msg}}
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 腳本文件來處理用戶的操作。

{{ msg }}
點擊我
點擊 button 按鈕的時候,我們希望把界面上 msg 顯示成 “Hello World”,於是我們在 button 上聲明一個屬性: bindtap ,在 JS 文件裏邊聲明瞭 clickMe 方法來響應這次點擊操作:

Page({
clickMe() {
this.setData({msg: ‘Hello World’})
}
})
響應用戶的操作就是這麼簡單,更詳細的事件可以參考文檔 WXML - 事件 。

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

注:官方文檔爲微信小程序代碼構成

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章