開發(fā)小程序的第一步,你需要擁有一個小程序帳號励饵,通過這個帳號你就可以管理你的小程序。
點擊 https://mp.weixin.qq.com/wxopen/waregister?action=step1 根據(jù)指引填寫信息和提交相應的資料滑燃,就可以擁有自己的小程序帳號役听。
登錄 https://mp.weixin.qq.com ,我們可以在菜單 “設置”-“開發(fā)設置” 看到小程序的 AppID 了 。
小程序的 AppID 相當于小程序平臺的一個身份證典予,后續(xù)你會在很多地方要用到 AppID (注意這里要區(qū)別于服務號或訂閱號的 AppID)甜滨。
有了小程序帳號之后,我們需要一個工具來開發(fā)小程序熙参。
安裝開發(fā)工具
前往開發(fā)者工具下載頁面 艳吠,根據(jù)自己的操作系統(tǒng)下載對應的安裝包進行安裝,有關開發(fā)者工具更詳細的介紹可以查看《開發(fā)者工具介紹》 孽椰。
打開小程序開發(fā)者工具,用微信掃碼登錄開發(fā)者工具凛篙,準備開發(fā)你的第一個小程序吧黍匾!
第一個小程序
新建項目選擇小程序項目,選擇代碼存放的硬盤路徑呛梆,填入剛剛申請到的小程序的 AppID锐涯,給你的項目起一個好聽的名字,最后填物,勾選 "創(chuàng)建 QuickStart 項目" (注意: 你要選擇一個空的目錄才會有這個選項)纹腌,點擊確定,你就得到了你的第一個小程序了滞磺,點擊頂部菜單編譯就可以在 IDE 預覽你的第一個小程序升薯。
編譯預覽
修改小程序必須要先編譯才能看到修改后的效果。
點擊工具上的編譯按鈕击困,可以在工具的左側(cè)模擬器界面看到這個小程序的表現(xiàn)涎劈,也可以點擊預覽按鈕,通過微信的掃一掃在手機上體驗你的第一個小程序阅茶。
代碼構(gòu)成
在上一章中蛛枚,我們通過開發(fā)者工具快速創(chuàng)建了一個 QuickStart 項目。你可以留意到這個項目里邊生成了不同類型的文件:
.json 后綴的 JSON 配置文件 .wxml 后綴的 WXML 模板文件 .wxss 后綴的 WXSS 樣式文件 .js 后綴的 JS 腳本邏輯文件 接下來我們分別看看這4種文件的作用脸哀。
JSON配置
我們可以看到在項目的根目錄有一個 app.json 和 project.config.json蹦浦,此外在 pages/logs 目錄下還有一個 logs.json,我們依次來說明一下他們的用途撞蜂。
工具配置 project.config.json
通常大家在使用一個工具的時候盲镶,都會針對各自喜好做一些個性化配置,例如界面顏色谅摄、編譯配置等等徒河,當你換了另外一臺電腦重新安裝工具的時候,你還要重新配置送漠。
考慮到這點顽照,小程序開發(fā)者工具在每個項目的根目錄都會生成一個 project.config.json,你在工具上做的任何配置都會寫入到這個文件,當你重新安裝工具或者換電腦工作時代兵,你只要載入同一個項目的代碼包尼酿,開發(fā)者工具就自動會幫你恢復到當時你開發(fā)項目時的個性化配置,其中會包括編輯器的顏色植影、代碼上傳時自動壓縮等等一系列選項裳擎。
小程序配置 app.json
app.json 是對當前小程序的全局配置,包括了小程序的所有頁面路徑思币、界面表現(xiàn)鹿响、網(wǎng)絡超時時間、底部 tab 等谷饿。QuickStart 項目里邊的 app.json 配置內(nèi)容如下:
簡單說一下這個配置各個項的含義:
- pages字段 —— 用于描述當前小程序所有頁面路徑惶我,這是為了讓微信客戶端知道當前你的小程序頁面定義在哪個目錄。
- window字段 —— 小程序所有頁面的頂部背景顏色博投,文字顏色定義在這里的绸贡。
其他配置項細節(jié)可以參考文檔 小程序的配置 app.json 。
頁面配置 page.json
這里的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關的配置毅哗。
如果你整個小程序的風格是藍色調(diào)听怕,那么你可以在 app.json 里邊聲明頂部顏色是藍色即可。實際情況可能不是這樣虑绵,可能你小程序里邊的每個頁面都有不一樣的色調(diào)來區(qū)分不同功能模塊尿瞭,因此我們提供了 page.json,讓開發(fā)者可以獨立定義每個頁面的一些屬性蒸殿,例如剛剛說的頂部顏色筷厘、是否允許下拉刷新等等。 其他配置項細節(jié)可以參考文檔 小程序的配置 page.json
宏所。
WXML 模板
HTML 是用來描述當前這個頁面的結(jié)構(gòu)酥艳,WXML 的作用和HTML一樣,只不過是里面的元素標簽是用小程序自己封裝的標簽名爬骤。
打開 pages/index/index.wxml充石,你會看到以下的內(nèi)容:
雖然WXML 和 HTML 非常相似,有標簽霞玄、屬性等等構(gòu)成骤铃。但是也有很多不一樣的地方,我們來一一闡述一下:
- 標簽名字有點不一樣 往往寫 HTML 的時候坷剧,經(jīng)常會用到的標簽是 div, p, span惰爬,開發(fā)者在寫一個頁面的時候可以根據(jù)這些基礎的標簽組合出不一樣的組件,例如日歷惫企、彈窗等等撕瞧。換個思路陵叽,既然大家都需要這些組件,為什么我們不能把這些常用的組件包裝起來丛版,大大提高我們的開發(fā)效率巩掺。 從上邊的例子可以看到,小程序的 WXML 用的標簽是 view, button, text 等等页畦,這些標簽就是小程序給開發(fā)者包裝好的基本能力胖替,我們還提供了地圖、視頻豫缨、音頻等等組件能力 更多詳細的組件講述參考下個章節(jié)小程序的能力
- 多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表達式 在網(wǎng)頁的一般開發(fā)流程中独令,我們通常會通過 JS 操作 DOM (對應 HTML 的描述產(chǎn)生的樹),以引起界面的一些變化響應用戶的行為好芭。例如记焊,用戶點擊某個按鈕的時候,JS 會記錄一些狀態(tài)到 JS 變量里邊栓撞,同時通過 DOM API 操控 DOM 的屬性或者行為,進而引起界面一些變化碗硬。當項目越來越大的時候瓤湘,你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量,顯然這不是一個很好的開發(fā)模式恩尾,因此就有了 MVVM 的開發(fā)模式(例如 React, Vue)弛说,提倡把渲染和邏輯分離。簡單來說就是不要再讓 JS 直接操控 DOM翰意,JS只需要管理狀態(tài)即可木人,然后再通過一種模板語法來描述狀態(tài)和界面結(jié)構(gòu)的關系即可。 小程序的框架也是用到了這個思路冀偶,如果你需要把一個 Hello World 的字符串顯示在界面上醒第。 WXML 是這么寫 :
<text>{{msg}}</text>
JS 只需要管理狀態(tài)即可:
this.setData({ msg: "Hello World" })
通過 {{ }} 的語法把一個變量綁定到界面上,我們稱為數(shù)據(jù)綁定进鸠。僅僅通過數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關系稠曼,還需要 if/else, for等控制能力,在小程序里邊客年,這些控制能力都用 wx: 開頭的屬性來表達霞幅。 更詳細的文檔可以參考WXML
WXSS 樣式
WXSS 具有 CSS 大部分的特性,小程序在 WXSS 也做了一些擴充和修改量瓜。
- 新增了尺寸單位司恳。在寫 CSS 樣式時,開發(fā)者需要考慮到手機設備的屏幕會有不同的寬度和設備像素比绍傲,采用一些技巧來換算一些像素單位扔傅。WXSS 在底層支持新的尺寸單位 rpx ,開發(fā)者可以免去換算的煩惱,只要交給小程序底層來換算即可铅鲤,由于換算采用的浮點數(shù)運算划提,所以運算結(jié)果會和預期結(jié)果有一點點偏差。
- 提供了全局的樣式和局部樣式邢享。和前邊 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 中調(diào)用小程序提供的豐富的 API当窗,利用這些 API 可以很方便的調(diào)起微信提供的能力,例如獲取用戶信息寸宵、本地存儲崖面、微信支付等。在前邊的 QuickStart 例子中梯影,在 pages/index/index.js 就調(diào)用了 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獲取到當前的經(jīng)度袖瞻、緯度,獲取到之后 利用setData方法對longitude拆吆、latitude進行初始化聋迎。
最后地圖頁面效果:
作者:云卷云舒
鏈接:小程序-簡單入門-教程-小程序社區(qū)-微信小程序-微信小程序開發(fā)社區(qū)-小程序開發(fā)論壇-微信小程序聯(lián)盟
著作權歸作者所有。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權枣耀,非商業(yè)轉(zhuǎn)載請注明出處霉晕。