背景介紹
最近比較空閒,公司的後臺就想著把現在的後臺管理系統給改版一下,說是以前的太難看了,用著也不好用,然後給我甩過來一個ant-design-pro的連結,說是他看這個就挺不錯的。
我當時心裡就想著,之前的那個專案混合在你們的java專案裡,跟普通的jsp頁面差不多,一下就是一大堆的css和js檔案,看著我都害怕(好吧,我承認其實我都不敢看),這能載入的快了就奇了怪了。ant-design最初是為react設計的,ant-design-pro自然也是用react了,不得不說人家這個介面看著確實舒服。
對著ant-design-pro的官方文件看了一通,貌似看了跟沒看也差不多???算了,還是直接看程式碼吧,整理了一下思路,大致上是看懂了,除了react + react-router外,狀態管理用的是 dva, redux的非同步問題算是解決了,要不就開始直接寫頁面吧?
等等,我好像漏掉了點什麼?噢,對,先看看打包出來的檔案大小,一打包我的心就涼了,最大的js居然有900多k,ant-design的原始檔是真的大。react我還只是能寫出程式碼,打包優化這個可就有點為難我了。這時的我再想到公司那1m的頻寬,還有這幾個後臺的技術能力,要不然這個技術棧我還是放棄吧?不能指望連 請求頭, CORS稍微高階一點的攜帶cookie, nginx靜態伺服器 都搞不懂的人去給我弄個靜態伺服器,再順便開啟一下gzip吧?算了算了,找找有沒有vue + element-ui的後臺模板,不用太費勁就找到了vue-element-admin。
vue-element-admin用著還行,就是介面不太符合我的理想情況,就對著ant-design-pro改造了一點,列表頁大概就是下面這樣了。列表的資料是要分頁的,普通的列表頁只有一個頁面棧,也就是使用者點選位址列的回退位址列時,會返回上一個頁面棧,而不是上一頁的資料,不太符合使用者習慣吧?畢竟傳統的網站都是可以回退到上一頁的,嗯,話不多說,進入正題吧。
第一步:改變位址列
假設列表頁的路徑是 /user/list,分頁相關的引數為{ page: 1, pagesize: 10 }
,從其他頁面跳轉過來的時候,我們的路徑通常是不包含任何引數的,之後的列表資料都是根據該頁面的page和pagesize進行變化的,當未使用keep-alive快取元件時,每次進入列表頁都相當於第一次進入,也就是說每次都只能獲取第一頁的資料。
既然列表資料是用page和pagesize進行變化的,那直接從位址列獲取page和pagesize進行賦值不就好了?那麼是改變位址列的程式碼是直接寫在當前頁面還是 獨立為分頁元件 呢?從複用性方面來說,還是獨立出來的好,畢竟其他頁面可能也會使用到,總不能每次都複製貼上吧,那元件化的意義何在?當然了,也不是說分頁就必須用這個自定義的分頁元件,只推薦在主頁面(非遮罩層,有的頁面會在點選某一行資料時出現遮罩層顯示子列表,此時使用element-ui的分頁元件即可)需要分頁時使用。
當改變位址列的時候,我們是不希望不帶分頁引數的頁面棧存在的,此時用replace直接替換即可。
MyPagination.vue的初始結構為:
<template>
<div class = " flex all-center">
<template v-if="total > 0">
<el-pagination
:page-size="pagesize"
:total="total"
:current-page="page"
background
layout="prev, pager, next, jumper, total"
class="my-pagination"
@current-change="changePage" />
</template>
</div>
</template>
<script>
export default {
name: 'MyPagination',
props: {
total: {
type: Number,
default: 0,
},
page: {
type: Number,
default: 1,
},
pagesize: {
type: Number,
default: 10,
},
totalPages: {
type: Number,
default: 1,
},
},
created() {
this.getCurrentPage();
},
methods: {
changePage(val) {
this.handlePage('push', val, this.pagesize);
this.$emit('change', val, this.pagesize);
},
getCurrentPage() {
var { page, pagesize } = this.$route.query;
if (!page || !pagesize) {
this.handlePage('replace', page || 1, +pagesize || this.pagesize);
return true;
}
return false;
},
handlePage(type, page, pagesize) {
this.$router[type]({
path: this.$route.path,
query: { ...this.$route.query, page, pagesize },
});
}
},
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
.my-pagination {
padding-top: 24px;
}
</style>
複製程式碼
父元件的關鍵程式碼:
<MyPagination :total = "total" :pagesize = "pagesize" :page="page" :totalPages = "totalPages" @change = "changePage" />
methods: {
changePage(page, pagesize) {
var _page = this.page,
_pagesize = this.pagesize;
this.page = page;
this.pagesize = pagesize;
if (page !== _page && pagesize || _pagesize !== pagesize) this.fetchData(); // 非首次進入頁面時再獲取分頁資料,因為在created鉤子中已經獲取過一次了。
},
}
複製程式碼
實現效果: 首次進入該頁面時,如果不含有分頁引數,就會先改變分頁引數,然後再獲取資料,之後點選分頁元件的頁碼也會獲取分頁之後的資料。
第二步: 觀察路由變化
上一步的實現效果乍一看好像沒什麼不對勁的地方,但是如果直接改變位址列的話,顯示的當前頁和當前資料都不會變化。前端路由在頁面的查詢引數(指的是router的查詢引數,可不是普通頁面的查詢引數)變化時,預設是不會重新載入的,除非頁面的key發生變化,這樣是為了儘可能的防止頁面重新渲染,所以就不用key的方式解決了,直接通過vue的watch檢測 $route 的變化,從而改變當前頁和當前資料的顯示問題。
在MyPagination.vue中新增:
watch: {
'$route'(to, from) {
let { page, pagesize } = to.query;
if (!this.getCurrentPage()) {
this.$emit('change', +page || 1, +pagesize || 10);
}
}
},
複製程式碼
第三步: 控制pagesize的大小
在上一步的效果中,當改變位址列的page和pagesize時,列表頁的資料也會隨之變化。既然是根據位址列的引數變化,那麼新的問題就產生了,
如果使用者輸入的page大於頁面總數呢?
這個時候主要就看後臺怎麼設計了,
- 返回第一頁的資料。
getCurrentPage() {
var { page, pagesize } = this.$route.query;
/*
(totalPages > 0 && (page > totalPages));滿足總頁數大於0且當前頁大於總頁數時,跳轉到第一頁
*/
if (!page || !pagesize || (totalPages > 0 && (page > totalPages))) {
this.handlePage('replace', page || 1, this.pagesize);
return true;
}
return false;
},
複製程式碼
- 返回最後一頁的資料(我覺得這種操作應該是比較合理的)。
getCurrentPage() {
var { page, pagesize } = this.$route.query,
MAX_PAGESIZE = this.max,
totalPages = this.totalPages;
if (!page || !pagesize) {
this.handlePage('replace', page || 1, +pagesize || this.pagesize);
return true;
} else if (totalPages > 0 && (page > totalPages)) {
this.handlePage('replace', totalPages, +pagesize);
return true;
}
return false;
},
複製程式碼
替換當前頁面棧,return true的作用是阻止watch中的後續操作,取消本次請求。替換頁面以後,請求遠端資料,更新當前頁和資料的顯示。
- 返回空陣列(可能大多數後臺都是這麼設計的,他們應該沒想過page會大於總頁數吧)。 程式碼與2中的一樣。
上文都是建立在totalPages已確定的情況,如果是首次進入頁面的話情況就會不一樣了。
如果是首次進入頁面的話,totalPages第一次是0,也就是位址列的引數將不會發生變化,這時候就會出現位址列和分頁元件的顯示不一致的情況。這時候可以在分頁元件中watch totalPages的變化。
totalPages(newVal, oldVal) {
if (+oldVal === 0 && newVal > 0) {
this.handlePage('replace', this.page, +this.pagesize);
}
}
複製程式碼
如果pagesize過大呢?
pagesize是必須要進行限制的,如果太大的話,後臺查詢資料就會非常慢,也可能會造成壓力。 解決辦法其實也簡單,就是在props增加一個max屬性,然後在getCurrentPage方法中進行限制,程式碼如下:
props: {
max: {
type: Number,
default: 20,
},
},
methods: {
getCurrentPage() {
var { page, pagesize } = this.$route.query,
MAX_PAGESIZE = this.max,
totalPages = this.totalPages;
if (!page || !pagesize) {
this.handlePage('replace', page || 1, +pagesize || this.pagesize);
return true;
} else if (pagesize > MAX_PAGESIZE) {
this.handlePage('replace', page, MAX_PAGESIZE);
return true;
} else if (totalPages > 0 && (page > totalPages)) {
this.handlePage('replace', totalPages, +pagesize);
return true;
}
return false;
},
},
複製程式碼
第四步: 優化程式碼
點選分頁元件的頁碼時產生兩次請求
點選分頁元件時,1. 會監聽current-change事件並改變位址列,同時emit change事件至父元件,2. 但是位址列改變後,在watch $route也會emit change事件至父元件,那麼只需要合併emit change事件,即current-change事件中只改變位址列。
changePage(val) {
this.handlePage('push', val, this.pagesize);
},
複製程式碼
結果
至此,一個自定義的分頁元件就已經實現了,改變位址列的引數就可以看到分頁資料的變化了,點選頁碼時位址列也會隨之而改變,請求數量已經儘可能的減少了。
自定義的分頁元件: MyPagination.vue
列表頁: list.vue
完整demo: front_end
如果有什麼問題,歡迎大家留言進行探討。