做前端的多少都逛過淘寶,但大多數人買完就下線,很少有人去琢磨它的界面設計。普通人這樣沒問題,對程序員來說就可惜了——那些細節裡藏著不少值得借鑒的東西。所以這次就照著淘寶的分頁樣式做一個自己的組件,順便練練手。
先看一眼淘寶的分頁:

大致可以分成兩塊:核心部分負責翻頁這個基本功能,不可或缺;拓展部分則是為了增強用戶體驗而加的,很多現成分頁控件並沒有實現——這也算是自己動手造一次輪子的理由之一。
結合實際業務需求,我認為要把它改成一個具有普適性的業務控件,還需要三處調整:
1、拓展部分做得偏小了些,個人體驗上不太舒服;
2、淘寶商品多,只需顯示到第一百頁;實際項目裡未必有那麼多頁,顯示到真正的末頁更合理;
3、拓展部分並非必需,有些頁面給分頁預留的位置不夠,這時應該能通過配置關掉。
普通分頁控件離不開三個基礎參數:pageNo(當前頁)、pageSize(每頁條數)、count(總數)。pageNo 用來標識當前頁,pageSize 和 count 則用來推算總頁數 pageCount:
var pageCount = 0;
if (count % pageSize == 0) {
pageCount = count / pageSize;
} else {
pageCount = count / pageSize + 1;
}
這樣就能保證 pageCount 是要渲染的最終頁數。除此之外,我認為還需要幾個可配置項:
1、確定按鈕文案可改。業務裡這個按鈕未必叫「確定」,可能叫「修改」之類,留個口子方便擴展(默認值:"確定")。
2、主色調可改。淘寶用橙黃,經典 Bootstrap 配色偏淺藍,這個也該支持切換(默認值:lightblue)。
3、showNum 可配。指 pageNo=1 時要顯示的頁數,例如淘寶顯示 1 到 5 頁外加一個省略號,那 showNum 就是 5(默認值:6)。
4、skipPart 可配。即拓展部分是否顯示,按需求決定(默認值:true)。

第一步,接收用戶傳入的參數;
第二步,把部分參數交給分頁算法,由算法把最終要渲染的結果以 JSON 形式返回;
第三步,拿 JSON 數據渲染出分頁控件。
這樣做符合高內聚、低耦合的思路。算法部分相對複雜,但把計算與渲染剝離開之後,後期擴展只動一邊就行,可維護性明顯更好。
這部分算不上設計,主要是模仿淘寶的分頁規則。默認情況下分成四種情形:
1、pageNo 在 1 到 5 頁之間時,直接把當前頁標識改成點擊的頁數;
2、pageNo 為 6、7 頁時,渲染 1 到「當前頁 + 1」,例如選第 6 頁就渲染 1~7 頁;
3、判斷 pageNo 是否大於等於 pageCount - showNum,若是說明已接近末頁,此時直接渲染最後 showNum 頁並點亮當前頁;
4、除上述情況外,一律渲染當前頁的前兩頁和後兩頁,同時保留第一頁和最後一頁。
//分頁算法邏輯:只負責計算,不做渲染,返回值為 JSON
function PageAlgorithm(pageNo, pageSize, count, showNum) {
var data = "";
if (pageNo == 1) {
data = '{"algorithm":[{"text":"上一頁","num":0,"status":"disabled"}';
} else {
data = '{"algorithm":[{"text":"上一頁","num":"' + (pageNo - 1) + '","status":"abled"}';
}
//判斷分頁類型
if (count > showNum) {
if (pageNo <= showNum + 2) {
//pageNo 是否在初始化顯示的頁碼範圍內
if (pageNo <= showNum) {
for (var i = 1; i <= showNum; i++) {
if (pageNo == i) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"active"}';
} else {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
}
if (pageNo == showNum) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
} else {
for (var i = 1; i <= pageNo; i++) {
if (i == pageNo) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"active"}';
} else {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
}
if (pageNo != count) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
//選中最後一頁時隱藏省略號
if (pageNo != count && pageNo != (count - 1)) {
data += ',{"text":"…","num":"more","status":""}';
}
}
} else if (pageNo > count - showNum) {
//已接近末頁,直接渲染最後 showNum 頁
data += ',{"text":"1","num":"1","status":"abled"}';
data += ',{"text":"2","num":"2","status":"abled"}';
data += ',{"text":"…","num":"more","status":"disabled"}';
for (var i = count - showNum + 1; i <= count; i++) {
if (pageNo == i) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"active"}';
} else {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
}
} else {
//中間情況:頭兩頁 + 當前頁前後各兩頁 + 尾頁
data += ',{"text":"1","num":"1","status":"abled"}';
data += ',{"text":"2","num":"2","status":"abled"}';
data += ',{"text":"…","num":"more","status":"disabled"}';
for (var i = pageNo - 2; i <= pageNo + 2; i++) {
if (i == pageNo) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"active"}';
} else {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
}
data += ',{"text":"…","num":"more","status":"disabled"}';
}
} else {
//總數不足 showNum,全部列出
for (var i = 1; i <= count; i++) {
if (pageNo == i) {
data += ',{"text":"' + i + '","num":"' + i + '","status":"active"}';
} else {
data += ',{"text":"' + i + '","num":"' + i + '","status":"abled"}';
}
}
}
if (pageNo == count) {
data += ',{"text":"下一頁","num":"' + (pageNo + 1) + '","status":"disabled"}]}';
} else {
data += ',{"text":"下一頁","num":"' + (pageNo + 1) + '","status":"abled"}]}';
}
return JSON.parse(data);
}
不必糾結 JSON 的最終格式,這些字段是算法與渲染兩個方法之間的內部約定。真正要關注的是:如何按分頁所處的區間,輸出不同形態的數據。
這個插件就是本次的最終產物。實現邏輯仿照淘寶,但由於公司業務和淘寶有差異,視覺風格並不完全一致,滿足一般業務需求綽綽有餘。
舉個例子,要得到一個總數據 70 條、每頁顯示 3 條、並顯示拓展部分的分頁控件,只需這樣調用:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<link rel="stylesheet" href="https://cdn.static.runoob.com/libs/bootstrap/3.3.7/css/bootstrap.min.css">
</head>
<body>
<div id="test"></div>
<script type="text/javascript" src="https://cdn.bootcss.com/jquery/3.1.1/jquery.js"></script>
<script type="text/javascript" src="jPage.js"></script>
<script type="text/javascript">
$("#test").page({ count: 70, pageSize: 3, skipPart: true });
</script>
</body>
</html>
效果如下:

這個插件的核心價值在於把「算頁碼」和「畫頁碼」徹底分開:算法函數只吐 JSON,渲染函數只認 JSON。以後想換配色、加按鈕、改成加載更多,都只動其中一層。篇幅有限,插件的更多用法沒法在文中一一展開,配套的文檔說明可以在源碼包裡找到。