Reactで、数値の入力欄を空にできるstateの持ち方

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

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、スマートフォンのキーボードでの入力は試していません。

2つの数値の入力欄を縦に並べた画面。どちらも 3 が入っている。上は「数値の state(Number() で変換)」の欄で、クリックして Backspace を押すと、欄の文字と「state の値」がピンクで強調されて 0 になる。続けて 5 を押すと欄は 05、state の値は 5 になる。下は「文字列の state(そのまま持つ)」の欄で、Backspace を押すと欄は空になり、state の値は "" になる。続けて 5 を押すと欄は 5、state の値は "5" になる。画面の上の帯に「上の欄:キー 2回目/6回」のように何回目の操作かと、押したキーが出る
上の欄と下の欄で、それぞれクリック、Backspace、5 の順に操作する様子。上の欄は 0 が戻って 05 になる

Number() で数値にすると、消した欄に 0 が戻る

state を数値で持つと、次のような書き方になります。

tsx
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 と区別できます。

tsx
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 で表す書き方もあります。

tsx
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 で読みます。

tsx
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 に戻りました。

​Posted by 86