Pagination 分页
按页浏览较多的数据。
基础用法
total 是完整结果的总条数,而不是当前页条数。页码从 1 开始,非受控用法由组件管理当前页。
basic.tsx
越界页码会限制到有效范围。total={0} 时仍显示第 1 页,前后翻页按钮均禁用。
示例
按钮样式
通过 variant 选择描边或无边框的分页按钮。
描边(默认)
无边框
variants.tsx
不同尺寸
通过 size 设置分页按钮尺寸。
小
中(默认)
大
sizes.tsx
数据控制
加载远程数据时,同时控制 current 和 pageSize,在 onChange 中一起更新。数据请求由应用发起;下面用当前页和数据范围展示状态变化。
第 1 页,每页 10 条
controlled.tsx
改变每页条数会尽量保留当前数据位置:每页 10 条的第 3 页切换到每页 20 条,会进入第 2 页。外部属性变化不会额外触发 onChange。
简洁模式
设置 simple,只显示当前页和前后翻页操作。
simple.tsx
禁用状态
通过 disabled 禁止切换分页。
states.tsx
API
Pagination API
配置总条目数、当前页、每页数量和分页交互。
组件同时支持 aria-label、className、style 等原生 <nav> 属性。