外観

サイズ

4つの組み込みサイズ: small、medium、large、x-large。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";
import type { DatePickerSize } from "react-date-range-picker-headless";

const sizes: DatePickerSize[] = ["small", "medium", "large", "x-large"];

function Sizes() {
  const [values, setValues] = useState<Record<DatePickerSize, Date | null>>({
    small: null,
    medium: null,
    large: null,
    "x-large": null,
  });

  return (
    <div style={{ display: "flex", flexDirection: "column", gap: 20 }}>
      {sizes.map((size) => (
        <div key={size} style={{ display: "flex", alignItems: "center", gap: 12 }}>
          <span style={{ width: 60, fontSize: 13, fontWeight: 600, opacity: 0.5, flexShrink: 0 }}>
            {size}
          </span>
          <DatePicker
            value={values[size]}
            onChange={(date) => setValues((prev) => ({ ...prev, [size]: date }))}
            size={size}
          />
        </div>
      ))}
    </div>
  );
}

small

medium

large

x-large

カスタムフォーマット

表示フォーマット文字列をカスタマイズします。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";

function CustomFormat() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} displayFormat="YYYY/MM/DD" />;
}

カスタムロケール

headlessパッケージのcreateLocaleを使用して、国際化のためのカスタムロケールを提供します。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";
import { createLocale } from "react-date-range-picker-headless";

const koLocale = createLocale("ko-KR", {
  confirm: "확인",
  cancel: "취소",
  clear: "초기화",
  today: "오늘",
  placeholder: "날짜 선택",
});

function CustomLocale() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} locale={koLocale} weekStartsOn="monday" />;
}

週の始まり

週の最初の曜日を変更します。デフォルトは"sunday"です。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";

function WeekStartsOn() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} weekStartsOn="monday" />;
}

月外の日付を表示

カレンダーグリッドを埋めるために、隣接する月の日付を表示します。デフォルトはfalseです。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";

function ShowOutsideDays() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} showOutsideDays />;
}

キャプションのドロップダウン

captionLayout="dropdown"を使用して、月/年のナビゲーションを矢印からドロップダウンに切り替えます。fromYearとtoYearを使用して年の範囲を設定します。

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind3";

function CaptionDropdown() {
  const [value, setValue] = useState<Date | null>(null);

  return (
    <DatePicker
      value={value}
      onChange={setValue}
      captionLayout="dropdown"
      fromYear={2020}
      toYear={2030}
    />
  );
}