Pagination

Paginationは、コンテンツのページ分割とナビゲーションを管理するためのコンポーネントです。

<Pagination.Root total={10} />

使い方

import { Pagination } from "@yamada-ui/react"

import { Pagination } from "@/components/ui"

import { Pagination } from "@workspaces/ui"

<Pagination.Root total={10} />

バリアントを変更する

<VStack>
  <For each={["solid", "subtle", "surface", "outline"]}>
    {(variant) => (
      <Pagination.Root key={variant} variant={variant} total={10} />
    )}
  </For>
</VStack>

サイズを変更する

<VStack>
  <For each={["xs", "sm", "md", "lg", "xl"]}>
    {(size) => <Pagination.Root key={size} size={size} total={10} />}
  </For>
</VStack>

カラースキームを変更する

<VStack>
  <For each={["success", "warning"]}>
    {(colorScheme) => (
      <Pagination.Root key={colorScheme} colorScheme={colorScheme} total={10} />
    )}
  </For>
</VStack>

デフォルトのページを設定する

<Pagination.Root defaultPage={5} total={10} />

エッジコントロールボタンを追加する

最初と最後のページに移動するボタンを追加する場合は、withEdgesをtrueにします。

<Pagination.Root total={20} withEdges />

前後の数をカスタマイズする

前後の数をカスタマイズする場合は、siblingsに数値を設定します。

<Pagination.Root total={77} siblings={3} />

最初と最後の数をカスタマイズする

最初と最後の数をカスタマイズする場合は、boundariesに数値を設定します。

<Pagination.Root total={77} boundaries={3} />

無効にする

無効にする場合は、disabledをtrueに設定します。

<VStack>
  <For each={["solid", "outline", "ghost", "unstyled"]}>
    {(variant, index) => (
      <Pagination.Root key={index} total={10} variant={variant} disabled />
    )}
  </For>
</VStack>

テキストを表示する

<VStack>
  <Pagination.Root size="md" gap="md" total={10}>
    <Pagination.PrevTrigger>
      <Pagination.Item icon={<ChevronLeftIcon />} />
    </Pagination.PrevTrigger>

    <Pagination.Text format="compact" />

    <Pagination.NextTrigger>
      <Pagination.Item icon={<ChevronRightIcon />} />
    </Pagination.NextTrigger>
  </Pagination.Root>

  <Pagination.Root size="md" gap="md" total={10}>
    <Pagination.PrevTrigger>
      <Pagination.Item icon={<ChevronLeftIcon />} />
    </Pagination.PrevTrigger>

    <Pagination.Text format="short" />

    <Pagination.NextTrigger>
      <Pagination.Item icon={<ChevronRightIcon />} />
    </Pagination.NextTrigger>
  </Pagination.Root>
</VStack>

コントロールボタンをカスタマイズする

<Pagination.Root
  total={10}
  withEdges
  controlNextProps={{
    icon: <ArrowRightIcon />,
  }}
  controlPrevProps={{
    icon: <ArrowLeftIcon />,
  }}
  edgeEndProps={{
    icon: <ArrowRightToLineIcon />,
  }}
  edgeStartProps={{
    icon: <ArrowLeftToLineIcon />,
  }}
/>

テキストをカスタマイズする

<Pagination.Root size="md" gap="md" total={20}>
  <Pagination.PrevTrigger>
    <Pagination.Item icon={<ChevronLeftIcon />} />
  </Pagination.PrevTrigger>

  <Pagination.Text>
    {({ page, total }) => `全${total}ページ中${page}ページ目`}
  </Pagination.Text>

  <Pagination.NextTrigger>
    <Pagination.Item icon={<ChevronRightIcon />} />
  </Pagination.NextTrigger>
</Pagination.Root>

こちらのコードを使用する場合は、"use client"をファイルの上部に追加する必要があります。

制御する

const [page, onChange] = useState<number>(1)

return <Pagination.Root page={page} total={10} onChange={onChange} />

こちらのコードを使用する場合は、"use client"をファイルの上部に追加する必要があります。

Props

Pagination.Root

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`size`	`"md"`	`"2xl" \| "lg" \| "md" \| "sm" \| "xl" \| "xs"` The size of the component.
`variant`	`"solid"`	`"outline" \| "solid" \| "subtle" \| "surface"` The variant of the component.
`total`	-	`number` The total number of pages in pagination.
`align`	-	`"-moz-initial" \| "baseline" \| "center" \| "end" \| "flex-end" \| "flex-start" \| "inherit" \| "initial" \| "normal" \| "revert-layer" ...` The CSS `align-items` property.
`attached`	`false`	`boolean` If `true`, the borderRadius of button that are direct children will be altered to look flushed together.
`basis`	-	`"-moz-fit-content" \| "-moz-initial" \| "-moz-max-content" \| "-moz-min-content" \| "-webkit-auto" \| "0.5" \| "1.5" \| "1" \| "1/12" \| "1/2" ...` The CSS `flex-basis` property.
`boundaries`	`1`	`number` Number of elements visible on the left/right edges.
`controlNextProps`	-	`PaginationItemProps` Props for next of the control button element.
`controlPrevProps`	-	`PaginationItemProps` Props for previous of the control button element.
`controlProps`	-	`PaginationItemProps` Props for control button element.
`defaultPage`	`1`	`number` The initial page of the pagination. Should be less than `total` and greater than `1`.
`direction`	-	`"-moz-initial" \| "column-reverse" \| "column" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "row-reverse" \| "row" \| "unset" ...` The CSS `flex-direction` property.
`disabled`	`false`	`boolean` If `true`, all wrapped button will be disabled.
`edgeEndProps`	-	`PaginationItemProps` Props for end of the edge button element.
`edgeProps`	-	`PaginationItemProps` Props for edge button element.
`edgeStartProps`	-	`PaginationItemProps` Props for start of the edge button element.
`ellipsisProps`	-	`PaginationItemProps` Props for ellipsis of the element.
`fullRounded`	`false`	`boolean` If `true`, the button is full rounded. Else, it'll be slightly round.
`grow`	`false`	`boolean` If `true`, the children will grow to fill the available space.
`itemProps`	-	`PaginationItemProps` Props for item of the button element.
`justify`	-	`"-moz-initial" \| "center" \| "end" \| "flex-end" \| "flex-start" \| "inherit" \| "initial" \| "left" \| "normal" \| "revert-layer" ...` The CSS `justify-content` property.
`onChange`	-	`(page: number) => void` The callback invoked when the page changes.
`orientation`	`"horizontal"`	`"horizontal" \| "vertical"` The orientation of the group.
`page`	-	`number` The page of the pagination. Should be less than `total` and greater than `1`.
`shrink`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The CSS `flex-shrink` property.
`siblings`	`1`	`number` Number of siblings displayed on the left/right side of selected page.
`stacking`	-	`"first-on-top" \| "last-on-top"` The stacking order of the group.
`withControls`	`true`	`boolean` If `true`, display the control buttons.
`withEdges`	`false`	`boolean` If `true`, display the edge buttons.
`wrap`	-	`"-moz-initial" \| "inherit" \| "initial" \| "nowrap" \| "revert-layer" \| "revert" \| "unset" \| "wrap-reverse" \| "wrap" ...` The CSS `flex-wrap` property.

Pagination.EndTrigger

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

Pagination.Item

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`size`	-	`"2xl" \| "2xs" \| "lg" \| "md" \| "sm" \| "xl" \| "xs"` The size of the component.
`variant`	-	`"ghost" \| "outline" \| "solid" \| "subtle" \| "surface" ...` The variant of the component.
`active`	`false`	`boolean` If `true`, the button is represented as active.
`disabled`	`false`	`boolean` If `true`, the button is disabled.
`disableRipple`	`false`	`boolean` If `true`, disable ripple effects when pressing a element.
`fullRounded`	`false`	`boolean` If `true`, the button is full rounded. Else, it'll be slightly round.
`icon`	-	`ReactNode` The icon to be used in the button.
`loading`	`false`	`boolean` If `true`, the loading state of the button is represented.
`type`	`"button"`	`"button" \| "reset" \| "submit"` The type of button. Accepts `button`, `reset`, or `submit`.

Pagination.Items

Prop	デフォルト	型 / 説明
`children`	-	`(page: Page) => ReactNode` The function used to generate children. it will be called with page number or `"ellipsis"`.
`render`	-	`(page: Page) => ReactNode` The function used to generate children. it will be called with page number or `"ellipsis"`.

Pagination.NextTrigger

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

Pagination.PrevTrigger

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

Pagination.StartTrigger

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

Pagination.Text

Prop	デフォルト	型 / 説明
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`children`	-	`ReactNodeOrFunction<{ page: number; total: number }>` The children of the text. if function, it will be called with `{ page: number; total: number }`.
`format`	`"compact"`	`"compact" \| "short"` The format of the text.

アクセシビリティ

キー	説明	状態
`Tab`	フォーカスを次のページボタンに移動します。	-
`Shift + Tab`	フォーカスを前のページボタンに移動します。	-
`Enter`, `Space`	フォーカスされたページボタンをアクティブにします。	-

ARIAロールと属性

コンポーネント	ロールと属性	使い方
`Pagination.Root`	`role="navigation"`	ページ間のナビゲーション領域であることを示します。
	`aria-label`	`"ページネーション"`を設定します。
`Pagination.Item`	`aria-label`	ページ番号ボタンの場合は`"{value}ページに移動する"`を設定します。
	`aria-current="page"`	現在のページ番号ボタンに設定します。
	`role="presentation"`	ページ番号ボタンの場合はプレゼンテーションであることを示します。
`Pagination.PrevTrigger`	`aria-label`	`"前のページに移動する"`を設定します。
`Pagination.NextTrigger`	`aria-label`	`"次のページに移動する"`を設定します。
`Pagination.StartTrigger`	`aria-label`	`"最初のページに移動する"`を設定します。
`Pagination.EndTrigger`	`aria-label`	`"最後のページに移動する"`を設定します。