ナビゲーションと開示@neumorphism-ui/pagination

Pagination

nav、ul、li、anchor の semantics を維持する組み合わせ可能な pagination です。active page、previous/next link、省略範囲の indicator を提供します。

@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

    ブラウザーのナビゲーションや新しい tab で開く動作を維持するため、各ページには実際の href を持つ link を使用してください。

  • 02

    現在のページ1つだけに isActive を設定し、aria-current=page を適用してください。

  • 03

    Previous と Next には既定の aria-label があります。ローカライズが必要な場合は上書きしてください。