Vant3 Pagination 分頁

2021-09-14 11:08 更新

介紹

數(shù)據(jù)量過多時(shí),采用分頁的形式將數(shù)據(jù)分隔,每次只加載一個(gè)頁面。

實(shí)例演示

引入

通過以下方式來全局注冊組件,更多注冊方式請參考組件注冊。

import { createApp } from 'vue';
import { Pagination } from 'vant';

const app = createApp();
app.use(Pagination);

代碼演示

基礎(chǔ)用法

通過 v-model 來綁定當(dāng)前頁碼。

<van-pagination v-model="currentPage" :total-items="24" :items-per-page="5" />
import { ref } from 'vue';

export default {
  setup() {
    const currentPage = ref(1);
    return { currentPage };
  },
};

簡單模式

將 mode 設(shè)置為 simple 來切換到簡單模式,此時(shí)分頁器不會展示具體的頁碼按鈕。

<van-pagination v-model="currentPage" :page-count="12" mode="simple" />

顯示省略號

設(shè)置 force-ellipses 后會展示省略號按鈕,點(diǎn)擊后可以快速跳轉(zhuǎn)。

<van-pagination
  v-model="currentPage"
  :total-items="125"
  :show-page-size="3"
  force-ellipses
/>

自定義按鈕

通過 prev-text、next-text 等插槽來自定義分頁按鈕的內(nèi)容。

<van-pagination v-model="currentPage" :total-items="50" :show-page-size="5">
  <template #prev-text>
    <van-icon name="arrow-left" />
  </template>
  <template #next-text>
    <van-icon name="arrow" />
  </template>
  <template #page="{ text }">{{ text }}</template>
</van-pagination>

API

Props

參數(shù) 說明 類型 默認(rèn)值
v-model 當(dāng)前頁碼 number -
mode 顯示模式,可選值為 simple string multi
prev-text 上一頁按鈕文字 string 上一頁
next-text 下一頁按鈕文字 string 下一頁
page-count 總頁數(shù) number | string 根據(jù)頁數(shù)計(jì)算
total-items 總記錄數(shù) number | string 0
items-per-page 每頁記錄數(shù) number | string 10
show-page-size 顯示的頁碼個(gè)數(shù) number | string 5
force-ellipses 是否顯示省略號 boolean false

Events

事件名 說明 回調(diào)參數(shù)
change 頁碼改變時(shí)觸發(fā) -

Slots

名稱 描述 參數(shù)
page 自定義頁碼 { number: number, text: string, active: boolean }
prev-text 自定義上一頁按鈕文字 -
next-text 自定義下一頁按鈕文字 -

樣式變量

組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請參考 ConfigProvider 組件。

名稱 默認(rèn)值 描述
--van-pagination-height 40px -
--van-pagination-font-size var(--van-font-size-md) -
--van-pagination-item-width 36px -
--van-pagination-item-default-color var(--van-primary-color) -
--van-pagination-item-disabled-color var(--van-gray-7) -
--van-pagination-item-disabled-background-color var(--van-background-color) -
--van-pagination-background-color var(--van-white) -
--van-pagination-desc-color var(--van-gray-7) -
--van-pagination-disabled-opacity var(--van-disabled-opacity) -


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號