vue - element 分頁器 Pagination 組件封裝

表格和分頁器結合使用在大部分系統中使用都十分頻繁。

爲了爲整個系統提供統一分頁器的外觀和初始設置，基於 element-ui 提供的 pagination 組件，來進行一個封裝，是一個不錯的選擇。

最終效果圖：

1. Pagination.vue

<template>
  <div :class="{'hidden':hidden}" class="pagination-container">
    <el-pagination
      :background="background"
      :current-page.sync="currentPage"
      :page-size.sync="pageSize"
      :layout="device === 'mobile'? layoutMobile : layout"
      :page-sizes="pageSizes"
      :total="total_1"
      v-bind="$attrs"
      @size-change="handleSizeChange"
      @current-change="handleCurrentChange"
    />
  </div>
</template>

<script>
import { scrollTo } from '@/utils/scroll-to'
import { mapGetters } from 'vuex'

function getPageList() {
  let defaultPageList = [10, 50, 100, 200, 500]
  const newPage = Number(localStorage.getItem('pageSize') || 10)
  defaultPageList.push(newPage)
  defaultPageList = [...new Set(defaultPageList.sort((a, b) => a - b))]
  return defaultPageList
}

export default {
  name: 'Pagination',
  props: {
    total: {
      required: true,
      type: Number
    },
    page: {
      type: Number,
      default: 1
    },
    pagerCount: {
      type: Number,
      default: 10
    },
    limit: {
      type: Number,
      default: 10
    },
    pageSizes: {
      type: Array,
      default() {
        return getPageList()
      }
    },
    layout: {
      type: String,
      default: 'total, sizes, prev, pager, next, jumper'
    },
    layoutMobile: {
      type: String,
      default: 'prev, total, next, jumper'
    },
    background: {
      type: Boolean,
      default: true
    },
    autoScroll: {
      type: Boolean,
      default: true
    },
    hidden: {
      type: Boolean,
      default: false
    }
  },
  data() {
    return {
      tempCurrentPage: this.page,
      tempPageSize: this.limit
    }
  },
  computed: {
    total_1() {
      return this.total
    },
    currentPage: {
      get() {
        return this.tempCurrentPage
      },
      set(val) {
        if (this.tempCurrentPage !== val) {
          this.tempCurrentPage = val
          this.$emit('update:page', val)
          // console.log("pagenum change: ", val);
        }
      }
    },
    pageSize: {
      get() {
        return this.tempPageSize
      },
      set(val) {
        if (this.tempPageSize !== val) {
          this.tempPageSize = val
          this.$emit('update:limit', val)
          // console.log("pagesize change: ", val);
        }
      }
    },
    ...mapGetters(['device'])
  },
  methods: {
    resetPagination() {
      this.pageSize = 10
      this.currentPage = 1
    },
    handleSizeChange(val) {
      this.$emit('pagination', { page: this.currentPage, limit: val })
      if (this.autoScroll) {
        scrollTo(0, 800)
      }
    },
    handleCurrentChange(val) {
      this.$emit('pagination', { page: val, limit: this.pageSize })
      if (this.autoScroll) {
        scrollTo(0, 800)
      }
    }
  }
}
</script>

<style scoped>
.pagination-container {
  background: transparent;
  padding: 32px 16px;
}
.pagination-container.hidden {
  display: none;
}
</style>

2. 在其它組件中的使用方法

（1）引入自定義的分頁器組件（組件路徑視實際情況改動）：

import Pagination from "@/components/Pagination";

（2）在組件實例中的 data 函數返回的對象數據中，定義分頁器所需數據：

pagination: {
	total: 0,
	listQuery: {
		page: 1,
		limit: 10
	}
}

（3）在 template 需要的地方，添加 Pagination 組件：

<pagination
   ref="ref"
   :total="pagination.total"
   :page.sync="pagination.listQuery.page"
   :limit.sync="pagination.listQuery.limit"
   @pagination="getList"
 />

（4）在 script 中添加分頁交互邏輯：

    getList(page, limit) {
      // 當分頁器頁碼或分頁數發生改變時，重新請求表格數據
      const pageConfig = {};
      pageConfig.pageNum = Number(page.page);
      pageConfig.pageSize = Number(page.limit);
      // 基於新的分頁數據，重新請求表格數據
      this.getTableData(pageConfig);
    }