行為

選擇後關閉

啟用 shouldCloseOnSelect 後，點擊預設選項時，選擇器會自動確認並關閉。

ℹ️ Info

對於啟用時間功能的選擇器，shouldCloseOnSelect 僅適用於點擊預設選項 — 而非點擊日期，因為使用者仍需設定時間。

import { useState } from "react";
import { DateRangeTimePicker } from "react-date-range-picker-tailwind4";

function ShouldCloseOnSelect() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  return (
    <DateRangeTimePicker
      value={value}
      onChange={setValue}
      shouldCloseOnSelect
      time={{ minuteStep: 5 }}
    />
  );
}

多月份顯示

並排顯示超過預設的兩個月份。

import { useState } from "react";
import { DateRangeTimePicker } from "react-date-range-picker-tailwind4";

function MultiMonth() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  return (
    <DateRangeTimePicker
      value={value}
      onChange={setValue}
      numberOfMonths={3}
      time={{ minuteStep: 5 }}
    />
  );
}

表單整合

使用 name 屬性來包含隱藏的 input 欄位，以進行原生表單提交。

💡 Tip

此範例中的提交按鈕樣式是自訂的 — 本函式庫僅提供日期選擇器。

import { type SubmitEvent, useState } from "react";
import { DateRangeTimePicker } from "react-date-range-picker-tailwind4";

function FormIntegration() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  const handleSubmit = (e: SubmitEvent<HTMLFormElement>) => {
    e.preventDefault();
    const formData = new FormData(e.currentTarget);
    const start = formData.get("booking");
    const end = formData.get("booking-end");
    alert(
      `Submitted range: ${typeof start === "string" ? start : ""} ~ ${typeof end === "string" ? end : ""}`,
    );
  };

  return (
    <form onSubmit={handleSubmit} style={{ display: "flex", alignItems: "center", gap: 8 }}>
      <DateRangeTimePicker
        value={value}
        onChange={setValue}
        name="booking"
        time={{ minuteStep: 5 }}
      />
      <button
        type="submit"
        style={{
          padding: "6px 14px",
          border: "1px solid #d1d5db",
          borderRadius: 6,
          background: "#3b82f6",
          color: "#fff",
          cursor: "pointer",
          fontSize: 13,
        }}
      >
        Submit
      </button>
    </form>
  );
}