可自定义设置以下属性:
-
当前页数(v-model:page),类型:number,默认 1
-
每页条数(v-model:pageSize),类型:number,默认 10
-
数据总数(total),类型:number,默认 0
-
是否禁用(disabled),类型:boolean,默认 false
-
显示的页码数(pageAmount),类型:number,默认 5
-
只有一页时是否隐藏分页(hideOnSinglePage),类型:boolean,默认 false
-
是否可以快速跳转至某页(showQuickJumper),类型:boolean,默认 false
-
快速跳转组件 props(jumperProps),参考 Input Props,类型:object,默认 {}
-
是否展示 pageSize 切换器(showSizeChanger),类型:boolean,默认 undefined,当 total 大于 50 时默认为 true
-
pageSize 切换器组件 props(changerProps),参考 Select Props,类型:object,默认 {}
-
设置每页可以显示多少条(pageSizeOptions),类型:string[] | number[],默认 [10, 20, 50, 100]
-
用于显示数据总量和当前数据顺序(showTotal),类型:boolean | | ((total: number, range: number[]) => string),默认 false
-
分页展示位置(placement),类型:'left' | 'center' | 'right',默认 'center'
-
分页按钮大小(size),类型:'large' | 'middle' | 'small',默认 'large'
效果如下图:
在线预览
①创建自定义分页组件Pagination.vue:
其中引入使用了以下组件与工具函数:
<script setup lang="ts">
import { ref, computed, watch, nextTick } from 'vue'
import Input from 'components/input'
import Select from 'components/select'
import { useInject } from 'components/utils'
export interface Props {
page?: number // (v-model) 当前页数
pageSize?: number // (v-model) 每页条数
total?: number // 数据总数
disabled?: boolean // 是否禁用
pageAmount?: number // 显示的页码数
hideOnSinglePage?: boolean // 只有一页时是否隐藏分页
showQuickJumper?: boolean // 是否可以快速跳转至某页
jumperProps?: object // 快速跳转组件 props,参考 Input 组件 Props
showSizeChanger?: boolean // 是否展示 pageSize 切换器,当 total 大于 50 时默认为 true
changerProps?: object // pageSize 切换器组件 props,参考 Select 组件 Props
pageSizeOptions?: string[] | number[] // 设置每页可以显示多少条
showTotal?: boolean | ((total: number, range: number[]) => string) // 用于显示数据总量和当前数据顺序
placement?: 'left' | 'center' | 'right' // 分页展示位置,靠左 left,居中 center,靠右 right
size?: 'large' | 'middle' | 'small' // 分页按钮大小
}
const props = withDefaults(defineProps<Props>(), {
page: 1,
pageSize: 10,
total: 0,
disabled: false,
pageAmount: 5,
hideOnSinglePage: false,
showQuickJumper: false,
jumperProps: () => ({}),
showSizeChanger: undefined,
changerProps: () => ({}),
pageSizeOptions: () => [10, 20, 50, 100],
showTotal: false,
placement: 'center',
size: 'large'
})
const currentPage = ref<number>(props.page) // 当前页数
const currentPageSize = ref<number>(props.pageSize) // 每页条数
const pageListRef = ref<HTMLElement[] | null>(null) // pageList 生成的 page 元素引用
const jumpNumber = ref() // 跳转的页码
const forwardMore = ref(false) // 左省略号展示
const backwardMore = ref(false) // 右省略号展示
const { colorPalettes } = useInject('Pagination') // 主题色注入
const emits = defineEmits(['update:page', 'update:pageSize', 'change', 'pageSizeChange'])
const totalPage = computed(() => {
// 总页数
return Math.ceil(props.total / currentPageSize.value) // 向上取整
})
const totalText = computed(() => {
if (typeof props.showTotal === 'boolean') {
if (props.showTotal) {
return `共 ${props.total} 条`
}
} else {
const first = (currentPage.value - 1) * currentPageSize.value + 1
const last =
currentPage.value * currentPageSize.value > props.total ? props.total : currentPage.value * currentPageSize.value
return props.showTotal(props.total, [first, last])
}
return null
})
const pageList = computed(() => {
// 获取显示的页码数组
return dealPageList(currentPage.value).filter((n) => n !== 1 && n !== totalPage.value)
})
const showPageSizeChanger = computed(() => {
if (typeof props.showSizeChanger === 'boolean') {
return props.showSizeChanger
} else {
// undefined
return props.total > 50
}
})
const selectOptions = computed(() => {
const pageSizeOptipns = [currentPageSize.value, ...props.pageSizeOptions].map((pageSize: number | string) =>
Number(pageSize)
)
return Array.from(new Set(pageSizeOptipns))
.sort((a: number, b: number) => a - b)
.map((pageSize: number) => {
return {
label: `${pageSize} 条/页`,
value: pageSize
}
})
})
const selectHeight = computed(() => {
const heightMap = {
small: 24,
middle: 28,
large: 32
}
return heightMap[props.size] || heightMap['large']
})
const optionsSize = computed(() => {
if (props.size === 'small') {
return 'small'
}
return 'middle'
})
watch(
() => props.page,
(to) => {
currentPage.value = to
}
)
watch(
() => props.pageSize,
(to: number) => {
currentPageSize.value = to
}
)
function dealPageList(curPage: number): number[] {
var resList = []
var offset = Math.floor(props.pageAmount / 2)
var pager = {
start: curPage - offset,
end: curPage + offset
}
if (pager.start < 1) {
pager.end = pager.end + (1 - pager.start)
pager.start = 1
}
if (pager.end > totalPage.value) {
pager.start = pager.start - (pager.end - totalPage.value)
pager.end = totalPage.value
}
if (pager.start < 1) {
pager.start = 1
}
if (pager.start > 1) {
forwardMore.value = true
} else {
forwardMore.value = false
}
if (pager.end < totalPage.value) {
backwardMore.value = true
} else {
backwardMore.value = false
}
// 生成要显示的页码数组
for (let i = pager.start; i <= pager.end; i++) {
resList.push(i)
}
return resList
}
function onPageForward(): void {
currentPage.value = currentPage.value - props.pageAmount > 0 ? currentPage.value - props.pageAmount : 1
emits('update:page', currentPage.value)
emits('change', currentPage.value, currentPageSize.value)
}
function onPageBackward(): void {
currentPage.value =
currentPage.value + props.pageAmount < totalPage.value ? currentPage.value + props.pageAmount : totalPage.value
emits('update:page', currentPage.value)
emits('change', currentPage.value, currentPageSize.value)
}
async function onPageJump(): Promise<void> {
let num = Number(jumpNumber.value) // 转换为数字
if (jumpNumber.value && Number.isInteger(num)) {
// 是否为整数
if (num < 1) {
num = 1
}
if (num > totalPage.value) {
num = totalPage.value
}
onPageChange(num)
}
await nextTick()
jumpNumber.value = undefined // 清空跳转输入框
}
// 聚焦当前页码
async function activePageFocus(activePage: number) {
await nextTick()
const targetIndex = pageList.value.findIndex((page: number) => page === activePage)
pageListRef.value?.[targetIndex].focus()
}
function onPageChange(page: number, inPageList: boolean = false): boolean | void {
if (page === 0 || page === totalPage.value + 1) {
return false
}
// 点击的页码不是当前页码
if (currentPage.value !== page) {
currentPage.value = page
if (inPageList) {
activePageFocus(page)
}
emits('update:page', currentPage.value)
emits('change', currentPage.value, currentPageSize.value)
}
}
function onPageNext(e: Event, page: number): void {
;(e.target as HTMLElement).focus()
onPageChange(page)
}
// pageSize 切换器变化时的回调
function onPageSizeChange(pageSize: number): void {
currentPageSize.value = pageSize
const maxPage = Math.ceil(props.total / pageSize)
if (currentPage.value > maxPage) {
currentPage.value = maxPage
}
emits('update:page', currentPage.value)
emits('update:pageSize', currentPageSize.value)
emits('pageSizeChange', currentPage.value, currentPageSize.value)
emits('change', currentPage.value, currentPageSize.value)
}
</script>
<template>
<div
class="m-pagination"
:class="[
`pagination-${placement}`,
{
'pagination-small': size === 'small',
'pagination-middle': size === 'middle',
'pagination-disabled': disabled,
'pagination-hidden': !total || (hideOnSinglePage && total <= currentPageSize)
}
]"
:style="`--pagination-primary-color: ${colorPalettes[5]}; --pagination-primary-color-focus-visible: ${colorPalettes[2]};`"
>
<span class="pagination-total-text" v-if="totalText">{{ totalText }}</span>
<span
tabindex="0"
class="pagination-prev"
:class="{ 'pagination-item-disabled': currentPage === 1 }"
@keydown.enter.prevent="disabled ? () => false : onPageChange(currentPage - 1)"
@click="disabled || currentPage === 1 ? () => false : onPageChange(currentPage - 1)"
>
<svg
class="arrow-svg"
viewBox="64 64 896 896"
data-icon="left"
width="1em"
height="1em"
fill="currentColor"
aria-hidden="true"
focusable="false"
>
<path
d="M724 218.3V141c0-6.7-7.7-10.4-12.9-6.3L260.3 486.8a31.86 31.86 0 0 0 0 50.3l450.8 352.1c5.3 4.1 12.9.4 12.9-6.3v-77.3c0-4.9-2.3-9.6-6.1-12.6l-360-281 360-281.1c3.8-3 6.1-7.7 6.1-12.6z"
></path>
</svg>
</span>
<span
tabindex="0"
:class="['pagination-item', { 'pagination-item-active': currentPage === 1 }]"
@keydown.enter.prevent="disabled ? () => false : onPageChange(1)"
@click="disabled ? () => false : onPageChange(1)"
>
1
</span>
<span
v-show="forwardMore && pageList[0] - 1 > 1"
tabindex="0"
ref="forward"
class="pagintion-jump-prev"
@keydown.enter.prevent="disabled ? () => false : onPageForward()"
@click="disabled ? () => false : onPageForward()"
>
<span class="ellipsis-character">•••</span>
<svg
class="icon-svg"
focusable="false"
data-icon="double-left"
width="1em"
height="1em"
fill="currentColor"
aria-hidden="true"
viewBox="64 64 896 896"
>
<path
d="M272.9 512l265.4-339.1c4.1-5.2.4-12.9-6.3-12.9h-77.3c-4.9 0-9.6 2.3-12.6 6.1L186.8 492.3a31.99 31.99 0 000 39.5l255.3 326.1c3 3.9 7.7 6.1 12.6 6.1H532c6.7 0 10.4-7.7 6.3-12.9L272.9 512zm304 0l265.4-339.1c4.1-5.2.4-12.9-6.3-12.9h-77.3c-4.9 0-9.6 2.3-12.6 6.1L490.8 492.3a31.99 31.99 0 000 39.5l255.3 326.1c3 3.9 7.7 6.1 12.6 6.1H836c6.7 0 10.4-7.7 6.3-12.9L576.9 512z"
></path>
</svg>
</span>
<span
ref="pageListRef"
tabindex="0"
:class="['pagination-item', { 'pagination-item-active': currentPage === page }]"
v-for="(page, index) in pageList"
:key="index"
@keydown.enter.prevent="disabled ? () => false : onPageChange(page, true)"
@click="disabled ? () => false : onPageChange(page, true)"
>
{{ page }}
</span>
<span
v-show="backwardMore && pageList[pageList.length - 1] + 1 < totalPage"
tabindex="0"
ref="backward"
class="pagintion-jump-next"
@keydown.enter.prevent="disabled ? () => false : onPageBackward()"
@click="disabled ? () => false : onPageBackward()"
>
<span class="ellipsis-character">•••</span>
<svg
class="icon-svg"
focusable="false"
data-icon="double-right"
width="1em"
height="1em"
fill="currentColor"
aria-hidden="true"
viewBox="64 64 896 896"
>
<path
d="M533.2 492.3L277.9 166.1c-3-3.9-7.7-6.1-12.6-6.1H188c-6.7 0-10.4 7.7-6.3 12.9L447.1 512 181.7 851.1A7.98 7.98 0 00188 864h77.3c4.9 0 9.6-2.3 12.6-6.1l255.3-326.1c9.1-11.7 9.1-27.9 0-39.5zm304 0L581.9 166.1c-3-3.9-7.7-6.1-12.6-6.1H492c-6.7 0-10.4 7.7-6.3 12.9L751.1 512 485.7 851.1A7.98 7.98 0 00492 864h77.3c4.9 0 9.6-2.3 12.6-6.1l255.3-326.1c9.1-11.7 9.1-27.9 0-39.5z"
></path>
</svg>
</span>
<span
v-show="totalPage !== 1"
tabindex="0"
:class="['pagination-item', { 'pagination-item-active': currentPage === totalPage }]"
@keydown.enter.prevent="disabled ? () => false : onPageChange(totalPage)"
@click="disabled ? () => false : onPageChange(totalPage)"
>
{{ totalPage }}
</span>
<span
tabindex="0"
class="pagination-next"
:class="{ 'pagination-item-disabled': currentPage === totalPage }"
@keydown.enter.prevent="disabled ? () => false : onPageChange(currentPage + 1)"
@click="disabled || currentPage === totalPage ? () => false : onPageNext($event, currentPage + 1)"
>
<svg
class="arrow-svg"
viewBox="64 64 896 896"
data-icon="right"
width="1em"
height="1em"
fill="currentColor"
aria-hidden="true"
focusable="false"
>
<path
d="M765.7 486.8L314.9 134.7A7.97 7.97 0 0 0 302 141v77.3c0 4.9 2.3 9.6 6.1 12.6l360 281.1-360 281.1c-3.9 3-6.1 7.7-6.1 12.6V883c0 6.7 7.7 10.4 12.9 6.3l450.8-352.1a31.96 31.96 0 0 0 0-50.4z"
></path>
</svg>
</span>
<span class="pagination-options" v-if="showPageSizeChanger || showQuickJumper">
<Select
v-if="showPageSizeChanger"
:size="optionsSize"
:height="selectHeight"
:disabled="disabled"
:options="selectOptions"
v-model="currentPageSize"
@change="onPageSizeChange"
v-bind="changerProps"
/>
<span class="pagination-jump-page" v-if="showQuickJumper">
跳至<Input
:width="50"
:size="optionsSize"
:disabled="disabled"
v-model:value.lazy="jumpNumber"
@change="onPageJump"
@enter="onPageJump"
v-bind="jumperProps"
/>页
</span>
</span>
</div>
</template>
<style lang="less" scoped>
.m-pagination {
display: flex;
align-items: center;
gap: 8px;
font-size: 14px;
color: rgba(0, 0, 0, 0.88);
line-height: 1.5714285714285714;
.pagination-total-text {
display: inline-flex;
align-items: center;
height: 32px;
}
.pagination-item {
display: inline-flex;
justify-content: center;
align-items: center;
padding: 0 6px;
min-width: 32px;
height: 32px;
border: 1px solid #d9d9d9;
border-radius: 6px;
background: #fff;
cursor: pointer;
outline: 0;
user-select: none; // 禁止选取文本
transition: all 0.3s;
&:hover {
color: var(--pagination-primary-color);
border-color: var(--pagination-primary-color);
}
&:focus-visible {
outline: 2px solid var(--pagination-primary-color-focus-visible);
outline-offset: 1px;
transition:
outline-offset 0s,
outline 0s;
}
}
.pagination-prev,
.pagination-next {
display: inline-flex;
align-items: center;
justify-content: center;
min-width: 32px;
height: 32px;
border: 1px solid #d9d9d9;
border-radius: 6px;
background: #fff;
cursor: pointer;
outline: 0;
user-select: none; // 禁止选取文本
transition: all 0.3s;
.arrow-svg {
display: inline-block;
font-size: 12px;
color: rgba(0, 0, 0, 0.65);
fill: currentColor;
transition: color 0.3s;
}
&:hover {
border-color: var(--pagination-primary-color);
.arrow-svg {
color: var(--pagination-primary-color);
}
}
&:focus-visible:not(.pagination-item-disabled) {
outline: 2px solid var(--pagination-primary-color-focus-visible);
outline-offset: 1px;
transition:
outline-offset 0s,
outline 0s;
}
}
.pagination-item-active {
// 悬浮/选中样式
color: var(--pagination-primary-color);
border-color: var(--pagination-primary-color);
}
.pagination-item-disabled {
color: rgba(0, 0, 0, 0.25);
background: #fff;
border-color: #d9d9d9;
cursor: not-allowed;
&:hover {
font-weight: 400;
color: rgba(0, 0, 0, 0.65);
border-color: #d9d9d9;
.arrow-svg {
color: rgba(0, 0, 0, 0.25);
}
}
.arrow-svg {
color: rgba(0, 0, 0, 0.25);
}
}
.pagintion-jump-prev,
.pagintion-jump-next {
position: relative;
display: inline-flex;
align-items: center;
min-width: 32px;
height: 32px;
border-radius: 6px;
cursor: pointer;
outline: 0;
.ellipsis-character {
position: absolute;
top: 0;
left: 0;
bottom: 0;
right: 0;
margin: auto;
color: rgba(0, 0, 0, 0.25);
font-family: Arial, Helvetica, sans-serif;
line-height: 32px;
letter-spacing: 2px;
text-align: center;
text-indent: 0.13em;
opacity: 1;
transition: all 0.3s;
}
.icon-svg {
position: absolute;
top: 0;
left: 0;
bottom: 0;
right: 0;
margin: auto;
display: inline-block;
font-size: 12px;
color: var(--pagination-primary-color);
fill: currentColor;
opacity: 0;
pointer-events: none;
transition: all 0.3s;
}
&:hover {
.ellipsis-character {
opacity: 0;
pointer-events: none;
}
.icon-svg {
opacity: 1;
pointer-events: auto;
}
}
&:focus-visible {
outline: 2px solid var(--pagination-primary-color-focus-visible);
outline-offset: 1px;
transition:
outline-offset 0s,
outline 0s;
.ellipsis-character {
opacity: 0;
pointer-events: none;
}
.icon-svg {
opacity: 1;
pointer-events: auto;
}
}
}
.pagination-options {
display: inline-flex;
gap: 8px;
margin-left: 8px;
.pagination-jump-page {
display: inline-flex;
gap: 8px;
align-items: center;
vertical-align: bottom;
height: 32px;
}
}
}
.pagination-left {
justify-content: flex-start;
}
.pagination-center {
justify-content: center;
}
.pagination-right {
justify-content: flex-end;
}
.pagination-small {
gap: 4px;
.pagination-total-text {
height: 24px;
}
.pagination-item {
min-width: 24px;
height: 24px;
}
.pagination-prev,
.pagination-next {
min-width: 24px;
height: 24px;
}
.pagintion-jump-prev,
.pagintion-jump-next {
min-width: 24px;
height: 24px;
.ellipsis-character {
line-height: 24px;
}
}
.pagination-options {
gap: 4px;
margin-left: 4px;
.pagination-jump-page {
gap: 4px;
height: 24px;
}
}
}
.pagination-middle {
gap: 6px;
.pagination-total-text {
height: 28px;
}
.pagination-item {
min-width: 28px;
height: 28px;
}
.pagination-prev,
.pagination-next {
min-width: 28px;
height: 28px;
}
.pagintion-jump-prev,
.pagintion-jump-next {
min-width: 28px;
height: 28px;
.ellipsis-character {
line-height: 28px;
}
}
.pagination-options {
gap: 6px;
margin-left: 6px;
.pagination-jump-page {
gap: 6px;
height: 28px;
:deep(.m-input) {
.input-wrap {
padding: 3px 11px;
}
}
}
}
}
.pagination-disabled {
.pagination-prev,
.pagination-next {
color: rgba(0, 0, 0, 0.25);
border-color: rgba(0, 0, 0, 0.25);
cursor: not-allowed;
.arrow-svg {
color: rgba(0, 0, 0, 0.25);
}
&:hover {
border-color: rgba(0, 0, 0, 0.25);
.arrow-svg {
color: rgba(0, 0, 0, 0.25);
}
}
&:focus-visible {
outline: 0 !important;
}
}
.pagination-item {
color: rgba(0, 0, 0, 0.25);
border-color: rgba(0, 0, 0, 0.25);
cursor: not-allowed;
&:hover {
font-weight: normal;
color: rgba(0, 0, 0, 0.25);
border-color: rgba(0, 0, 0, 0.25);
}
&:focus-visible {
outline: 0;
}
}
.pagination-item-active {
border-color: #d9d9d9;
background-color: rgba(0, 0, 0, 0.15);
&:hover {
font-weight: 600;
color: rgba(0, 0, 0, 0.25);
border-color: #d9d9d9;
background-color: rgba(0, 0, 0, 0.15);
}
}
.pagintion-jump-prev,
.pagintion-jump-next {
color: rgba(0, 0, 0, 0.25);
cursor: not-allowed;
&:hover {
.ellipsis-character {
opacity: 1;
pointer-events: none;
}
.icon-svg {
opacity: 0;
pointer-events: none;
}
}
&:focus-visible {
outline: 0;
.ellipsis-character {
opacity: 1;
pointer-events: none;
}
.icon-svg {
opacity: 0;
pointer-events: none;
}
}
}
.pagination-options {
color: rgba(0, 0, 0, 0.25);
cursor: not-allowed;
}
}
.pagination-hidden {
display: none;
}
</style>
②在要使用的页面引入:
其中引入使用了以下组件:
<script setup lang="ts">
import Pagination from './Pagination.vue'
import { ref } from 'vue'
import type { PaginationProps } from 'vue-amazing-ui'
const page = ref(1)
const pageSize = ref(10)
const total = ref(500)
const placementOptions = [
{
label: 'left',
value: 'left'
},
{
label: 'center',
value: 'center'
},
{
label: 'right',
value: 'right'
}
]
const placement = ref<PaginationProps['placement']>('left')
const sizeOptions = [
{
label: 'small',
value: 'small'
},
{
label: 'middle',
value: 'middle'
},
{
label: 'large',
value: 'large'
}
]
const size = ref<PaginationProps['size']>('middle')
function onChange(page: number, pageSize: number) {
// 页码 page 或每页条数 pageSize 改变的回调
console.log('change page', page)
console.log('change pageSize', pageSize)
}
function pageSizeChange(page: number, pageSize: number) {
// 每页条数 pageSize 变化的回调
console.log('pageSizeChange page', page)
console.log('pageSizeChange pageSize', pageSize)
}
</script>
<template>
<div>
<h1>{{ $route.name }} {{ $route.meta.title }}</h1>
<h2 class="mt30 mb10">基本使用</h2>
<Pagination v-model:page="page" :total="50" @change="onChange" />
<h2 class="mt30 mb10">自定义位置</h2>
<Flex vertical>
<Radio :options="placementOptions" v-model:value="placement" button button-style="solid" />
<Pagination v-model:page="page" :total="total" :placement="placement" @change="onChange" />
</Flex>
<h2 class="mt30 mb10">三种尺寸</h2>
<Flex vertical>
<Radio :options="sizeOptions" v-model:value="size" button button-style="solid" />
<Pagination v-model:page="page" :size="size" :total="total" show-quick-jumper @change="onChange" />
</Flex>
<h2 class="mt30 mb10">自定义 pageSize 切换选项</h2>
<Pagination
v-model:page="page"
v-model:page-size="pageSize"
:total="total"
:page-size-options="[10, 20, 30, 40, 50]"
@change="onChange"
@pageSizeChange="pageSizeChange"
/>
<h2 class="mt30 mb10">隐藏 pageSize 切换器</h2>
<Pagination v-model:page="page" :total="total" :show-size-changer="false" @change="onChange" />
<h2 class="mt30 mb10">快速跳转</h2>
<Pagination v-model:page="page" :total="total" show-quick-jumper @change="onChange" />
<h2 class="mt30 mb10">数据总数</h2>
<Flex vertical>
<Pagination v-model:page="page" :total="total" show-total @change="onChange" />
<Pagination
v-model:page="page"
:total="total"
:show-total="(total: number) => `Total ${total} items`"
@change="onChange"
/>
<Pagination
v-model:page="page"
:total="total"
:show-total="(total: number, range: number[]) => `${range[0]}-${range[1]} of ${total} items`"
@change="onChange"
/>
</Flex>
<h2 class="mt30 mb10">禁用</h2>
<Pagination disabled v-model:page="page" :total="total" show-quick-jumper @change="onChange" />
</div>
</template>