导航与展开@neumorphism-ui/pagination

Pagination

保留 nav、ul、li、anchor 语义的组合式分页导航。支持当前页、上一页和下一页链接,以及省略项。

@neumorphism-ui/pagination
Registry JSON

预览

安装

安装: paginationnpx shadcn@latest add @neumorphism-ui/pagination

CLI 会依次处理 npm 依赖、base token、utils 和组件源码。

首次使用此 Registry?请先完成 namespace 配置 。

用法

Import

Pagination import 代码
import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"

Example

Pagination 用法代码
<Pagination>
  <PaginationContent>
    <PaginationItem>
      <PaginationPrevious href="?page=1" />
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=1">1</PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=2" isActive>2</PaginationLink>
    </PaginationItem>
    <PaginationItem><PaginationEllipsis /></PaginationItem>
    <PaginationItem>
      <PaginationNext href="?page=3" />
    </PaginationItem>
  </PaginationContent>
</Pagination>

API 参考

组件属性类型默认值说明
Paginationaria-labelstring"pagination"为 pagination navigation 区域提供无障碍名称。
PaginationLinkhref必填string—目标页面的实际 URL。
PaginationLinkisActivebooleanfalse设置当前页样式和 aria-current=page。
PaginationPrevious / PaginationNextchildrenReact.ReactNode"Previous" / "Next"替换默认的翻页文案。

无障碍

  • 01

    每个页面都应使用带有真实 href 的链接,以保留浏览器导航和在新标签页中打开的能力。

  • 02

    只为一个当前页设置 isActive,从而应用 aria-current=page。

  • 03

    Previous 和 Next 带有默认 aria-label;如需本地化,应显式覆盖。