コンポーネント一覧へ戻る
月送りページャー React コンポーネント

これは何か

前後の矢印の間に「November 2026」と月が並ぶ、白い pill 型の月送りです。月を送ると、月名が進む向きへ横に滑って入れ替わります。上限と下限ではボタンが薄くなります。範囲と言語を差し替えて、カレンダーや請求履歴、レポートの上部にそのまま置けます。

TSX の全文です。アカウントは不要です。

month-pager.tsx

"use client"; import * as React from "react";import { ChevronLeft, ChevronRight } from "lucide-react";import { cn } from "@/lib/utils"; /** A calendar month. `month` is 1–12. */export type MonthPagerValue = { year: number; month: number }; export type MonthPagerProps = Omit<  React.ComponentPropsWithoutRef<"div">,  "onChange" | "defaultValue"> & {  value?: MonthPagerValue;  /** Defaults to the current month. */  defaultValue?: MonthPagerValue;  onValueChange?: (value: MonthPagerValue) => void;  min?: MonthPagerValue;  max?: MonthPagerValue;  /** BCP 47 locale for the month name, e.g. "en-US" or "ja-JP". */  locale?: string;  previousLabel?: string;  nextLabel?: string;  /** Accessible name for the month readout. */  ariaLabel?: string;}; const CSS = `@keyframes month-pager-in-next { from { transform: translateX(70%); opacity: 0; filter: blur(3px); } to { transform: translateX(0); opacity: 1; filter: blur(0); } }@keyframes month-pager-in-prev { from { transform: translateX(-70%); opacity: 0; filter: blur(3px); } to { transform: translateX(0); opacity: 1; filter: blur(0); } }@keyframes month-pager-out-next { from { transform: translateX(0); opacity: 1; } to { transform: translateX(-70%); opacity: 0; filter: blur(3px); } }@keyframes month-pager-out-prev { from { transform: translateX(0); opacity: 1; } to { transform: translateX(70%); opacity: 0; filter: blur(3px); } }.month-pager-label { grid-area: 1 / 1; white-space: nowrap; animation-duration: 420ms; animation-timing-function: cubic-bezier(0.22, 1, 0.36, 1); animation-fill-mode: both; }@media (prefers-reduced-motion: reduce) {  .month-pager-label { animation: none !important; }  .month-pager-label[data-leaving] { display: none; }}`; const toIndex = (v: MonthPagerValue) => v.year * 12 + (v.month - 1);const fromIndex = (i: number): MonthPagerValue => ({  year: Math.floor(i / 12),  month: (((i % 12) + 12) % 12) + 1,}); function thisMonth(): MonthPagerValue {  const now = new Date();  return { year: now.getFullYear(), month: now.getMonth() + 1 };} export const MonthPager = React.forwardRef<HTMLDivElement, MonthPagerProps>(  (    {      value,      defaultValue,      onValueChange,      min,      max,      locale = "en-US",      previousLabel = "Previous month",      nextLabel = "Next month",      ariaLabel = "Month",      className,      ...props    },    ref,  ) => {    const minIndex = min ? toIndex(min) : Number.NEGATIVE_INFINITY;    const maxIndex = max ? toIndex(max) : Number.POSITIVE_INFINITY;    const clamp = (i: number) => Math.min(maxIndex, Math.max(minIndex, i));     const [own, setOwn] = React.useState(() => toIndex(defaultValue ?? thisMonth()));    const current = clamp(value ? toIndex(value) : own);     const format = React.useMemo(      () => new Intl.DateTimeFormat(locale, { month: "long", year: "numeric", timeZone: "UTC" }),      [locale],    );    const labelOf = (i: number) => {      const { year, month } = fromIndex(i);      return format.format(new Date(Date.UTC(year, month - 1, 1)));    };     // Keep the outgoing label for one swap so both slide on the same frame.    const [reel, setReel] = React.useState<{      index: number;      prev: number | null;      direction: "next" | "prev";      key: number;    }>({ index: current, prev: null, direction: "next", key: 0 });    if (reel.index !== current) {      setReel({        index: current,        prev: reel.index,        direction: current > reel.index ? "next" : "prev",        key: reel.key + 1,      });    }     const commit = (next: number) => {      const bounded = clamp(next);      if (bounded === current) return;      if (value === undefined) setOwn(bounded);      onValueChange?.(fromIndex(bounded));    };     const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {      const map: Record<string, number | undefined> = {        ArrowLeft: current - 1,        ArrowDown: current - 1,        ArrowRight: current + 1,        ArrowUp: current + 1,        PageDown: current - 12,        PageUp: current + 12,        Home: Number.isFinite(minIndex) ? minIndex : undefined,        End: Number.isFinite(maxIndex) ? maxIndex : undefined,      };      const next = map[event.key];      if (next === undefined) return;      event.preventDefault();      commit(next);    };     const atMin = current <= minIndex;    const atMax = current >= maxIndex;    const buttonClass = cn(      "grid size-10 shrink-0 cursor-pointer place-items-center rounded-full border-0 bg-zinc-100 text-zinc-900",      "transition-[background-color,transform,opacity] duration-300 motion-reduce:transition-none",      "hover:bg-zinc-200 active:scale-90 motion-reduce:active:scale-100",      "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-zinc-900/35 focus-visible:ring-offset-2",      "disabled:cursor-not-allowed disabled:opacity-35 disabled:hover:bg-zinc-100 disabled:active:scale-100",    );    const currentLabel = labelOf(current);     return (      <div        ref={ref}        data-tsuna-id="month-pager"        className={cn(          "inline-flex items-center gap-1 rounded-full bg-white p-[6px]",          "shadow-[0_18px_40px_-18px_rgba(15,23,42,0.28),0_4px_12px_-8px_rgba(15,23,42,0.14)]",          className,        )}        {...props}      >        <style>{CSS}</style>        <button          type="button"          className={buttonClass}          onClick={() => commit(current - 1)}          disabled={atMin}          aria-label={previousLabel}          tabIndex={-1}        >          <ChevronLeft className="size-[18px]" strokeWidth={2.4} aria-hidden />        </button>        <div          role="spinbutton"          tabIndex={0}          aria-label={ariaLabel}          aria-valuenow={current}          aria-valuetext={currentLabel}          aria-valuemin={Number.isFinite(minIndex) ? minIndex : undefined}          aria-valuemax={Number.isFinite(maxIndex) ? maxIndex : undefined}          onKeyDown={onKeyDown}          className={cn(            "grid h-10 min-w-[9.75rem] place-items-center overflow-hidden rounded-xl px-3",            "text-[15px] leading-none font-semibold tracking-[-0.015em] text-zinc-950",            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-zinc-900/35",          )}        >          {reel.prev !== null ? (            <span              key={`out-${reel.key}`}              aria-hidden              data-leaving=""              className="month-pager-label"              style={{ animationName: `month-pager-out-${reel.direction}` }}              onAnimationEnd={() => {                const done = reel.key;                setReel((cur) => (cur.key === done ? { ...cur, prev: null } : cur));              }}            >              {labelOf(reel.prev)}            </span>          ) : null}          <span            key={`in-${reel.key}`}            className="month-pager-label"            suppressHydrationWarning            style={              reel.key > 0 ? { animationName: `month-pager-in-${reel.direction}` } : undefined            }          >            {currentLabel}          </span>        </div>        <button          type="button"          className={buttonClass}          onClick={() => commit(current + 1)}          disabled={atMax}          aria-label={nextLabel}          tabIndex={-1}        >          <ChevronRight className="size-[18px]" strokeWidth={2.4} aria-hidden />        </button>      </div>    );  },); MonthPager.displayName = "MonthPager";
コンポーネント

月送りページャー

前後の矢印の間に「November 2026」と月が並ぶ、白い pill 型の月送りです。月を送ると、月名が進む向きへ横に滑って入れ替わります。上限と下限ではボタンが薄くなります。範囲と言語を差し替えて、カレンダーや請求履歴、レポートの上部にそのまま置けます。

ライブプレビュー

Verified Technical Spec

アニメーション
CSS / Tailwind
Reduced motion
確認済み
キーボードフォーカス
確認済み
対応環境
Tailwind CSS v3.4 + v4 · React 19 / Next.js 15 App Router + Vite / Remix 対応

含まれるもの

  • ソースを Cursor / Claude に渡してエージェントに組み込める
  • React · TypeScript · Tailwind CSS · Lucide の完成 UI

依存パッケージ

  • React 19.0.0
  • Typescript 5.7.2
  • Tailwindcss 3.4.16
  • Lucide-react 1.23.0

技術スタック

  • React
  • TypeScript
  • Tailwind CSS
  • Lucide

バージョン 1.0.0