ドキュメントページャーDocumentPagerExperimental
前後のドキュメントへ移動するためのナビゲーションです。
プレビュー
状態とバリエーション
前後リンク
章やコンポーネントの前後を、概要とサムネイル付きで移動できます。
先頭ページ
前のページがない場合は previous に null を渡し、次のリンクだけを表示します。
末尾ページ
次のページがない場合は next に null を渡します。
サムネイルなし
サムネイル画像は任意です。指定しない場合は画像枠ごと表示しません。
プロパティ
表は横にスクロールできます
| プロパティ | 型 | 初期値 | 説明 |
|---|---|---|---|
| previous | DocumentPagerItem | null | - | 前のドキュメント。null の場合は前リンクを表示しません。 |
| next | DocumentPagerItem | null | - | 次のドキュメント。null の場合は次リンクを表示しません。 |
| linkComponent | React.ElementType | - | Next.js Link など任意のリンクコンポーネント。 |
| className | string | - | ナビゲーション本体に追加するクラス名。 |
使い方
import { DocumentPager } from "@gunjo/ui"
export function ArticlePager() {
return (
<DocumentPager
aria-label="前後のドキュメント"
previous={{
href: "/docs/components/command-palette",
directionLabel: "前へ",
title: "コマンドパレット",
subtitle: "CommandPalette",
description: "ナビゲーションやアクション用のグローバルコマンドパレットです。",
categoryLabel: "ナビゲーション",
thumbnailSrc: "/showcase-thumbs/command-palette.light.png",
thumbnailAlt: "コマンドパレットのプレビュー",
thumbnailFallback: "プレビュー",
}}
next={{
href: "/docs/components/footer",
directionLabel: "次へ",
title: "フッター",
subtitle: "Footer",
description: "ページ下部にリンク群や補足情報をまとめて表示します。",
categoryLabel: "ナビゲーション",
thumbnailSrc: "/showcase-thumbs/footer.light.png",
thumbnailAlt: "フッターのプレビュー",
thumbnailFallback: "プレビュー",
}}
/>
)
}