構建小程式總結
1.創建小程式
- 創建小程式:沒註冊過的郵箱
- appid:微信公眾平台登陸小程式,開發欄可查看
2.小程式項目結構
APP(宏觀主體):
app.js(創建app實例以及一些全局相關內容)
app.json(全局配置:window,tabbar等)
app.wxss (全局的一些配置)
Page(頁面):
page.js(創建page實例的程式碼,以及相關內容)
page.json:(業務單獨的配置,比如頁面對應的window配置,usingComponents)
page.wxml:頁面的wxml布局程式碼
page.wxss:頁面的樣式配置
Component:
component.js : 創建component實例的程式碼以及組件內部的內容
component.json : 組件內部的配置,比如當前組件使用了別的組件
component.wxml : 布局程式碼
component.wxss : 樣式程式碼
3.小程式三體驗
1.數據綁定:
在頁面或者組件的中的js文件中的data定義 ,在wxml中使用{{}} 使用
2.列表渲染:
<view wx:for='{{student}}'>{{item.name}}+{{item.age}}</view>: student為js中的數組數據 ,item為微信自動生成的變數,為遍歷出的每一項數據
3.事件監聽:
bindTap:監聽點擊事件
注意: 在js中修改數據的時候,不能直接修改,必須使用this.setData({})
4.**小程式配置文件:project,sitemap
1.project : 小程式功能版本,一般不手動修改,而是在詳情中修改
2.sitemap : 配置小程式搜索
3.app.json全局配置:
1.所有使用的頁面都必須在pages下註冊
2.window默認窗口配置:navigationBarBackgroundColor(導航顏色)navigationBarTextStyle(導航文字顏色) navigationBarTitleText(導航標題) enablePullDownRefresh(開啟全局下拉刷新)
3.底部tabbar:(配置圖片可以將iconfont導出為圖片進行使用)
=>list數組中每個對象都是一個tabbar,對象中可以配置item選中和未被選中的圖標,和文字,圖片就新建文件夾放在項目中,用絕對路勁使用
=>和list同級,還可以設置選中tabbar的字體顏色,具體查文檔
4.page頁面配置:
1.調用公共組件
2.配置和全局不一樣的屬性(如:導航樣式等等,具體查看文檔)
5.小程式的雙執行緒模型
誰是小程式的宿主環境呢?=>微信客戶端
宿主環境為了執行小程式的各種文件:wxml wxss js 提供了小程式的雙執行緒模型
wxml和wxss運行於渲染層 ,js運行為邏輯層 ,這兩個執行緒都會經由微信客戶端(native)進行中轉交互
6.小程式的啟動流程
1.微信下載小程式包 -> 啟動小程式 -> 載入解析app.json -> 註冊App() (也會執行App生命周期) -> 載入自定義組件程式碼(註冊自定義組件)
-> (1.解析page.json 2.渲染層載入渲染page.wxml 3.邏輯層註冊page()) ->執行Page生命周
2.註冊App做什麼
App生命周期
=> onlaunch:小程式初始化完成執行
=>onShow(options):小程式頁面顯示之後執行
1.可監聽小程式的進入場景 可以通過options查看
2. 獲取用戶資訊 wx.getUserInfo(這個介面即將廢棄) 現行方案:使用按鈕,讓用戶自己來確認,按鈕設置 屬性:<button open-type=『getUserInfo』 bindgetUserInfo=」method「>獲取資訊</button> 然後列印 傳入默認參數的詳情資訊中就有 method(event){ console.log( event.details )}
3.拓展:(可以不再生命周期中使用) 展示用戶資訊:<open-data></open-data> (可以在文檔中的組件中查看使用 ->組件->開放能力)使用:<open-data type="user..."></open-data>具體查看文檔
=>onHide:介面被隱藏時執行
=>onError:當程式出現錯誤的時候執行
3.註冊Page做什麼:
=>1.在js的onload生命周期中發送數據請求 (設置this.setData的時候注意this的指向,微信提供的請求api 一般用箭頭函數來解決this指向問題)
=>2.在data中初始化一些數據
=>3.監聽上拉,觸底事件
7.常用的內置組件
text組件:
行內標籤 其中的文本默認不能被選中
1.可以設置能被選中 <text selectable=『{{true}}』> helloWorld </text> ->如果不用mastache語法,傳入的是字元串,而不是布爾值,
2.還能設置space屬性,設置空格大小 3.解碼屬性 decode :可用於大於號小於號等其他符號的解碼
button組件:
1.默認塊級元素,如果設置了size='mini',就會變為行內塊元素
2.可以設置type來設置顏色
3.plain屬性 邊框
4.loading屬性,載入小圓圈
5.設置點擊樣式,添加屬性hover-class=」ppd「 然後再wxss中設置樣式 .ppd{ color:red;....}
view組件:
容器組件,常用屬性
1.hover-class 當用戶按下後的屬性 (當用戶鬆手,會恢復原有的屬性)
2.hover-style-time 樣式停留時間
3.hover-stop-propagation 阻止冒泡
image組件:
1.lazy-load屬性:圖片懶載入
2.bindload:監聽圖片載入完成事件
3.還有長按識別小程式二維碼的功能
4.也有能設置圖片在image盒子中的縮放拉伸模式
input組件:
1.value屬性:input中的默認值
2.type屬性:text ....
3.confirm-type屬性:設置彈出鍵盤右下角的文字 還有一些input的事件具體查看文檔
----------------------------------------------------------------------------
scroll-view組件:
實現局部滾動(水平滾動和垂直滾動)
=>水平滾動:
(scroll-view作為父盒子設置寬高和(white-space: nowrap不換行) ,子盒子inline-block (行內元素))
<scroll-view class=」container「 scroll-x>
<view v-for="{{10}}"> 子盒子 </view>
</scroll-view>
=>垂直滾動:
<scroll-view class=」container「 scroll-y>
<view> 子盒子 </view>
</scroll-view>
=>scroll-view的事件:
bindscroll事件,可監聽滾動的高度 ,還有類似事件和使用查看具體文檔
-------------------------------------------------------------------------------
所有組件的共同屬性: id class style hidden(布爾值) data- (自定義屬性) bind/catch 組件的事件
8.Mustache ,wxss,wxml,wxs
Mustache :
1.可以寫入多個變數 {{ a + b }}
2.可以寫表達式 {{ age>=10 ? '成年人': '未成年人' }} (題外話:獲取當前時間 new Date().toLocaleString)
3.如何點擊按鈕,切換某個元素的樣式(小程式不允許使用DOM操作):
定義一個布爾值bool,在按鈕的點擊事件中每次點擊都取反, 在需要變換的元素上使用Mustache語法 class=」box {{bool?『active』:『』}} 「
wxss:
1.支援的選擇器: .class #id element ::after ::before
2.擴展單位: rpx 規定螢幕寬度為750rpx (ipone螢幕寬度為375px ,相當於 1rpx = 2px)
3.樣式導入,有時候可能會將樣式分在多個wxss文件中 ,在頁面或者組件中新建文件夾存放多個css,然後再主css中 @import 『./xxx/xxx.css』
4.導入官方樣式庫:WeUI ,具體將WeUI在github上download下來,用微信開發工具跑起來,用什麼就引用什麼(注意一些組件除了css還綁定了很多js)
wxml:
wx:if wx:elif wx:else hidden wx:for wx:for-item wx:for-index
1.=>使用變數控制某個元素的顯示和隱藏 <view wx:if="{{isShow}}"></view>
2.=><view wx:if={{score >= 90}}>優秀</view> <view wx:elif={{score >= 90}}>優秀</view>
3.=>hidden為true的隱藏 ,為false的時候顯示 ,使用hidden的時候組件依然存在,只是沒有顯示,而使用wx:if組件跟本就沒有被創建出來,當需要頻繁切換的時候,推薦使用hidden
4.=>wx:for 一般用於列表數據:<view wx:for="{{list}}"> {{item}} <view> :item默認為列表數據中的每一項
5.=>block標籤作用(不是組件):在使用wx:if,wx:for等指令的時候常常是一組標籤配合使用,此時我們可以用block來包裹,也可以用view,但是使用view會創建額外的屬性
6.=>wx:for-item , wx:for-index一般用於多層遍歷,需要使用多個item和index,此時就要重命名來使用
<block wx:for="{{nums}}" wx:for-item='n'> {{n}} </block>
7.=>列表渲染key:使用wx:for時會報警告,這個提示告訴我們,可以添加一個key提高性能
為什麼?大概闡述就是:沒有key時,一旦涉及改變,被改變的元素以及後面的元素全部會被重新改變渲染,有key時,會識別復用的元素,元素會插入,而不是直接替換後面所有
wxs:
1.在wxml中是不能直接調用page中定義的函數的 {{ myfun( xxx) }}:錯誤 ,但是在某些情況我們需要過濾某些數據的時候,就需要使用wxs
2.定義一些公共方法,供其他地方調用,比如轉換時間戳
3.使用:(詳細步驟可看文檔)根目錄下創建wxs文件夾,創建wxs文件,書寫函數,導出,在需要使用的頁面或者組件中按需導入對應的方法即可
9.事件-對象-傳遞參數-冒泡和捕獲
事件:
1.某些組件會有自己特性的事件類型,大家可以在使用組件時具體查看對應的文檔
比如input有bindinput / bindblur / bindfocus 等 scroll-view有bindscrolltowpper / bindscrolltolower 等 更多的事件查看文檔
事件對象:
當某個事件觸發時,會產生一個事件對象,並且這個對象被傳入到回調函數中,事件對象有哪些常見的屬性呢?
type 事件類型
timeStamp 頁面打開事件觸發經過的事件
target 觸發事件的組件的一些屬性值集合 :記錄產生事件的元素
currentTarget 當前組件的一些屬性值集合 :記錄觸發事件的元素
detail 額外的資訊(點擊的位置等)
touches 觸摸事件,當前停留在螢幕中的觸摸點資訊的數組 :記錄多個手指觸摸
changeedTouches 觸摸事件,當前變化的觸摸點資訊的數組 :本來有一個手指,再增加一個手指,觸發一次
事件的傳遞參數:
有三個含有文本內容的view,我們需要點擊獲取view中的文本,如何獲取?
首先,小程式中,不能再點擊事件中直接傳入 ,而是要使用data-xxx=『xxx』 例:data-index=『{{index}}』 在js中取值:event.currentTarget.dataset;
事件冒泡和事件捕獲:
1.監聽事件冒泡和捕獲:capture-bind:tap ( 必須使用: ) bind:tap
2.使用bind:一層層傳遞 catch:阻止事件的傳遞
10.組件化開發
一.組件化開發:
1.新建components目錄,創建components組件
=>當創建組件的時候,.json中會默認加上屬性"component": true (此屬性代表這是自定義組件,不要隨意刪除)
2.使用自定義組件
=> 先在需要使用的頁面或者組件的.json文件下的usingComponents下定義需要使用的組件才可以正常使用 { '使用時的組件名': 』調用的組件路徑『 }
二.使用自定義組件和細節:
1.自定義組件的標籤名只能包含 小寫字母,中劃線 ,下劃線 (一般使用中劃線, 因為一些官方組件使用的也是中劃線:scroll-view)
2.自定義組件中也能使用其他自定義組件,步驟和在頁面中一樣
3.在app.json添加usingComponents屬性,可以做到全局註冊,其他頁面和組件直接使用
三.組件的樣式細節:
1.在使用class來修改樣式的時候,默認會有一個隔離,使頁面和組件的樣式相互不衝突,所以為了樣式不錯亂,一般不使用id、屬性、標籤選擇器
2.如何讓組件和頁面樣式能夠被單向或者相互影響,在組件的js文件中,options屬性下設置styleIssolation:』xxx『 (具體查看文檔)
11.給組件傳遞數據和樣式
1.很多時候,組件內的展示內容,並不是在組件內寫死的,而是由使用者來決定
=> 頁面可以向組件傳遞 : 數據(properties) 樣式(externalClasses) 標籤(slot)
=> 組件向頁面傳遞他發生的行為 : 自定義事件
2.傳遞數據的具體步驟:
=>1.在自定義組件中的properties中定義一個屬性 title:String ,此屬性可以直接在組件中用{{}}調用使用 , 然後再父組件中傳入title屬性值 <cpn title="哈哈哈" />
=>2.上面那種定義方式是最簡單切無默認值的,可以設置對象值 title:{ type:String ,value:『默認值』 ,observer:function(){...} } observer可以監聽title的每次改變
3.傳遞樣式的具體步驟:
=>1.給組件的標籤添加一個樣式titleclass
=>2.這個樣式並不是自定義組件寫的,而是由父組件傳入 ,在自定義組件中定義一個內置屬性來接收傳入的樣式:externalClasses:['titleclass'] (externalClasses與properties同級)
=>3.在父組件調用時,傳入我們需要訂製的樣式 <cpn titleclass="red" /> <cpn titleclass="ool" />
=>4.傳入的red/ool代表父組件中的類名 .red{color:red; } .ool {font-size:18px}
=>這樣,自定義組件就成功使用了父組件中傳入的樣式
4.組件向外傳遞事件-自定義事件
=>由子組件發出,父組件接收,子組件傳遞的數據,默認在event當中可列印出 (具體使用時查看文檔,和vue很像)
12.獲取組件對象的方式
1.在組件外部修改組件數據,核心就是調用組件內部的this.setData({ }) => 組件對象.setData({})
2.獲取組件對象 : this.selectComponent('class/id') (文檔搜索selectComponent)
13.插槽slot
1.組件的插槽是為了讓我們封裝的組件更加具有擴展性,讓使用者決定組件內部的一些內容到底展示什麼
2.插槽的使用:
=>單個插槽,直接在自定義組件中使用<slot></slot>
=>多個插槽:
=>在自定義組件中給每一個插槽都添加一個name屬性 <slot name=「slot1」></slot>
=>必須在component對象中添加一個選項:options options:{ multipleSlots:true }
=>使用的時候 <view slot="slot1"></view>
14.總結Component構造器
總結Component構造器:
1.properties:讓使用者傳入數據
2.data:定義組件內部的初始化數據
3.methods:用於定義組件內部的函數 (page頁面中,函數方法可直接寫在data下面,組件里不行,必須寫在methods下)
4.options:組件的配置選項
5.externalClasses:外界給組件傳入額外的樣式
6.observers:可以監聽properties/data的改變
7.pageLifetimes:頁面生命周期 (查看文檔)
8.lefetimes:組件生命周期 (查看文檔)
15.小程式的網路請求
wx.request({
url: '//123.207.32.32:8000/api/xxx',
method:'post' //不設置默認get
data:{
type:'sell',
page:1
},
success:function(res){
console.log(res);
},
fail:function(err){
console.log('獲取失敗')
}
})
除了url,method,data,success等屬性,還有很多其他屬性,具體查看文檔
網路請求的封裝:
新建js文件,使用promise封裝小程式網路請求api,導出方法,在需要的地方直接調用
export default function request(options) {
return new Promise((resolve, reject) => {
wx.request({
url: options.url,
method: options.method || 'get',
data: options.data || {},
success: resolve,
fail: reject
})
})
}
使用:
import request from '../../services/network.js'
request({
url:'//123.207.32.32:8000/api/m3/recommend'
}).then(res=>{
console.log(res)
})
16.彈窗,分享,以及登陸流程
1.彈窗
官方文檔 => API => 介面 => 交互
wx.showToast:顯示提示框 (可設置時間,文本,icon,蒙版)
wx.showModal:顯示模態框 (可以設置標題,內容,以及點擊確定和取消的回調函數,也可以設置只有確定按鈕,和更改按鈕文本)
wx.showLoading:顯示載入框 (需主動調用 wx.hideLoading 才能關閉提示框,一般切換頁面,載入數據,請求數據的時候使用)
wx.showActionSheet:顯示操作菜單 (設置彈出菜單,和菜單項,也有回調函數)
17.小程式中的分享
小程式文檔 => 框架介面 => 頁面 => page => onShareAppMessage
調用小程式api:相當於頁面生命周期:
onShareAppMessage:function(options){
return:
}
分享按鈕:
<button open-type="share"> 分享</button>
18.小程式的登陸流程
官方流程:
1.調用wx.login獲取code
2.調用wx.request發送code到我們自己的伺服器(我們自己的伺服器會返回一個登陸態的標識,比如token)
=>這個code客戶端不需要用,是需要發送給服務端的,wx.request()發送code
=>服務端拿到 code + appid + appsecret (後兩個可在小程式控制台拿到),將這三個通過介面發送給微信官方 伺服器,微信伺服器就會返回session_key + appid
=>服務端自定義登陸態 與 oppenid ,session_key關聯 (項目可能除了微信登陸還需要帳號密碼)
=>伺服器返回自定義登陸態 (token)
3.將登陸態的標識token進行存儲(可保存在storage),以便下次使用
4.請求需要登陸態標識的介面時,攜帶token
=>請求一些需要登陸的介面時,就需要攜帶token
登陸偽程式碼演示:
//1.先從快取中取出token,如果沒有,就需要重新登陸
const token = wx.getStorageSync(token)
//2.判斷token是否有值
if(token && token.length !==0){
//此時已經有token,驗證token是否過期
wx.request({
url: 'xxxx',
header:{
token
},
success:res =>{
if(!res.data.errCode){
this.globalData.token = token
}else{
//重新進行登陸操作,可封裝成一個方法,到時候直接調用方法
}
},
fail:err=>{
}
})
}else{
//登陸操作
wx.login({
//code只有五分鐘的有效期
success: (res) => {
//1.獲取code
const code = res.code;
//2.將code發送給我們的伺服器
wx.request({
url: '//123.207.32.32:8000/api/m3/login',
method: 'post',
data: {
code
},
success: (res) => {
//1.取出token
const token = res.data.token
//2.將token保存到全局globalData中 :當別的頁面或組件需要獲取的時候=> const app=getApp() => app.globalData.token
this.globalData.token = token
//3.放到對象中,關閉小程式再開又要重新登陸,所以我們要記錄到本地存儲當中
wx.setStorageSync('token', token)
}
})
}
})
}
19.頁面跳轉,跳轉時數據傳遞
頁面跳轉有兩種方法:
1.通過navigator組件
2.通過wx的API跳轉
=>1.通過navigator組件:
還有很多常用的屬性,具體可以查看文檔
<navigator url="xxxx/xxx">跳轉到詳情頁</navigator>
=>跳轉過程中數據的傳遞
<navigator url="xxxx/xxx ?name=why&age=18'>跳轉到詳情頁</navigator>
=>如何在跳轉的頁面中拿到傳過來的數據?
在頁面生命周期函數onload中的默認參數options中可獲取到
onLoad:function(options){
console.log(options)
}
=>如何在跳轉頁面的時候修改數據
可以通過getCurrentPages來獲取所有的頁面,然後使用頁面對象的setData({})函數來修改
=>2.通過程式碼跳轉頁面跳轉
xxx(){
wx.navigaTo({ url:'xxxx?...'})
...還有很多種方式的跳轉,具體查看文檔
}