<input type="number">
<input>
要素の number
型は、ユーザーに数値を入力させるために使用されます。数値以外の入力を除外するための値検証機能を内蔵しています。ブラウザーによっては、マウスや指先のタップを使用して値をユーザーが値を増減させるための矢印を提供していることもあります。
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
number
型に対応していないブラウザーでは、 number
入力欄は text
入力欄で代替されます。
値 | 数字を表す Number 、または空欄 |
イベント | change および input |
対応している共通属性 | autocomplete , list , placeholder , readonly |
IDL 属性 | list , value , valueAsNumber |
メソッド | select() , stepUp() , stepDown() |
値
入力欄に入力された数字の値を表す Number
です。 value
属性に数値を設定することで、次のように入力欄の既定値を設定することができます。
<input id="number" type="number" value="42">
追加の属性
すべての <input>
型で共通する属性に加え、 number
型の入力欄は次の属性にも対応しています。
属性 | 説明 |
---|---|
list |
任意の定義済み自動補完の選択肢を保持する <datalist> 要素の id です。 |
max |
この入力欄で受け付ける最大値 |
min |
この入力欄で受け付ける最小値 |
placeholder |
入力欄の中が空の時に表示される入力例の値 |
readonly |
論理値で、値が読み取り専用であるかを示す |
step |
上下の矢印で値を調整する時や、検証に使用する刻み値 |
{{page("/ja/docs/Web/HTML/Element/input/text", "list", 0, 1, 2)}}
max
この入力欄が受け付ける最大値です。要素に入力された value
がこれを超えた場合、要素は制約検証に失敗します。 max
属性の値が数値でない場合、要素は最大値を持ちません。
この値は min
属性の値より大きいか、等しくしなければなりません。
min
この入力欄が受け付ける最小値です。要素の value
がこれより小さい場合、要素は制約検証に失敗します。 min
属性の値が数値でない場合、要素は最小値を持ちません。
この値は max
属性の値より小さいか、等しくしなければなりません。
{{page("/ja/docs/Web/HTML/Element/input/text", "placeholder", 0, 1, 2)}}
{{page("/ja/docs/Web/HTML/Element/input/text", "readonly", 0, 1, 2)}}
step
step
属性は値が吸着する粒度を指定する数値、または後述する特殊な値 any
です。刻みの基準値に等しい値 (指定されていれば min
、そうでなければ value
、どちらも設定されていなければ適切な既定値) のみが妥当となります。
文字列値の any
は刻みがなく、どの値でも許可されることを意味します (min
や max
など、他の制約に制限されます)。
注: ユーザーがデータを入力したときには刻みの設定には吸着せず、ユーザーエージェントは直近の妥当な値、同じ距離の値の選択肢が二つあった場合は、正の方向の推奨値に丸められます。
number
入力欄の既定の刻み値は 1
であり、刻みの基準値が整数ではない場合を除いて、整数の入力のみを許可します。
number 入力欄の使用
<input type="number">
要素は、フォームに数値を入力するユーザーインターフェイスとロジックを構築する際に、作業を簡略化するのに役立ちます。 type
の値に正しく number
を設定して数値入力を作成すると、入力された文字列が数値かどうかが自動的に検証されるようになり、通常は値を1つずつ上下するための上下ボタンの組み合わせが表示されます。
重要: 論理的には、数値入力欄の中に数字以外を入力することはできないはずです。これらは、ブラウザー間でこれに関するいくつかの意見の相違があるようです。 バグ 1398528 を参照してください。
注: ユーザーが HTML をその場面の裏でいじることができることを意識しておくことは極めて重要です。ですから、安全を目的として、サイトでクライアント側の値検証機能のみを使用してはいけません。何らかのセキュリティ上の問題を含む可能性がある値が提供されるトランザクションの場合は、いずれもサーバー側で値検証を行う必要があります。
モバイルブラウザーでは、ユーザーが値を入力しようとした時に、数値入力に適した特別なキーボードを表示することで、使い勝手をさらに向上させます。次のスクリーンショットは、 Android の Firefox で撮影されたものです。
単純な数値入力
最も基本的なフォームでは、次のように数値入力を実装することができます。
<label for="ticketNum">購入するチケットの枚数:</label>
<input id="ticketNum" type="number" name="ticketNum" value="0">
数値入力は空の場合と単一の数値が入力された場合に妥当とみなされますが、それ以下は無効とみなされます。 required
属性が使用された場合は、入力欄が空の場合に妥当とみなされなくなります。
プレイスホルダー
フォームがどのような入力データを取るのかについての行内のヒントを提供すると、有益なことがあります。これはページのデザインでそれぞれの <input>
に説明のラベルを付けることができない場合に特に重要になります。ここでプレイスホルダーが登場します。プレイスホルダーはほとんどの場合、入力される value
が取るべき値の形式のヒントを説明するために使用される値です。これは value
が ""
の時に入力欄の中に表示されます。入力欄にデータが入力されると、プレイスホルダーは非表示になり、入力欄が空欄になると、プレイスホルダーは再度表示されます。
ここで、 number
入力欄に "10の倍数
" というプレイスホルダーを設定します。なお、プレイスホルダーが非表示になったり再表示されたりするのは、入力欄の中身を変更したときです。
<input type="number" placeholder="10の倍数">
刻み幅の制御
既定で、数値を増減させるための増減ボタンは、1刻みで値を増減させます。 step
属性を設定することで、刻みの量を指定する数値の値を変更できます。上記の例は10の倍数を指定すると言っていますので、 step
の値を 10
にすることが妥当でしょう。
<input type="number" placeholder="multiple of 10" step="10">
この例で、増減ボタンが値を1ずつではなく10ずつ増減させることが分かるでしょう。手動で10の倍数ではない数値を入力することができますが、無効な値とみなされるでしょう。
最小値と最大値の指定
min
及び max
属性を使用して、入力欄が保持できる最小値と最大値を指定することができます。例えば、最小値を 0
に、最大値を 100
に設定する例をご紹介しましょう。
<input type="number" placeholder="multiple of 10" step="10" min="0" max="100">
更新したこの版では、増減ボタンで0未満や100より大きい数値を設定することができないことにお気づきでしょう。手動でこの範囲の外の値を入力することもできますが、無効な値とみなされるでしょう。
小数が使用できるようにする
数値入力の問題の一つが、既定で刻みが1になっていることです。小数を含む数値 (たとえば "1.0") を入力しようとすると、無効な値とみなされるでしょう。小数が必要な値を入力させたい場合は、これを step
の値に反映させる必要があります(例えば step="0.01"
で小数第2位まで許可します)。単純な例を示します。
<input type="number" placeholder="1.0" step="0.01" min="0" max="10">
この例では 0.0
から 10.0
までで、小数第2位までの値が許容されます。この例では "9.52" は妥当になりますが、 "9.521" は妥当ではありません。
入力欄の寸法の制御
number
型の <input>
要素では、 size
のような寸法を決める属性には対応していません。入力欄の寸法を変更するには CSS に頼る必要があります。
例えば、入力欄の幅を数字3桁の入力に必要なだけの幅に調整するには、 HTML に id
を設定し、これから入力欄を短くしたときに文字列が表示できなくならないように、プレイスホルダーを短縮します。
<input type="number" placeholder="x10" step="10" min="0" max="100" id="number">
それから、要素の id
が #number
である要素の幅を短くします。
#number {
width: 3em;
}
結果は以下のように表示されます。
サジェスト値の提供
list
属性に、サジェスト値あたり一つの <option>
要素を含んだ <datalist>
の id
を値として入れることにより、ユーザーの選択することができる既定の選択肢のリストを提供することができます。それぞれの option
の value
は、数値入力ボックスのサジェスト値に関係します。
<input id="ticketNum" type="number" name="ticketNum" list="defaultNumbers">
<span class="validity"></span>
<datalist id="defaultNumbers">
<option value="10045678">
<option value="103421">
<option value="11111111">
<option value="12345678">
<option value="12999922">
</datalist>
number
入力欄での list
属性の使用はすべてのブラウザーで対応しているわけではありません。例えば Chrome や Opera では動作しますが、 Firefox では動作しません。
検証
すでに number
入力欄における幾つかの検証機能については言及しましたが、ここで確認してみましょう。
<input type="number">
要素は、数値 (またはrequired
が指定されていない場合は空欄) ではない入力を自動的に違反とします。required
属性を使用すると、空欄の入力を違反とします。 (つまり、入力欄は埋める必要があります。)step
属性を使用すると、妥当な値を特定の刻みの値 (例えば、10の倍数) に制約することができます。min
およびmax
属性を使用すると、妥当な値の下限と上限を設けることができます。
次の例は上記の機能のすべてを例示しており、また幾らか CSS を用いて、 input
の値によって、妥当または違反のアイコンを表示するようにします。
<form>
<div>
<label for="balloons">風船の注文数 (10の倍数):</label>
<input id="balloons" type="number" name="balloons" step="10" min="0" max="100" required>
<span class="validity"></span>
</div>
<div>
<input type="submit">
</div>
</form>
様々な違反する値を入力して、フォームを送信しようとしてみてください。例えば、値なし、0未満または100を超えた値、10の倍数ではない値、数値でない値などです。そして、それぞれにおいてブラウザーがどのようなエラーメッセージを表示するかを確認してください。
この例で適用される CSS は以下の通りです。
div {
margin-bottom: 10px;
}
input:invalid+span:after {
content: '✖';
padding-left: 5px;
}
input:valid+span:after {
content: '✓';
padding-left: 5px;
}
ここで、 :invalid
および :valid
擬似クラスを用いて、隣の <span>
要素の生成コンテンツとして無効または妥当の適切なアイコンを表示し、妥当性の視覚的なインジケーターにすることができます。
別な <span>
要素に入れたのは自由度を高めるためです。ブラウザーによっては一部の種類のフォーム入力欄において、あまり効果的に生成コンテンツを表示できないことがあります (<input type="date">
の検証の節の例を読んでください)。
重要: HTML のフォーム検証は、入力されたデータが正しい形式であることを保証するサーバースクリプトの代用にはなりません。
HTML を調整して検証をくぐり抜けたり、完全に削除したりすることはとても簡単にできます。 HTML をバイパスし、サーバーに直接データを送信することも可能です。
サーバー側のコードが受信したデータの検証に失敗した場合、不適切な形式のデータ (または大きすぎるデータ、間違った種類のデータなど) がデータベースに入力された場合に災害が発生するおそれがあります。
パターンによる値検証
<input type="number">
要素は pattern
属性を使用して、入力された値が特定の正規表現パターンを満たすようにすることに対応していません。
これは、 number 入力欄は数値以外の何が入力されても妥当にはならないからであり、上記で説明したとおり、 min
および max
属性を用いて妥当な数値の最大値および最小値を制約することができます。
例
すでに既定では増分が 1
であるという事実を扱いましたので、 step
属性を使用して実数を入力できるようにすることができます。もう少し詳しく見てみましょう。
以下の例は、ユーザーの身長を入力するフォームです。既定では慎重をメートル単位で受け付けますが、関連するボタンをクリックすることでフォームがフィートとインチを受け付けるように変更することができます。メートル単位の身長の入力欄は小数第2位まで受け付けます。
HTML は次のようになります。
<form>
<div class="metersInputGroup">
<label for="meters">あなたの身長を入力してください (メートル):</label>
<input id="meters" type="number" name="meters" step="0.01" min="0" placeholder="例 1.78" required>
<span class="validity"></span>
</div>
<span>あなたの身長を入力してください — </span>
<label for="feet">フィート:</label>
<input id="feet" type="number" name="feet" min="0" step="1">
<span class="validity"></span>
<label for="inches">インチ:</label>
<input id="inches" type="number" name="inches" min="0" max="11" step="1">
<span class="validity"></span>
</div>
<div>
<input type="button" class="meters" value="身長をフィートとインチで入力">
</div>
<div>
<input type="submit" value="フォームを送信">
</div>
</form>
これまでの記事ですでに見てきた属性の多くを使用していることがわかります。センチメートル単位のメートル値を受け入れるため、 step
の値を 0.01
に設定して、 1.78 のような値が無効とされないようにしました。また、その入力欄のプレイスホルダーも提供しました。
最初はフィートとインチの入力欄を class="hidden"
を使用して非表示にしているため、既定はメートルでの入力です。
次に、 CSS に進みます。これは、以前に見た検証のスタイル付けととても良く似ています。ここで注目するところはありません。
div {
margin-bottom: 10px;
position: relative;
}
input[type="number"] {
width: 100px;
}
input + span {
padding-right: 30px;
}
input:invalid+span:after {
position: absolute;
content: '✖';
padding-left: 5px;
}
input:valid+span:after {
position: absolute;
content: '✓';
padding-left: 5px;
}
そして最後に、 JavaScript です。
let metersInputGroup = document.querySelector('.metersInputGroup');
let feetInputGroup = document.querySelector('.feetInputGroup');
let metersInput = document.querySelector('#meters');
let feetInput = document.querySelector('#feet');
let inchesInput = document.querySelector('#inches');
let switchBtn = document.querySelector('input[type="button"]');
switchBtn.addEventListener('click', function() {
if(switchBtn.getAttribute('class') === 'meters') {
switchBtn.setAttribute('class', 'feet');
switchBtn.value = '身長をメートルで入力';
metersInputGroup.style.display = 'none';
feetInputGroup.style.display = 'block';
feetInput.setAttribute('required', '');
inchesInput.setAttribute('required', '');
metersInput.removeAttribute('required');
metersInput.value = '';
} else {
switchBtn.setAttribute('class', 'meters');
switchBtn.value = '身長をフィートとインチで入力';
metersInputGroup.style.display = 'block';
feetInputGroup.style.display = 'none';
feetInput.removeAttribute('required');
inchesInput.removeAttribute('required');
metersInput.setAttribute('required', '');
feetInput.value = '';
inchesInput.value = '';
}
});
いくつかの変数を宣言した後、イベントリスナーを button
に追加し、切り替えの仕組みを制御しています。これはとても単純で、ほとんどがボタンの class
と <label>
を変更するためのものであり、そしてボタンが押されたときに2組の入力の display 値を更新しています。
(なお、ここではメートルとフィート/インチの間の変換は行っていませんが、実際のウェブアプリケーションではおそらく行うでしょう。)
注: ユーザーがボタンをクリックしたとき、 required
属性を非表示にする入力欄から削除し、 value
属性を空にしています。これは入力欄の両方の組が入力されていなくてもフォームを送信することができるようにしています。これはユーザーが意図していないデータをフォームが送信しないことを保証するものでもあります。
これを行わないと、フィート/インチとメートルの両方を入力してフォームを送信することができてしまいます。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard <input type="number"> の定義 |
現行の標準 | 初回定義 |
HTML 5.1 <input type="number"> の定義 |
勧告 | 初回定義 |
ブラウザーの互換性
BCD tables only load in the browser