Reactで、日付の入力欄のカレンダーをボタンから開く方法

​​React​HTML,TypeScript,フォーム

予約フォームや申し込みフォームの日付の入力欄に「カレンダーを開く」ボタンを付けると、押したときにブラウザの日付ピッカー(カレンダー)を出せます。使うのは、input 要素の showPicker() です。React では、useRef で入力欄を参照し、ボタンの onClick の中から呼びます。

<input type="date"> に「カレンダーを開く」ボタンを付けた DateField というコンポーネントを作り、ピッカーが開く条件と、開かないときに出るエラーを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。使ったのは React 19.3.1、TypeScript 7.0.2、esbuild 0.28.2、Playwright 1.63.0 です。ブラウザは Playwright が起動した Chromium 153 で、日本語の設定(--lang=ja-JP)にしてヘッドレスで動かしました。ピッカーが開いたかどうかは、スクリーンショットで確かめています。ページは http://localhost:5173/ から配信しました。Firefox、Safari、Edge、スマートフォンのブラウザは試していません。

使えるブラウザ

MDN の互換性データでは、showPicker() は Chrome と Edge が99、Firefox が101、Safari が16から対応しています。ただし、type="date" の入力欄で使えるのは Safari では17.4からで、iOS の Safari は対応していません。

TypeScript では、型を書き足す必要はありません。TypeScript 7.0.2 の DOM の型定義(lib.dom.d.ts)には、HTMLInputElement の showPicker(): void がありました。

ボタンから showPicker() を呼ぶコンポーネント

入力欄を useRef で参照し、ボタンの onClick で showPicker() を呼びます。値は親から value と onChange で受け取ります。

tsx
// src/DateField.tsx
import { useId, useRef } from 'react';

type Props = {
  label: string;
  value: string;
  onChange: (value: string) => void;
};

export function DateField({ label, value, onChange }: Props) {
  const id = useId();
  const inputRef = useRef<HTMLInputElement>(null);

  function openPicker() {
    const input = inputRef.current;
    if (!input) return;
    try {
      // クリックの処理の中で、そのまま呼ぶ
      input.showPicker();
    } catch (e) {
      // 使えないブラウザや、呼べない状態のときは、入力欄にフォーカスだけ移す
      console.warn(e);
      input.focus();
    }
  }

  return (
    <p>
      <label htmlFor={id}>{label}</label>{' '}
      <input
        id={id}
        ref={inputRef}
        type="date"
        value={value}
        onChange={(e) => onChange(e.target.value)}
      />{' '}
      <button type="button" onClick={openPicker}>
        カレンダーを開く
      </button>
    </p>
  );
}
tsx
// src/App.tsx
import { useState } from 'react';
import { DateField } from './DateField';

export function App() {
  const [date, setDate] = useState('2026-11-10');
  return (
    <main>
      <DateField label="予約日" value={date} onChange={setDate} />
      <p>選んだ日:<output id="result">{date || '(未選択)'}</output></p>
    </main>
  );
}

ボタンを押すと、入力欄の真下にピッカーが開きました。入力欄の右端のカレンダーのアイコンを押したときに開くものと同じピッカーです。

「予約日」の入力欄の真下に、2026年11月のカレンダーが開いている。10日が選ばれていて、下に「削除」と「今日」がある
「カレンダーを開く」ボタンを押したところ(Chromium 153、日本語の設定)

ピッカーが開いた後も、フォーカスはボタンに残っていました。それでも、矢印キーで日を動かして Enter を押すと日付が入ります。右矢印を2回押して Enter を押すと、ピッカーが閉じて入力欄が 2026/11/12 になり、onChange で state が更新されて「選んだ日:2026-11-12」と表示されました。ピッカーで選んだ日付も、手で打った日付と同じく onChange で受け取れます。

入力欄の文字をクリックしても、カレンダーは開かない

Chromium の日付の入力欄は、右端のカレンダーのアイコンを押すとピッカーが開きます。年・月・日の文字の部分をクリックしたときは、年の部分が選択された状態になるだけで、ピッカーは開きませんでした。この状態で上矢印キーを押すと、年が1つ増えて 2027-11-10 になりました。

入力欄のどこを押してもカレンダーを開きたいときは、入力欄自身の onClick でも showPicker() を呼びます。上のコンポーネントなら、ボタンと同じ openPicker を渡せば、try...catch もそのまま使えます。

tsx
<input
  id={id}
  ref={inputRef}
  type="date"
  value={value}
  onChange={(e) => onChange(e.target.value)}
  onClick={openPicker}
/>

DateField の入力欄にこの onClick を足して試したところ、年の部分をクリックしても、アイコンをクリックしても、ピッカーが開きました。ピッカーを Escape で閉じてから「2027」と打つと、値は 2027-11-10 になり、「選んだ日:2027-11-10」と表示されました。

エラーになる条件

showPicker() は、条件に合わないと例外を投げます(MDN の showPicker() のページにある例外の一覧)。検証用のページで、呼ぶタイミングや入力欄の状態を変えて試しました。

試したこと 結果
ボタンのクリックで呼ぶ ピッカーが開いた
useEffect で、ページを開いたときに呼ぶ NotAllowedError
readOnly の入力欄で呼ぶ InvalidStateError
disabled の入力欄で呼ぶ InvalidStateError
1回のクリックの中で2回続けて呼ぶ 1回目は開き、2回目は NotAllowedError
クリックしてから1秒待って呼ぶ ピッカーが開いた
クリックしてから6秒待って呼ぶ NotAllowedError
同じオリジンの iframe の中で呼ぶ iframe の入力欄の真下にピッカーが開いた
別のオリジンの iframe の中で呼ぶ SecurityError

ユーザーの操作なしに呼ぶと NotAllowedError になります。メッセージは次のとおりでした。

text
NotAllowedError: Failed to execute 'showPicker' on 'HTMLInputElement': HTMLInputElement::showPicker() requires a user gesture.

showPicker() を呼ぶには、クリックなどの直後の状態(transient activation)が必要です。この状態は時間がたつと切れます(MDN の transient activation の説明)。HTML の仕様の注記では、この時間は長くても数秒程度とされています。検証でも、1秒後には開けましたが、6秒後には切れていました。また、HTML の仕様では、ピッカーを出すときにこの状態を使い切ります。1回のクリックの中で2回続けて呼ぶと、2回目が失敗したのはこのためです。ボタンを押したらデータを取ってきてから開く、という順にはせず、クリックの処理の中で先に呼ぶようにします。

注意

「手で打たせず、カレンダーからだけ選ばせたい」と考えて readOnly を付けると、ボタンからもピッカーを開けなくなります。

readOnly と disabled のときのメッセージは、どちらも同じでした。

text
InvalidStateError: Failed to execute 'showPicker' on 'HTMLInputElement': HTMLInputElement::showPicker() cannot be used on immutable controls.

別のオリジンの iframe(http://localhost:5173/ のページに埋め込んだ http://127.0.0.1:5174/ のページ)では、SecurityError になりました。仕様では、ファイルと色の入力欄だけはこの制限の対象外です。

入力欄を display: none で隠すと、カレンダーが離れた所に出る

カレンダーのアイコンのボタンだけを見せて、入力欄そのものは隠したいことがあります。入力欄に display: none を付けても showPicker() はエラーにならず、ピッカーは開きました。ただ、開いた場所はページの左上の角で、ボタンの近くではありませんでした。

入力欄を消さずに、opacity: 0、幅と高さ 1px にしてボタンの左に残すと、ピッカーはボタンのすぐ下、入力欄を置いた位置の下に開きました。入力欄を見えなくするときは、display: none ではなく、ボタンの近くに残しておきます。

上の画面では、入力欄を display: none にしたため、カレンダーがページの左上の角に開いてボタンに重なっている。下の画面では、入力欄を透明・1px にして残したため、カレンダーがボタンのすぐ下に開いている
ボタンの位置は同じ。上は入力欄を display: none にした場合、下は透明・1px にして残した場合

showPicker() がないブラウザへの備え

使えるかどうかは、'showPicker' in HTMLInputElement.prototype で調べられます(MDN にある、使えるかどうかを調べる例)。上のコンポーネントでは、調べる代わりに try...catch で囲み、失敗したら入力欄にフォーカスを移しています。

Chromium で HTMLInputElement.prototype.showPicker をページの読み込み前に消して試しました。'showPicker' in HTMLInputElement.prototype は false になり、ボタンを押すと TypeError: input.showPicker is not a function が catch に入りました。ピッカーは開かず、入力欄の年の部分が選択された状態になりました。続けて上矢印キーを押すと、値は 2027-11-10 になりました。readOnly などで InvalidStateError になったときも、同じ catch に入ります。

​Posted by 86