小程序云開(kāi)發(fā)發(fā)布有一段時(shí)間了,最近著手做了一個(gè)基于云開(kāi)發(fā)的小程序項(xiàng)目--仿《微博鮮知》,來(lái)自新浪的這款全新風(fēng)格的小程序雖然界面非常簡(jiǎn)約清新,但是內(nèi)部還是內(nèi)藏了很多玄機(jī),在實(shí)現(xiàn)的路上遇上了不少坎坷,在這里分享給大家。希望給大家提供一些思路。
先展示一下最終結(jié)果: 更多圖片資源在這里
一、 組件化思想
開(kāi)發(fā)一個(gè)完整的小程序時(shí),我們應(yīng)該先分析其內(nèi)部的結(jié)構(gòu)。重復(fù)的結(jié)構(gòu)抽離出來(lái)作為組件,組件非常的靈活,可以嵌入一個(gè)頁(yè)面或多個(gè)頁(yè)面。
在上面的gif圖中我們可以看到首頁(yè)的內(nèi)容是一個(gè)個(gè)的新聞塊。 雖然這個(gè)新聞塊只在首頁(yè)中使用到,但是我還是把它抽離成了一個(gè)組件。這樣做的好處是頁(yè)面結(jié)構(gòu)將會(huì)更加的清晰,并且耦合度降低,比如想換個(gè)主界面風(fēng)格時(shí),你可以直接換另一個(gè)組件添加進(jìn)來(lái)。
還有新聞內(nèi)部頁(yè)面中,有多個(gè)小標(biāo)題,每個(gè)小標(biāo)題里面嵌入了不等數(shù)量的新聞。如果不是采用組件化的話,到時(shí)候inner頁(yè)面的wxml結(jié)構(gòu)就會(huì)亂成一鍋粥。所以這里的建議是盡量組件化分離開(kāi)來(lái)。
對(duì)于組件很陌生可以先看我的之前的這篇文章組件化開(kāi)發(fā)tabbar
下面是項(xiàng)目的頁(yè)面與組件目錄:
二、數(shù)據(jù)庫(kù)設(shè)計(jì)
既然是“全棧”,后端肯定要搞搞。后端的核心就是數(shù)據(jù)。那么我們就先把數(shù)據(jù)庫(kù)分析一下。這里我是這樣分析的,
從頁(yè)面獲得字段,
然后再理解數(shù)據(jù)間的關(guān)聯(lián),如一對(duì)多,一對(duì)一。
這里我構(gòu)建了5個(gè)集合
fresh-mainNews 主頁(yè)新聞集合
subNews字段是一個(gè)數(shù)列,存儲(chǔ)著fresh-subNews Doc的_id,這樣就將這兩個(gè)集合綁定了起來(lái),在后面我們會(huì)講到在云函數(shù)中把這兩個(gè)集合融合起來(lái)返回一個(gè)新的數(shù)據(jù)變得完整一些的集合。
有人可能會(huì)問(wèn),云數(shù)據(jù)庫(kù)不是noSQL嗎,為什么不把所有數(shù)據(jù)全部整合到一個(gè)全部的JSON,那樣就可以只調(diào)用一次JSON。
我的理解是: 我們查詢只是需要查詢我們想要的數(shù)據(jù),不需要的數(shù)據(jù)可以等需要的時(shí)候再根據(jù)關(guān)聯(lián)去請(qǐng)求。 比如這個(gè)項(xiàng)目中的首頁(yè)新聞塊,每一個(gè)新聞塊內(nèi)部都關(guān)聯(lián)著大量的子新聞,第一次加載就全部把這個(gè)小程序需要的所有數(shù)據(jù)都加載出來(lái)就有點(diǎn)瘋狂了。
fresh-subNews 內(nèi)部頁(yè)面新聞小標(biāo)題集合
fresh-comments 評(píng)論集合
fresh-detailNews 詳細(xì)新聞集合
fresh-users 用戶集合
這里查看更多的數(shù)據(jù)庫(kù)信息
三、頁(yè)面構(gòu)建
講到這里就該說(shuō)頁(yè)面的構(gòu)建了。頁(yè)面可以想象成一個(gè)架子,一個(gè)承載數(shù)據(jù)的容器。頁(yè)面通上數(shù)據(jù),就變得活起來(lái)。MVVM,數(shù)據(jù)驅(qū)動(dòng)視圖。交互靠數(shù)據(jù),組件間的通信,組件與頁(yè)面間的通信都是數(shù)據(jù)。{{}} -> 就像是流浪法師大招神奇的傳送門。后面會(huì)將給出一個(gè)精彩的組件通信例子(點(diǎn)擊目錄如何實(shí)現(xiàn)標(biāo)題欄置頂)。
四、關(guān)于云開(kāi)發(fā)。
云開(kāi)發(fā)三大核心:
云函數(shù):通俗的理解就是你寫的函數(shù)在云端運(yùn)行,可以把復(fù)雜的業(yè)務(wù)邏輯放在云函數(shù)里
數(shù)據(jù)庫(kù):一個(gè)既可在小程序前端操作,也能在云函數(shù)中讀寫的 JSON 數(shù)據(jù)庫(kù)
存儲(chǔ):在小程序前端直接上傳/下載云端文件,在云開(kāi)發(fā)控制臺(tái)可視化管理,可以上傳照片下載照片,或者一些其他文件。
在這里詳細(xì)介紹一下操作云函數(shù)提取數(shù)據(jù)庫(kù)的流程, 這里我們以獲取首頁(yè)數(shù)據(jù)為例:
先在云函數(shù)目錄新建一個(gè)函數(shù):mianNewsGet
2. 打開(kāi)該云函數(shù)的index.js 我這里用的是vsCode+node+yarn環(huán)境。 open in terminal(在終端中打開(kāi)),yarn一下,添加依賴。 或者參考云函數(shù)官方文檔
編寫云函數(shù)查詢數(shù)據(jù)
// 云函數(shù)入口文件
const cloud = require('wx-server-sdk')
// 云函數(shù)初始化
cloud.init()
//獲取數(shù)據(jù)庫(kù)句柄
const db = cloud.database()
// 云函數(shù)入口函數(shù)
exports.main = async () => {
const mainNewsList = [];
//向fresh-mainNews集合中獲得全部數(shù)據(jù)、因?yàn)閿?shù)據(jù)庫(kù)里面現(xiàn)在存的數(shù)據(jù)不多,
//如果多的話可以設(shè)置一個(gè)limit以及skip來(lái)獲取特定數(shù)量的數(shù)據(jù)
const mainNews = await db.collection("fresh-mainNews").get();
for(let i = 0; i < mainNews.data.length; i++) {
const mainNew = mainNews.data[i];
let user_id = mainNew.setMan;
//條件查詢 獲取特定id的docments
const user = await db.collection('fresh-users').where({
_id: user_id
}).get();
//限定條件如果有多條,只添加一條進(jìn)去
if (user.data.length > 0) {
mainNew.setMan = user.data[0]
}
//這個(gè)循環(huán)是集合的拼接
for (let i = 0; i < mainNew.subNews.length; i++) {
const subNews = await db.collection("fresh-subNews").where({
_id: mainNew.subNews[i]
}).get();
if (subNews.data.length > 0) {
mainNew.subNews[i] = subNews.data[0]
}
}
//把拼好的docments挨個(gè)放進(jìn)mainNewsList里面也就是形成了一個(gè)全新的
//融合的數(shù)據(jù)更為完整的JSON數(shù)組
mainNewsList.push(mainNew);
}
return mainNewsList;
}
復(fù)制代碼
在首頁(yè)index.js里面onLoad函數(shù)里面調(diào)用云函數(shù)
var that = this;
wx.cloud.callFunction({
// 聲明調(diào)用的函數(shù)名
name: 'mainNewsGet',
// data里面存放的數(shù)據(jù)可以傳遞給云函數(shù)的event 效果:event.a = 1
data: {
a: 1
}
}).then(res => {
//res.result的值是云函數(shù)的return的值
//這里將查詢的結(jié)果放入mainNewsList中,然后就可以在wxml中調(diào)用數(shù)據(jù)
that.setData({
mainNewsList: res.result
})
//打印一下結(jié)果看看有沒(méi)有成功獲取數(shù)據(jù)
console.log(this.data.mainNewsList)
}).catch(err => {
console.log(err)
})
獲取的數(shù)據(jù):
我們可以看到原本的subNews里面本來(lái)存放的是_id的數(shù)值,融合后變成_id對(duì)應(yīng)的整個(gè)doc
變化: [_id1.value,_id2.value~~] ---> [{_id1:value,key1:value1,key2:value2},~~~]
云函數(shù)的調(diào)用,數(shù)據(jù)庫(kù)的查詢。就是這么簡(jiǎn)單的四步,云開(kāi)發(fā)的門檻很低,功能也很強(qiáng)大,只要你去嘗試,很輕松的就能夠?qū)崿F(xiàn)。
五、關(guān)于時(shí)間格式化。
寫在utils文件夾里添加xx.js
const formatTime = date => {
var dateNow = new Date();
var date = new Date(date);
const hour = date.getHours()
const minute = date.getMinutes()
var times = (dateNow - date) / 1000;
let tip = '';
if (times <= 0) {
tip = '剛剛'
return tip;
} else if (Math.floor(times / 60) <= 0) {
tip = '剛剛'
return tip;
} else if (times < 3600) {
tip = Math.floor(times / 60) + '分鐘前'
return tip;
}
else if (times >= 3600 && (times <= 86400)) {
tip = Math.floor(times / 3600) + '小時(shí)前'
return tip;
} else if (times / 86400 <= 1) {
tip = Math.ceil(times / 86400) + '昨天'
}
else if (times / 86400 <= 31 && times / 86400 > 1) {
tip = Math.ceil(times / 86400) + '天前'
}
else if (times / 86400 >= 31) {
tip = '好幾光年前~~'
}
else tip = null;
return tip + [hour, minute].map(formatNumber).join(':')
}
const formatNumber = n => {
n = n.toString()
return n[1] ? n : '0' + n
}
//將這個(gè)接口暴露
module.exports = {
formatTime: formatTime,
}
復(fù)制代碼
在需要的頁(yè)面的xx.js里面引入
import { formatTime } from '../../utils/api.js';
格式化獲取的時(shí)間數(shù)據(jù)
let mainNewsList = that.data.mainNewsList
for(let i =0; i < mainNewsList.length;i++) {
let time = formatTime(mainNewsList[i].time)
//這是setData()的數(shù)組用法,會(huì)經(jīng)常用到
var str = 'mainNewsList['+i+'].time'
that.setData({
[str]:time
})
}
復(fù)制代碼
六、 關(guān)于一些很有用但是你可能不知道的小程序技巧
全屏顯示圖片,能夠?qū)崿F(xiàn)多張圖片左右滑動(dòng)并且還有數(shù)字索引現(xiàn)在在屏幕上,并且長(zhǎng)按還能收藏以及下載(之前不知道這個(gè)API還特地做了一個(gè)組件來(lái)實(shí)現(xiàn)類似功能,簡(jiǎn)直吐血)
wx.previewImage({
current: imgUrl, // 當(dāng)前顯示圖片的http鏈接
urls: imagePack // 需要預(yù)覽的圖片http鏈接列表
})
復(fù)制代碼
非常方便的一個(gè)API能夠滑動(dòng)到某個(gè)位置
wx.pageScrollTo({
scrollTop: 一個(gè)數(shù)值(自帶px單位), //滾動(dòng)到數(shù)值所在的位置
duration: 50 //執(zhí)行滾動(dòng)所花的時(shí)間
})
復(fù)制代碼
查詢節(jié)點(diǎn)query.selectAll('類名')及query.select('#id')官方文檔
var that = this
let catalogIndex = that.data.catalogIndex;
query.selectAll('類名').boundingClientRect(function (rects) {
rects.forEach(function (rect) {
rect.top // 節(jié)點(diǎn)的上邊界坐標(biāo)st,
//還有一些別的屬性,這個(gè)查詢節(jié)點(diǎn)是后面講到的目錄跳轉(zhuǎn)關(guān)鍵API
})
})
}).exec()
},
復(fù)制代碼
setData()一些技巧。
//給數(shù)組設(shè)置值 還可以有var xx = 'xx['+idx+'].key'的形式
var doneList = 'doneList['+idx+']'
that.setData({
[doneList]: true,
})
復(fù)制代碼
有時(shí)候我們還可以先改變某個(gè)數(shù)的值再去setData()它,這是setData()的一個(gè)很好用的技巧,不過(guò)需要去運(yùn)用一下才好理解 如:
dataPack.likeNum = (supLikeNum===-1 ? dataPack.likeNum: supLikeNum);
this.setData({
comment: dataPack,
})
復(fù)制代碼
七、 項(xiàng)目最精彩的兩個(gè)部分
1.點(diǎn)擊目錄欄頁(yè)面將相應(yīng)新聞欄置頂,先看下效果
這個(gè)效果在別的小程序里面都沒(méi)有見(jiàn)過(guò),應(yīng)該是微博鮮知獨(dú)創(chuàng)的,在這里先對(duì)原作者表達(dá)一下敬意。內(nèi)部的構(gòu)造也是非常巧妙,不同于我們常見(jiàn)的外賣的錨點(diǎn)定位。
我們先來(lái)分析一波:
mvvm,視圖是由數(shù)據(jù)驅(qū)動(dòng)的,我們要透過(guò)現(xiàn)象看本質(zhì),去思考底層的數(shù)據(jù),這樣我們很快就會(huì)有思路:
點(diǎn)擊目錄欄的item項(xiàng)如果綁定了一個(gè)data-idx等于循環(huán)的索引,可以在e.currentTarget.dataset.idx拿到這個(gè)item的索引。
我們把這個(gè)數(shù)據(jù)通過(guò)組件通信傳遞到inner頁(yè)面,然后在由inner頁(yè)面把數(shù)據(jù)轉(zhuǎn)交給subNews
并且在inner頁(yè)面的js中綁定subNews的goTop事件,這樣產(chǎn)生了一個(gè)catalog組件->inner頁(yè)面->subNews的關(guān)聯(lián),數(shù)據(jù)為item的索引。觸發(fā)catalog就能夠控制subNews組件的移動(dòng),是不是還有點(diǎn)繞, ok
show the code:
1.catalog/index.wxml
<block wx:for="{{subNews}}" wx:for-item="subNewsItem" wx:for-index="idx" wx:key="index">
<view class="subTitle-item" bind:tap="scrollFind"
//關(guān)鍵1:綁定item索引
data-hi="{{idx}}">
<text>{{subNewsItem.title}}</text>
</view>
</block>
復(fù)制代碼
獲得索引,并綁定inner頁(yè)面 catalog/index.js
scrollFind: function(e) {
//點(diǎn)擊后 實(shí)現(xiàn)inner頁(yè)面特定新聞小標(biāo)題置頂
let curIndex = e.currentTarget.dataset.hi
// 關(guān)鍵2: 與inner頁(yè)面取得聯(lián)系
var myEventDetail = {index: curIndex} // detail對(duì)象,提供給事件監(jiān)聽(tīng)函數(shù)
var myEventOption = {} // 觸發(fā)事件的選項(xiàng)
this.triggerEvent('catalog', myEventDetail)
}
復(fù)制代碼
inner/inner.js 取得與catalog的通信
onCatalog: function(e) {
e.detail // 自定義組件觸發(fā)事件時(shí)提供的detail對(duì)象
console.log(e.detail.index)
//關(guān)鍵:3 把索引存儲(chǔ)到data
this.setData({
catalogIndex : e.detail.index
})
//關(guān)鍵4: 頁(yè)面可以通過(guò)組件的id取得其頁(yè)面引用組件的方法
// this.subNews=this.selectComponent("#subNews")
this.subNews.goTop();
},
復(fù)制代碼
給subNews傳catalogIndex,并且標(biāo)上id
<subNews ~省略~ catalogIndex="{{catalogIndex}}" id="subNews"></subNews>
復(fù)制代碼
在subNews中先定義一個(gè)圖片加載事件,這樣在頁(yè)面加載完成時(shí)會(huì)觸發(fā)其綁定的事件,這是來(lái)自瀑布流的靈感。可以在圖片加載出來(lái)的時(shí)候觸發(fā)onImageLoad函數(shù),而在這個(gè)函數(shù)里我們可以干一些準(zhǔn)備的事情。
//subNews/index.wxml
//一個(gè)看不見(jiàn)的圖片,來(lái)自瀑布流的靈感,能夠產(chǎn)生主動(dòng)觸發(fā)的事件
<view style="display:none">
<image src="{{mainImg}}" bindload="onImageLoad"></image>
</view>
復(fù)制代碼
//subNews/index.js
onImageLoad: function () {
var that = this
let offsetList = that.data.offsetList;
const query = wx.createSelectorQuery().in(this)
//之前講到過(guò)的API獲取節(jié)點(diǎn)信息,我們把它存儲(chǔ)到offsetList偏移量數(shù)組,他存儲(chǔ)著每一個(gè)節(jié)點(diǎn)在屏幕的位置,
//配合wx.pageScrollTo可以達(dá)到新聞欄置頂?shù)男Ч?
query.selectAll('.subNews-wrapper').boundingClientRect(function (rects) {
rects.forEach(function (rect) {
rect.top // 節(jié)點(diǎn)的上邊界坐標(biāo)
offsetList.push(rect.top)
that.setData({
offsetList,
})
})
}).exec()
},
復(fù)制代碼
給標(biāo)題欄綁定上goTop事件
goTop: function (e) {
var that = this
let catalogIndex = that.data.catalogIndex;
//這里offsetList是一個(gè)data里面的數(shù)據(jù),來(lái)保存所有的節(jié)點(diǎn)的上邊距坐標(biāo)
let offsetList = that.data.offsetList;
wx.pageScrollTo({
scrollTop: offsetList[catalogIndex], //滾動(dòng)到具體數(shù)值所在的位置
duration: 50 //執(zhí)行滾動(dòng)所花的時(shí)間
})
}
復(fù)制代碼
至此,你就實(shí)現(xiàn)了這個(gè)看似簡(jiǎn)單卻非常巧妙的功能,組件->頁(yè)面->組件,秀得眼花繚亂。如果還是有些不理解的話,等下可以下載我的代碼去看。
至于為什么要弄一個(gè)圖片的加載然后觸發(fā)那個(gè)事件呢,這是因?yàn)槿绻惆勋@取offsetList偏移量數(shù)組的函數(shù)放在goTop里的話,進(jìn)入頁(yè)面第一次的點(diǎn)擊會(huì)無(wú)效,這樣產(chǎn)生的體驗(yàn)肯定是非常不舒服的。
2. 點(diǎn)贊優(yōu)化
先展示一下效果:
先說(shuō)一下優(yōu)化的是什么:點(diǎn)贊效果的延遲極大降低
因?yàn)辄c(diǎn)贊的變化是由用戶產(chǎn)生的一個(gè)交互,傳統(tǒng)的觀點(diǎn)就是用戶點(diǎn)贊->后端更新數(shù)據(jù)->前端拉取數(shù)據(jù)->數(shù)據(jù)驅(qū)動(dòng)視圖的變化。
真實(shí)的體驗(yàn)就是,非常的慢,慢到點(diǎn)擊后2秒才能看到點(diǎn)贊的效果,這種差勁的交互簡(jiǎn)直就是一場(chǎng)災(zāi)難。
先給傳統(tǒng)的、局部刷新優(yōu)化的,效果還是很差的一段代碼:
for(let i = 0; i< that.data.comments.length; i++)
{
//當(dāng)點(diǎn)擊該個(gè)評(píng)論時(shí),只更新這一條數(shù)據(jù)
if (i == idx) {
var str = 'comments['+idx+'].likeNum'
that.setData({
[str]:res.result.data.likeNum,
})
console.log(likeNumList[idx])
}
}
data: {
doneList: [], //是否按下
likeNumList: [], //模擬點(diǎn)贊數(shù)數(shù)組
likeAdd: 10, //點(diǎn)贊每次增加數(shù),根據(jù)你的設(shè)置來(lái),你后端每次加1這里就寫1
},
var doneList = 'doneList['+idx+']'
likeNumList[idx] = (that.data.comments[idx].likeNum + that.data.likeAdd);
that.setData({
likeNumList,
[doneList]: true,
likeAdd: that.data.likeAdd+10
})
復(fù)制
<text class="dianzanNum">{{likeNumList[idx]?likeNumList[idx]:item.likeNum}}</text>
復(fù)制代碼
優(yōu)化思路是怎么樣的呢?
用一個(gè)數(shù)組來(lái)存放/模擬更新的數(shù)據(jù),如果數(shù)字的索引位置被賦值,則頁(yè)面直接顯示這個(gè)更新的數(shù)字,也是異曲同工之妙。因?yàn)橛脩絷P(guān)心的是數(shù)據(jù)的變化,我們可以先把數(shù)據(jù)的變化產(chǎn)生,至于數(shù)據(jù)后端的變化讓他異步慢慢的去做。
從這里發(fā)散思想,是不是評(píng)論功能也能夠用這樣的思路同樣去達(dá)到極致的速度與交互體驗(yàn)?zāi)亍?/p>
點(diǎn)贊的延遲幾乎為無(wú),體驗(yàn)到點(diǎn)贊的極致快感,讓人幾乎停不下來(lái)~~(暗示一波)
篇幅所限,文章到這里就差不多了。
項(xiàng)目地址: github-HappyBirdwe-weiboFresh 奉上
精心寫的項(xiàng)目,細(xì)節(jié)很不錯(cuò)喲,歡迎大家☆☆☆☆star☆☆☆☆
結(jié)語(yǔ):
學(xué)習(xí)的道路上免不了坎坷,希望文章的分享能夠?yàn)榇蠹姨峁┮恍┧悸?,學(xué)習(xí)的過(guò)程減少一點(diǎn)彎路,這就是這篇文章最大的價(jià)值,歡迎大家提問(wèn)及指正。