基本的準(zhǔn)備工作
-知識儲備
--基礎(chǔ):HTML+JS+CSS
--進(jìn)階:React、Vue
-工具安裝
--工具由微信官方提供
---下載地址:https://github.com/zce/weapp-demo
-項(xiàng)目預(yù)覽>校驗(yàn)環(huán)境
--根據(jù)目錄進(jìn)行操作
--在開發(fā)者工具預(yù)覽效果
--頁面基本結(jié)構(gòu),幾乎每個小程序都是這個結(jié)構(gòu)
--nav bar
--body
--tab bar
開發(fā)體驗(yàn)階段
-理解微信小程序的架構(gòu)
--開發(fā)基礎(chǔ)骨架:https://github.com/zce/weapp-boilerplate.git
└─ empty-folder/ ·································· 項(xiàng)目所在目錄
├─ pages/ ······································ 頁面目錄
│ ├─ index/ ··································· index頁面
│ │ ├─ index.js ······························ index頁面邏輯
│ │ ├─ index.wxml ···························· index頁面結(jié)構(gòu)
│ │ └─ index.wxss ···························· index頁面樣式
│ └─ logs/ ···································· logs頁面
│ ├─ logs.js ······························· logs頁面邏輯
│ ├─ logs.wxml ····························· logs頁面結(jié)構(gòu)
│ └─ logs.wxss ····························· logs頁面樣式
├─ utils/ ······································ 公共腳本目錄
│ └─ util.js ·································· 工具腳本
├─ app.js ······································ 應(yīng)用程序邏輯
├─ app.json ···································· 應(yīng)用程序配置
└─ app.wxss ···································· 應(yīng)用程序公共樣式
--app.js>用于定義整個應(yīng)用的邏輯
---app函數(shù)是一個全局函數(shù)
---app函數(shù)作用就是用來創(chuàng)建一個應(yīng)用程序?qū)嵗?br />
---每個應(yīng)用程序都會有他的生命周期
--app.json
---頁面的基本配置信息
--app.wxss
---css代碼,用來設(shè)置整個應(yīng)用的樣式
-項(xiàng)目配置
-頁面結(jié)構(gòu)
--頁面的結(jié)構(gòu)必須由多個文件組成
---js文件:定義頁面的邏輯;app如上,page也是一個全局函數(shù),用來創(chuàng)建頁面對象
---json文件:配置文件,根據(jù)需求創(chuàng)建,無需求便可不創(chuàng)建,因?yàn)轫撁嬗许撁娴呐渲?,?yīng)用程序有應(yīng)用程序的配置??梢圆淮嬖冢菓?yīng)用程序必須配置json文件。
---wxml文件:頁面結(jié)構(gòu)文件,是XML語法,不是HTML語法。
---wxss文件:樣式文件。
--每個文件夾內(nèi)的文件名次統(tǒng)一,只有后綴名不同,因?yàn)閖son配置文件中最終會將所有的頁面整合成一個頁面,
-如何完成邏輯和界面
-界面如何開發(fā)
https://github.com/zce/weapp-demo
$ cd path/to/project/root $ git clone https://github.com/zce/weapp-demo.git project-name --depth 1 $ cd project-name
沒有g(shù)it環(huán)境,可以直接下載
對于Windows用戶直接雙擊下一步的方式安裝即可,此處注意我們使用的版本是官方最新的版本(不需要破解),可以不用AppID,也就是說沒有資格的開發(fā)者也可以測試。
安裝完成過后通過打開我們已經(jīng)完成的應(yīng)用測試環(huán)境是否正常
開發(fā)者工具安裝完成后,打開并使用微信掃碼登錄。
選擇創(chuàng)建“項(xiàng)目”,填入你在公眾平臺的AppID,如果沒有的話可以點(diǎn)擊無AppID。
設(shè)置一個本地項(xiàng)目的名稱(非小程序名稱),比如WeApp Demo,并選擇一個本地文件夾作為存儲目錄。
接下來點(diǎn)擊新建項(xiàng)目就可以在主界面中預(yù)覽到我們的豆瓣電影示例了
希望是一個從零到一的轉(zhuǎn)換過程~
接下來創(chuàng)建一個新的項(xiàng)目,理解小程序項(xiàng)目的基本結(jié)構(gòu)和一些基礎(chǔ)語法。
官方的開發(fā)工具為此準(zhǔn)備了一個QuickStart項(xiàng)目。在創(chuàng)建過程中,如果選擇的文件夾是個空文件夾,開發(fā)者工具會提示:是否需要創(chuàng)建一個quick start項(xiàng)目。選擇是,開發(fā)者工具會自動幫助我們在開發(fā)目錄里生成一個簡單的項(xiàng)目。
借助官方的QuickStart項(xiàng)目完成最基本的Hello world,理解小程序項(xiàng)目的基本結(jié)構(gòu),學(xué)習(xí)基礎(chǔ)操作與語法。
└─ empty-folder/ ·································· 項(xiàng)目所在目錄 ├─ pages/ ······································ 頁面目錄 │ ├─ index/ ··································· index頁面 │ │ ├─ index.js ······························ index頁面邏輯 │ │ ├─ index.wxml ···························· index頁面結(jié)構(gòu) │ │ └─ index.wxss ···························· index頁面樣式 │ └─ logs/ ···································· logs頁面 │ ├─ logs.js ······························· logs頁面邏輯 │ ├─ logs.wxml ····························· logs頁面結(jié)構(gòu) │ └─ logs.wxss ····························· logs頁面樣式 ├─ utils/ ······································ 公共腳本目錄 │ └─ util.js ·································· 工具腳本 ├─ app.js ······································ 應(yīng)用程序邏輯 ├─ app.json ···································· 應(yīng)用程序配置 └─ app.wxss ···································· 應(yīng)用程序公共樣式
每個頁面組件也分為四個文件組成:
頁面邏輯文件,用于創(chuàng)建頁面對象,以及處理頁面生命周期控制和數(shù)據(jù)處理
設(shè)置當(dāng)前頁面工作時的window的配置,此處會覆蓋app.json中的window設(shè)置,也就是說只可以設(shè)置window中設(shè)置的屬性
wxml指的是Wei Xin Markup Language
用于定義頁面中元素結(jié)構(gòu)的,語法遵循XML語法,注意是XML語法,不是HTML語法,不是HTML語法,不是HTML語法
wxml指的是Wei Xin Style Sheet
用于定義頁面樣式的,語法遵循CSS語法,擴(kuò)展了CSS基本用法和長度單位(主要就是rpx響應(yīng)式像素)
相關(guān)鏈接: - 官方文檔 - 生成配置文件
小程序中的配置文件分為兩種:
項(xiàng)目配置聲明文件(指定項(xiàng)目的一些信息,比如導(dǎo)航欄樣式顏色等等)
{
// 當(dāng)前程序是由哪些頁面組成的(第一項(xiàng)默認(rèn)為初始頁面)
// 所有使用到的組件或頁面都必須在此體現(xiàn)
// https://mp.weixin.qq.com/debug/wxadoc/dev/framework/config.html#pages
"pages": [ ... ],
// 應(yīng)用程序窗口設(shè)置
// https://mp.weixin.qq.com/debug/wxadoc/dev/framework/config.html#window
"window": { ... },
// 應(yīng)用導(dǎo)航欄設(shè)置
// https://mp.weixin.qq.com/debug/wxadoc/dev/framework/config.html#tabBar
"tabBar": { ... },
// 網(wǎng)絡(luò)超時設(shè)置
// https://mp.weixin.qq.com/debug/wxadoc/dev/framework/config.html#networkTimeout
"networkTimeout": {},
// 是否在控制臺輸出調(diào)試信息
// https://mp.weixin.qq.com/debug/wxadoc/dev/framework/config.html#debug
"debug": true
}
用于指定特定頁面工作時,window的設(shè)置:
{
// 導(dǎo)航條背景色
"navigationBarBackgroundColor": "#35495e",
// 導(dǎo)航條前景色(只能是white/black)
"navigationBarTextStyle": "white",
// 導(dǎo)航條文本
"navigationBarTitleText": "電影 « 豆瓣",
// 窗口背景顏色
"backgroundColor": "#fff",
// 窗口前景色
"backgroundTextStyle": "dark",
// 是否開啟下拉刷新
"enablePullDownRefresh": true
}
app.js作為項(xiàng)目主入口文件,用于創(chuàng)建應(yīng)用程序?qū)ο?/p>
// App函數(shù)是一個全局函數(shù),用于創(chuàng)建應(yīng)用程序?qū)ο?
App({
// ========== 全局?jǐn)?shù)據(jù)對象(可以整個應(yīng)用程序共享) ==========
globalData: { ... },
// ========== 應(yīng)用程序全局方法 ==========
method1 (p1, p2) { ... },
method2 (p1, p2) { ... },
// ========== 生命周期方法 ==========
// 應(yīng)用程序啟動時觸發(fā)一次
onLaunch () { ... },
// 當(dāng)應(yīng)用程序進(jìn)入前臺顯示狀態(tài)時觸發(fā)
onShow () { ... },
// 當(dāng)應(yīng)用程序進(jìn)入后臺狀態(tài)時觸發(fā)
onHide () { ... }
})
也就是說,當(dāng)應(yīng)用程序啟動時會自動執(zhí)行項(xiàng)目目錄下的app.js文件。
在app.js中通過調(diào)用全局App([option])方法創(chuàng)建一個應(yīng)用程序?qū)嵗?/p>
其中通過參數(shù)指定的一些特定的方法,會在特定的執(zhí)行時機(jī)去執(zhí)行,也就是說通常所說的生命周期事件方法。
|------|------|--------- onLaunch | Function | 生命周期函數(shù)--監(jiān)聽小程序初始化 | 當(dāng)小程序初始化完成時,會觸發(fā) onLaunch(全局只觸發(fā)一次) onShow | Function | 生命周期函數(shù)--監(jiān)聽小程序顯示 | 當(dāng)小程序啟動,或從后臺進(jìn)入前臺顯示,會觸發(fā) onShow onHide | Function | 生命周期函數(shù)--監(jiān)聽小程序隱藏 | 當(dāng)小程序從前臺進(jìn)入后臺,會觸發(fā) onHide
也可以定義任意其他的對象成員(例如:方法和屬性),這些成員可以在內(nèi)部直接使用,或者外部通過獲取app對象調(diào)用:
|------|------ 其他 | Any | 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 Object 參數(shù)中,用 this 可以訪問,一般用于存放業(yè)務(wù)邏輯配置,比如:API地址
app.js
App({
data1: '123',
data2: { message: 'hello world' },
api: {
list: 'https://github.com/zce/',
detail: 'https://github.com/zce/',
},
foo () {
return 'bar'
}
})
other.js
// getApp 也是全局函數(shù),可以在任意地方調(diào)用,用于獲取全局應(yīng)用程序?qū)嵗龑ο? var app = getApp() console.log(app.data1) console.log(app.data2) console.log(app.foo())
[page-name].js是一個頁面的重要組成部分,用于創(chuàng)建頁面對象
// 獲取全局應(yīng)用程序?qū)ο?
const app = getApp()
// Page也是一個全局函數(shù),用來創(chuàng)建頁面對象
Page({
// ========== 頁面數(shù)據(jù)對象(可以暴露到視圖中,完成數(shù)據(jù)綁定) ==========
data: { ... },
// ========== 頁面方法(可以用于抽象一些公共的行為,例如加載數(shù)據(jù),也可以用于定義事件處理函數(shù)) ==========
method1 (p1, p2) { ... },
method2 (p1, p2) { ... },
// ========== 生命周期方法 ==========
// 頁面加載觸發(fā)
onLoad () { ... }
...
})
在應(yīng)用程序執(zhí)行到當(dāng)前頁面時,會執(zhí)行當(dāng)前頁面下對應(yīng)的[page-name].js文件。 在[page-name].js中通過調(diào)用全局Page([option])方法創(chuàng)建一個頁面實(shí)例。
| ---- | ---- data | Object | 頁面的初始數(shù)據(jù) onLoad | Function | 生命周期函數(shù)--監(jiān)聽頁面加載 onReady | Function | 生命周期函數(shù)--監(jiān)聽頁面初次渲染完成 onShow | Function | 生命周期函數(shù)--監(jiān)聽頁面顯示 onHide | Function | 生命周期函數(shù)--監(jiān)聽頁面隱藏 onUnload | Function | 生命周期函數(shù)--監(jiān)聽頁面卸載 onPullDownRefreash | Function | 頁面相關(guān)事件處理函數(shù)--監(jiān)聽用戶下拉動作 其他 | Any | 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 object 參數(shù)中,用 this 可以訪問
WXML(WeiXin Markup Language)是MINA框架設(shè)計的一套標(biāo)簽語言,基于XML。
結(jié)合一些基礎(chǔ)組件、事件系統(tǒng)、模板數(shù)據(jù)綁定,可以構(gòu)建出頁面的結(jié)構(gòu)。
簡單來說:wxml ≈ xml + 事件系統(tǒng) + 模板引擎
例如:
// js
Page({
data: {
todos: [
{ text: 'JavaScript', completed: false },
{ text: 'JavaScript+', completed: false },
{ text: 'JavaScript++', completed: false }
]
},
completed (e) { ... }
})
<!-- wxml -->
<view>
<view wx:for="{{ todos }}">
<block wx:if="{{ !item.completed }}">
<text>{{ item.text }}</text>
<button bindtap="completed" data-item-index="{{ index }}"> √ </button>
</block>
</view>
</view>
WXSS(WeiXin Style Sheets)是MINA框架設(shè)計的一套標(biāo)簽語言,基于XML。
WXSS用來決定了在WXML中定義的組件應(yīng)該怎么顯示。
為了適應(yīng)廣大的前端開發(fā)者,我們的WXSS具有CSS大部分特性。 同時為了更適合開發(fā)微信小程序,我們對CSS進(jìn)行了擴(kuò)充以及修改。
與CSS相比我們擴(kuò)展的特性有:
rpx(responsive pixel): 可以根據(jù)屏幕寬度進(jìn)行自適應(yīng)。規(guī)定屏幕寬為750rpx。如在 iPhone6 上,屏幕寬度為375px,共有750個物理像素,則750rpx = 375px = 750物理像素,1rpx = 0.5px = 1物理像素。
rem(root em): 規(guī)定屏幕寬度為20rem;1rem = (750/20)rpx 。
| ------------------------ | ------------------------ | ------------------------ iPhone5 | 1rpx = 0.42px | 1px = 2.34rpx | 1rem = 37.5rpx iPhone6 | 1rpx = 0.5px | 1px = 2rpx | 1rem = 37.5rpx iPhone6s | 1rpx = 0.552px | 1px = 1.81rpx | 1rem = 37.5rpx
- 建議: 開發(fā)微信小程序時設(shè)計師可以用 iPhone6 作為視覺稿的標(biāo)準(zhǔn)。
- 注意: 在較小的屏幕上不可避免的會有一些毛刺,請在開發(fā)時盡量避免這種情況。
使用@import語句可以導(dǎo)入外聯(lián)樣式表,@import后跟需要導(dǎo)入的外聯(lián)樣式表的相對路徑,用;表示語句結(jié)束。
@import "common.wxss";
text {
background-color: #ff0;
}
目前只支持如下選擇器
| ---- | -------- .class | .intro | 選擇所有擁有 class="intro" 的組件
element | view | 選擇所有 view 組件 element, element | view | checkbox 選擇所有文檔的 view 組件和所有的 checkbox 組件 ::after | view::after | 在 view 組件后邊插入內(nèi)容 ::before | view::before | 在 view 組件前邊插入內(nèi)容
定義在app.wxss中的樣式為全局樣式,作用于每一個頁面。在[page-name].wxss文件中定義的樣式為局部樣式,只作用在對應(yīng)的頁面,并會覆蓋app.wxss中相同的選擇器。
小程序開發(fā)中,我們JS代碼的組織方式就是以CommonJS的規(guī)范來組織