组件/数据展示

EPagination 分页

import EUI 1.0

示例与代码

每页数量与跳页

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 12 width: parent.width EPagination { id: pagination total: 258 width: parent.width pageSizes: [10, 20, 50, 100] layout: width < 760 ? "total, sizes, ->, jumper" : "total, sizes, prev, pager, next, jumper" onPageSizeChanged: { if (pager) pager.pageSize = pageSize } onCurrentPageChanged: { if (pager) pager.currentPage = currentPage } } EPagination { id: pager width: parent.width visible: width < 760 total: pagination.total layout: "prev, pager, next" pageSize: pagination.pageSize currentPage: pagination.currentPage onCurrentChange: function(number) { pagination.setPage(number) } } EText { text: qsTr("第 %1 页，每页 %2 条").arg(pagination.currentPage).arg(pagination.pageSize) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

分页

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EPagination { total: 256 pageSize: 10 onCurrentChange: function(page) { console.log(page) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

buttonBackgroundbool

为分页按钮显示背景。

默认值true

contentalias

内容插槽；直接在组件内部声明 QML 子对象。

默认值别名：customContent.data

currentPageint

当前页码，从 1 开始。

默认值1

enabledbool

是否允许交互；false 时控件禁用。

默认值true

explicitPageCountint

显式总页数；未设置时从 total 与 pageSize 计算。

默认值0

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

hideOnSinglePagebool

只有一页时隐藏分页器。

默认值false

layoutstring

分页栏中显示的控件及其顺序。

逗号分隔：
prev, pager, next
sizes, total, jumper
->：后续内容右对齐

默认值"total, prev, pager, next"

nextTextstring

下一页或上一页按钮的自定义文字。

默认值""

pageSizeint

每页数据条数。

默认值10

pageSizesvar

可选的每页条数数组。

默认值[10, 20, 50, 100]

pagerCountint

页码按钮数量。

默认值7

prevTextstring

下一页或上一页按钮的自定义文字。

默认值""

showTotalbool

显示分页数据总量。

默认值true

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

totalint

数据总条数。

默认值0

visiblebool

是否显示组件。

默认值!hideOnSinglePage || pageCount > 1

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

effectivePageSizeint只读

分页实际使用的每页数量，至少为 1。

默认值由运行时计算

layoutItemsvar只读

分页布局项目及 -> 左右分组。

默认值由运行时计算

leftItemsvar只读

分页布局项目及 -> 左右分组。

默认值由运行时计算

pageCountint只读

实际分页总页数。

默认值由运行时计算

pagesvar只读

分页器当前显示的页码及省略项列表。

默认值由运行时计算

rightItemsvar只读

分页布局项目及 -> 左右分组。

默认值由运行时计算

splitIndexint只读

分页布局中 -> 的位置。

默认值由运行时计算

localizedTextsvar只读

当前语言的本地化文本；随语言切换更新。

默认值ELocale.texts

信号

签名作用

nextClicked(int page)

点击下一页按钮时触发，page 为目标页码。

currentChange(int page)

当前页变化时触发，page 为新的页码，从 1 开始。

sizeChange(int pageSize)

每页条数改变时触发，pageSize 为新的每页条数。

previousClicked(int page)

点击上一页按钮时触发，page 为目标页码。

changed(int page, int pageSize)

页码或每页条数变化时触发，page 为当前页，pageSize 为每页条数。

方法

签名作用

normalizePage()

将当前页码校正到有效范围，避免页数减少后停留在不存在的页面。

next()

切换到下一项或下一步。

previous()

切换到上一项或上一步。

setPage(page)

切换到 page 指定的页码，页码从 1 开始。

setPageSize(value)

设置每页条数，并更新当前页码范围。