小程序 - 簡單入門

環境搭建

申請帳號

開發小程序的第一步,你須要擁有一個小程序賬號,經過這個賬號你就能夠管理你的小程序。html

點擊 https://mp.weixin.qq.com/wxopen/waregister?action=step1 根據指引填寫信息和提交相應的資料,就能夠擁有本身的小程序賬號。git

登陸 https://mp.weixin.qq.com ,咱們能夠在菜單 「設置」-「開發設置」 看到小程序的 AppID 了 。json

小程序的 AppID 至關於小程序平臺的一個身份證,後續你會在不少地方要用到 AppID (注意這裏要區別於服務號或訂閱號的 AppID)。小程序

有了小程序賬號以後,咱們須要一個工具來開發小程序。微信小程序

安裝開發工具

前往 開發者工具下載頁面 ,根據本身的操做系統下載對應的安裝包進行安裝,有關開發者工具更詳細的介紹能夠查看 《開發者工具介紹》api

打開小程序開發者工具,用微信掃碼登陸開發者工具,準備開發你的第一個小程序吧!bash

第一個小程序

新建項目選擇小程序項目,選擇代碼存放的硬盤路徑,填入剛剛申請到的小程序的 AppID,給你的項目起一個好聽的名字,最後,勾選 "建立 QuickStart 項目" (注意: 你要選擇一個空的目錄纔會有這個選項),點擊肯定,你就獲得了你的第一個小程序了,點擊頂部菜單編譯就能夠在 IDE 預覽你的第一個小程序。微信

編譯預覽

修改小程序必需要先編譯才能看到修改後的效果。網絡

點擊工具上的編譯按鈕,能夠在工具的左側模擬器界面看到這個小程序的表現,也能夠點擊預覽按鈕,經過微信的掃一掃在手機上體驗你的第一個小程序。app

代碼構成

在上一章中,咱們經過開發者工具快速建立了一個 QuickStart 項目。你能夠留意到這個項目裏邊生成了不一樣類型的文件:

.json 後綴的 JSON 配置文件 .wxml 後綴的 WXML 模板文件 .wxss 後綴的 WXSS 樣式文件 .js 後綴的 JS 腳本邏輯文件 接下來咱們分別看看這4種文件的做用。

JSON配置

咱們能夠看到在項目的根目錄有一個 app.json 和 project.config.json,此外在 pages/logs 目錄下還有一個 logs.json,咱們依次來講明一下他們的用途。

工具配置 project.config.json

一般你們在使用一個工具的時候,都會針對各自喜愛作一些個性化配置,例如界面顏色、編譯配置等等,當你換了另一臺電腦從新安裝工具的時候,你還要從新配置。

考慮到這點,小程序開發者工具在每一個項目的根目錄都會生成一個 project.config.json,你在工具上作的任何配置都會寫入到這個文件,當你從新安裝工具或者換電腦工做時,你只要載入同一個項目的代碼包,開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置,其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。

小程序配置 app.json

app.json 是對當前小程序的全局配置,包括了小程序的全部頁面路徑、界面表現、網絡超時時間、底部 tab 等。QuickStart 項目裏邊的 app.json 配置內容以下:

簡單說一下這個配置各個項的含義:

  • pages字段 —— 用於描述當前小程序全部頁面路徑,這是爲了讓微信客戶端知道當前你的小程序頁面定義在哪一個目錄。
  • window字段 —— 小程序全部頁面的頂部背景顏色,文字顏色定義在這裏的。

其餘配置項細節能夠參考文檔 小程序的配置 app.json

頁面配置 page.json

這裏的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關的配置。

若是你整個小程序的風格是藍色調,那麼你能夠在 app.json 裏邊聲明頂部顏色是藍色便可。實際狀況可能不是這樣,可能你小程序裏邊的每一個頁面都有不同的色調來區分不一樣功能模塊,所以咱們提供了 page.json,讓開發者能夠獨立定義每一個頁面的一些屬性,例如剛剛說的頂部顏色、是否容許下拉刷新等等。 其餘配置項細節能夠參考文檔 小程序的配置 page.json

WXML 模板

HTML 是用來描述當前這個頁面的結構,WXML 的做用和HTML同樣,只不過是裏面的元素標籤是用小程序本身封裝的標籤名。

打開 pages/index/index.wxml,你會看到如下的內容:

雖然WXML 和 HTML 很是類似,有標籤、屬性等等構成。可是也有不少不同的地方,咱們來一一闡述一下:

  1. 標籤名字有點不同 每每寫 HTML 的時候,常常會用到的標籤是 div, p, span,開發者在寫一個頁面的時候能夠根據這些基礎的標籤組合出不同的組件,例如日曆、彈窗等等。換個思路,既然你們都須要這些組件,爲何咱們不能把這些經常使用的組件包裝起來,大大提升咱們的開發效率。 從上邊的例子能夠看到,小程序的 WXML 用的標籤是 view, button, text 等等,這些標籤就是小程序給開發者包裝好的基本能力,咱們還提供了地圖、視頻、音頻等等組件能力 更多詳細的組件講述參考下個章節 小程序的能力

  2. 多了一些 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 也作了一些擴充和修改。

  1. 新增了尺寸單位。在寫 CSS 樣式時,開發者須要考慮到手機設備的屏幕會有不一樣的寬度和設備像素比,採用一些技巧來換算一些像素單位。WXSS 在底層支持新的尺寸單位 rpx ,開發者能夠免去換算的煩惱,只要交給小程序底層來換算便可,因爲換算採用的浮點數運算,因此運算結果會和預期結果有一點點誤差。
  2. 提供了全局的樣式和局部樣式。和前邊 app.json, page.json 的概念相同,你能夠寫一個 app.wxss 做爲全局樣式,會做用於當前小程序的全部頁面,局部頁面樣式 page.wxss 僅對當前頁面生效。
  3. 此外 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

地圖demo

若是要在當前的小程序中新增一個地圖頁面,須要再app.json中增長配置,而後,在pages文件夾下新增 map文件夾以及map.js、map.json、map.wxml、map.wxss:

小程序提供了不少組件,咱們僅僅須要在map.wxml 使用map組件,並設置相應的屬性名便可:

map元素上綁定了兩個變量longitude、latitude,須要再map.js對其進行賦值:

圖中在onReady生命週期中利用 小程序api - wx.getLocation獲取到當前的經度、緯度,獲取到以後 利用setData方法對longitude、latitude進行初始化。

最後地圖頁面效果:

結束語

本文只是對微信小程序簡單介紹,詳細文檔可查閱 微信小程序基礎

相關文章
相關標籤/搜索