Skip to content

Pagination 分页

采用分页控制单页内的信息数量,也可进行页面跳转。

基础用法

分页的基本用法,total 属性为必填项。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 1
  • 2
  • 3
  • 4
  • 5

更多页码

当页码较大时,会使用更多页码的分页样式。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 20

每页条数

通过设置 show-page-size, 展示每页条数选择器。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 20
10 条/页

页码跳转

通过设置 show-jumper,显示页码跳转输入框。

  • 1
  • 2
  • 3
  • 4
  • 5
前往

展示总数

通过设置 show-total 属性显示数据总数。

共 200 条
  • 1
  • 2
  • 3
  • 4
  • 5
  • 20

全部展示

展示全部配置项。

共 50 条
  • 1
  • 2
  • 3
  • 4
  • 5
10 条/页
前往

按钮模式

通过设置 button 属性开启按钮模式。

  • 1
  • 2
  • 3
  • 4
  • 5
10 条/页
前往

简洁模式

通过设置 simple 属性开启简洁模式。

/20

自定义分页按钮

可以通过插槽自定义分页按钮内容。

  • 1
  • 2
  • 3
  • 4
  • 5
  • ~
  • 20

不同尺寸

tu-pagination 组件提供除了默认值 medium 以外的三种尺寸。额外的尺寸:large、small、mini,通过设置 size 属性来配置它们。

共 50 条
  • 1
  • 2
  • 3
  • 4
  • 5
10 条/页
前往
共 50 条
  • 1
  • 2
  • 3
  • 4
  • 5
10 条/页
前往

Pagination API

Pagination Attributes

参数名描述类型默认值
total数据总数Number-
current / v-model当前的页数Number-
default-current默认的页数(非受控状态)Number1
page-size / v-model每页展示的数据条数Number-
default-page-size默认每页展示的数据条数(非受控状态)Number10
disabled是否禁用Booleanfalse
hide-on-single-page单页时是否隐藏分页Booleanfalse
simple是否为简单模式Booleanfalse
button是否为按钮样式Booleanfalse
show-total是否显示数据总数Booleanfalse
show-more是否显示更多按钮Booleanfalse
show-jumper是否显示跳转Booleanfalse
show-page-size是否显示数据条数选择器Booleanfalse
page-size-options数据条数选择器的选项列表Array[10, 20, 30, 40, 50]
page-size-props数据条数选择器的PropsObject-
size分页选择器的大小Stringmedium
page-item-style分页按钮的样式Object-
active-page-item-style当前分页按钮的样式Object-
base-size计算显示省略的基础个数。显示省略的个数为 baseSize + 2 * bufferSizeNumber6
buffer-size显示省略号时,当前页码左右显示的页码个数Number2
auto-adjust是否在改变数据条数时调整页码Booleantrue

Pagination Events

事件名描述参数
change页码改变时触发Function
page-size-change数据条数改变时触发Function

Pagination Slots

参数名描述参数
total总数total: number
page-item-ellipsis分页按钮(省略)-
page-item-step分页按钮(步)type: String
page-item分页按钮page: number