基础组件

Pagination

Alune 月光主题下的分页,直接保留 Ant Design 原有属性、类型与行为。

使用方式

分页由宿主传入状态和回调,适合在不同应用和文档中复用。先完成快速开始中的 Provider 与样式配置。

import { Pagination } from '@alune/ui';

接入要求见快速开始,选择依据见 交互与无障碍规范。

运行示例

运行与复制源码来自同一 TSX 文件。浮层、状态和主题独立于文档;所有回调只更新本地模拟数据。

真实示例 TSX 独立预览 ↗
查看运行源码
源码文件
import { useState } from 'react';
import { Pagination } from '@alune/ui';

export default function Example() {
  const [page, setPage] = useState(1);
  return (
    <div className="example">
      <h2 className="example-title">共 80 条记录,每页 10 条</h2>
      <div className="example-row">
        <Pagination
          aria-label="示例分页"
          current={page}
          onChange={setPage}
          total={80}
          pageSize={10}
          showSizeChanger={false}
        />
      </div>
    </div>
  );
}

API

直接转导出 Ant Design 的 Pagination,保留原始 Props、泛型、复合成员与回调语义。下表列出常用属性;类型取自当前安装版本,默认值沿用 Ant Design 6。

AluneUIProvider 统一主题与减少动效;宿主维护受控状态、校验和业务回调。

Pagination 完整 API 与默认值 ↗

Pagination

PaginationProps

属性 / 方法 类型 默认值 必填 说明
current number 1 否 受控当前页。
total number 0 否 记录总数。
pageSize number 10 否 每页数量。
disabled boolean false 否 禁用翻页。
onChange ((page: number, pageSize: number) => void) — 否 接收 page 和 pageSize。

交互与使用限制

为每个操作提供可访问名称,为输入关联 label;使用语义化组件和清晰焦点。不要只靠颜色传达状态,禁用与等待时避免重复执行。

宿主负责状态、业务操作、错误处理与真实内容。组件不读取业务 store、路由或 Electron。示例中的反馈和等待均为本地模拟。

键盘、焦点、风险确认与通知策略的完整约定见交互规范。