Reactで、数値の入力欄を空にできるstateの持ち方
React で <input type="number"> の値を useState(0) で持ち、onChange で Number(e.target.value) を state に入れると、欄を空にできません。Backspace で消しても 0 が戻り、続けて「5」と打つと「05」になります。state を文字列のまま持ち、使うときに数値にすると、欄を空にできます。個数や年齢を入れるフォームで、0 と「まだ入れていない」を分けたいときに使えます。
検証環境は Ubuntu 24.04、Node.js 22.23.4、React 19.3.1(開発用ビルド)、TypeScript 7.0.2、Playwright 1.63.0、Chromium 153 です。キー操作は Playwright で Chromium を動かして行いました。Firefox と Safari、スマートフォンのキーボードでの入力は試していません。

Number() で数値にすると、消した欄に 0 が戻る
state を数値で持つと、次のような書き方になります。
import { useState } from 'react';
export function ZeroDefault() {
const [count, setCount] = useState(0);
return (
<input
type="number"
value={count}
onChange={(e) => setCount(Number(e.target.value))}
/>
);
}
欄を空にすると、e.target.value は空文字 '' になります。Number('') は 0 なので、state は 0 のままです。React は欄の表示を state に合わせるため、欄にも 0 が戻ります。
検証環境で、欄の中身を全部選んでから打ったときの結果は次のとおりです。
| 打ったもの | 欄の表示 | state |
|---|---|---|
| 「3」のあと Backspace | 0 |
0 |
| Backspace のあと「5」 | 05 |
5 |
| 「-3」 | 03 |
3 |
| 「1e3」 | 03 |
3 |
欄を選んで「-」から打つと、その時点で 0 に戻されるので、マイナスの数を打てません。「1e3」のような指数の書き方も、「e」を打った時点で 0 に戻されます。
Number() の代わりに parseInt(e.target.value, 10) を使うと、空の欄は NaN になります。このとき欄は空になりますが、開発用ビルドの React はコンソールに「Received NaN for the value attribute」というエラーを出しました。「1.50」と打つと、欄は「10」になりました。
state は文字列で持ち、使うときに数値にする
欄を空にできるようにするには、state を文字列で持ちます。数値が必要なところでは、その都度 Number() で変換します。空文字のときは null にしておくと、0 と区別できます。
import { useState } from 'react';
export function StringState() {
const [text, setText] = useState('');
const count = text === '' ? null : Number(text);
return (
<input
type="number"
value={text}
onChange={(e) => setText(e.target.value)}
/>
);
}
React の公式リファレンスにある、state 変数で入力欄を制御する例も、type="number" の欄の値を useState('') の文字列で持ち、Number(age) で数値にしています。
この書き方では、「3」と打ってから Backspace で消すと欄が空になり、count は null になりました。「5」と打つと count は 5、「-3」は -3、「1.50」は 1.5、「1e3」は 1000 です。欄にも、打ったとおりの文字が残りました。
数値のまま持ちたいときは、空を null にする
state を number | null にして、空の欄を null で表す書き方もあります。
import { useState } from 'react';
export function NullableNumber() {
const [count, setCount] = useState<number | null>(null);
return (
<input
type="number"
value={count ?? ''}
onChange={(e) =>
setCount(e.target.value === '' ? null : e.target.valueAsNumber)
}
/>
);
}
value には null をそのまま渡さず、?? '' で空文字にします。公式リファレンスにも、制御された入力欄に渡す value は undefined や null であってはならないと書かれています。リファレンスのトラブルシューティングには、value={someValue ?? ''} と書く例があります。
valueAsNumber は、欄の値を数値で返すプロパティです。MDN の valueAsNumber のページのとおり、数値にできないときは NaN を返すので、空文字のときは先に null にしています。
検証環境では、この書き方でも文字列で持つ書き方と同じ結果になりました。「1.50」と打っても、state は 1.5 で、欄は「1.50」のまま書き換わりませんでした。
「-」や「1e」の打ちかけでは、value が空文字になる
文字列で持つ書き方でも、空の欄と区別できない入力があります。「-」だけや「1e」まで打ったところのような、数として読めない打ちかけの状態です。
HTML の仕様では、数値の入力欄の value は、空文字か、正しい浮動小数点数の文字列にしかなりません。数に変換できない入力が欄にあるときは「suffering from bad input」の状態になり、validity.badInput が true になります(MDN の badInput のページ)。
検証環境で「-」や「1e」を打つと、欄には打った文字が見えたまま、value は空文字でした。badInput は true です。文字列で持つ書き方では、state も空文字になり、count は null でした。欄には「1e」と表示されているのに、プログラムからは空の欄と区別できません。
空と読めない入力を分けるなら、onInput で badInput を読む
「未入力」と「入力が正しくない」を分けたいときは、validity.badInput も state に持ちます。ただし、badInput を onChange で読むと、空の欄に「-」を打ったときに取りこぼします。
検証環境で、onChange と onInput に渡した関数が呼ばれた回数を数えたところ、空の欄に「-」を打っても onChange は呼ばれず、onInput だけが呼ばれました。「-」を消したときも同じです。どちらも value は空文字のまま変わっていません。一方、「1」のあとに「e」を打つと value が '1' から '' に変わるので、onChange も呼ばれます。
react-dom のコードも、input と change のイベントで欄の value を前回の値と比べ、違うときだけ onChange を呼ぶ作りになっていました。
そこで、badInput は onInput で読みます。
import { useState } from 'react';
type Amount =
| { kind: 'empty' }
| { kind: 'invalid' }
| { kind: 'number'; value: number };
export function BadInputOnInput() {
const [text, setText] = useState('');
const [badInput, setBadInput] = useState(false);
const amount: Amount = badInput
? { kind: 'invalid' }
: text === ''
? { kind: 'empty' }
: { kind: 'number', value: Number(text) };
return (
<input
type="number"
value={text}
onChange={(e) => setText(e.target.value)}
onInput={(e) => setBadInput(e.currentTarget.validity.badInput)}
/>
);
}
badInput を onChange で読んだ場合と、onInput で読んだ場合の結果は次のとおりです。
| 空の欄に打ったもの | onChange で読んだ場合 | onInput で読んだ場合 |
|---|---|---|
| 「-」 | empty |
invalid |
| 「-」のあと Backspace | empty |
empty |
| 「-3」 | number(-3) |
number(-3) |
| 「1e」 | invalid |
invalid |
| 「1e」のあと Backspace | number(1) |
number(1) |
onInput で読むと、「-」だけの状態も invalid になり、消せば empty に戻りました。





