Reactで、日付の入力欄のカレンダーをボタンから開く方法
予約フォームや申し込みフォームの日付の入力欄に「カレンダーを開く」ボタンを付けると、押したときにブラウザの日付ピッカー(カレンダー)を出せます。使うのは、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 で受け取ります。
// 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>
);
}
// 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>
);
}
ボタンを押すと、入力欄の真下にピッカーが開きました。入力欄の右端のカレンダーのアイコンを押したときに開くものと同じピッカーです。

ピッカーが開いた後も、フォーカスはボタンに残っていました。それでも、矢印キーで日を動かして Enter を押すと日付が入ります。右矢印を2回押して Enter を押すと、ピッカーが閉じて入力欄が 2026/11/12 になり、onChange で state が更新されて「選んだ日:2026-11-12」と表示されました。ピッカーで選んだ日付も、手で打った日付と同じく onChange で受け取れます。
入力欄の文字をクリックしても、カレンダーは開かない
Chromium の日付の入力欄は、右端のカレンダーのアイコンを押すとピッカーが開きます。年・月・日の文字の部分をクリックしたときは、年の部分が選択された状態になるだけで、ピッカーは開きませんでした。この状態で上矢印キーを押すと、年が1つ増えて 2027-11-10 になりました。
入力欄のどこを押してもカレンダーを開きたいときは、入力欄自身の onClick でも showPicker() を呼びます。上のコンポーネントなら、ボタンと同じ openPicker を渡せば、try...catch もそのまま使えます。
<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 になります。メッセージは次のとおりでした。
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 のときのメッセージは、どちらも同じでした。
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 ではなく、ボタンの近くに残しておきます。

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 に入ります。





