组件Navigation
Pagination
@mox-hub/ui 组件 · Navigation · canonical
pagination@mox-hub/uiNavigationcanonicalsrc/components/pagination.tsx变体演示pagination
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | — | — |
源码
"use client"
import * as React from "react"
import { useMessages } from "../i18n"
import { cn } from "../lib/utils"
import { Button } from "./button"
import { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from "lucide-react"
function Pagination({ className, ...props }: React.ComponentProps<"nav">) {
const M = useMessages()
return (
<nav
role="navigation"
aria-label={M.pagination.label}
data-slot="pagination"
className={cn("mx-auto flex w-full justify-center", className)}
{...props}
/>
)
}
function PaginationContent({
className,
...props
}: React.ComponentProps<"ul">) {
return (
<ul
data-slot="pagination-content"
className={cn("flex items-center gap-1", className)}
{...props}
/>
)
}
function PaginationItem({ ...props }: React.ComponentProps<"li">) {
return <li data-slot="pagination-item" {...props} />
}
type PaginationLinkProps = {
isActive?: boolean
/** 禁用态(审计 P2-18):补 aria-disabled 与点击拦截 */
disabled?: boolean
} & Pick<React.ComponentProps<typeof Button>, "size"> &
React.ComponentProps<"a">
function PaginationLink({
className,
isActive,
disabled = false,
size = "icon",
onClick,
...props
}: PaginationLinkProps) {
return (
<Button
variant={isActive ? "outline" : "ghost"}
size={size}
className={cn(
"aria-disabled:pointer-events-none aria-disabled:opacity-50 pointer-coarse:min-h-11 pointer-coarse:min-w-11",
className
)}
nativeButton={false}
render={
<a
aria-current={isActive ? "page" : undefined}
aria-disabled={disabled || undefined}
tabIndex={disabled ? -1 : undefined}
data-slot="pagination-link"
data-active={isActive}
onClick={(event) => {
if (disabled) {
event.preventDefault()
return
}
onClick?.(event)
}}
{...props}
/>
}
/>
)
}
function PaginationPrevious({
className,
text,
...props
}: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
const M = useMessages()
return (
<PaginationLink
aria-label={M.pagination.goToPrevious}
size="default"
className={cn("ps-2!", className)}
{...props}
>
<ChevronLeftIcon data-icon="inline-start" className="rtl:-scale-x-100" />
<span className="hidden sm:block">{text ?? M.pagination.previous}</span>
</PaginationLink>
)
}
function PaginationNext({
className,
text,
...props
}: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
const M = useMessages()
return (
<PaginationLink
aria-label={M.pagination.goToNext}
size="default"
className={cn("pe-2!", className)}
{...props}
>
<span className="hidden sm:block">{text ?? M.pagination.next}</span>
<ChevronRightIcon data-icon="inline-end" className="rtl:-scale-x-100" />
</PaginationLink>
)
}
function PaginationEllipsis({
className,
...props
}: React.ComponentProps<"span">) {
const M = useMessages()
return (
<span
data-slot="pagination-ellipsis"
className={cn(
"flex size-control-md items-center justify-center pointer-coarse:size-11 [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
>
<MoreHorizontalIcon
/>
<span className="sr-only">{M.pagination.morePages}</span>
</span>
)
}
export {
Pagination,
PaginationContent,
PaginationEllipsis,
PaginationItem,
PaginationLink,
PaginationNext,
PaginationPrevious,
}
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
分页导航,由 Pagination、Content、Item、Link、Previous、Next 组合;当前页用 isActive,链接接路由。