JavaScriptで入力を確認する

JavaScriptを使うと、送信ボタンが押されたときに入力内容を確認し、問題があれば送信を止めてメッセージを表示できます。

まずこれだけ

submitイベントで入力内容を確認し、問題があればpreventDefaultで送信を止めます。サーバー側の確認も欠かせません。

送信前にJavaScriptで内容を確認する

HTMLの属性でも簡単な入力チェックはできますが、確認できる内容やメッセージの表示方法には限りがあります。JavaScriptを使うと、独自の条件で確認し、分かりやすい場所にメッセージを出せます。

基本の流れは、送信の直前に入力内容を調べ、問題があれば送信を止める、というものです。

簡単にいうと

送信ボタンが押された時点で内容を調べ、問題があれば送信を止めます。

確認処理の流れ

送信前の確認は、次の順番で処理します。

検知
フォームが送信されようとしたことを受け取る
取得
確認したい入力欄の値を取り出す
判定
値が条件に合っているかを調べる
対応
問題があれば送信を止めてメッセージを表示する

submitイベントで送信を受け取る

確認処理は、formの "submit" イベントに登録します。フォームが送信される直前に、このイベントが発生します。

ボタンのクリックではなくformの送信に処理を付けるのが要点です。入力欄でEnterキーを押して送信した場合も、同じ確認が働きます。

formは querySelector などで取得し、addEventListener で処理を登録します。イベント処理の基本は「クリックなどのイベント処理」で扱っています。

入力欄の値を取り出して調べる

入力された内容は、入力欄の要素の value で取り出せます。値は常に文字列として取得されます。

空欄かどうかを調べるときは、value.trim() で前後の空白を取り除いてから確認します。空白だけが入力された場合も、空欄として扱えます。

確認用にメールアドレスを2回入力させるフォームでは、2つの欄の値を比べ、一致しなければ問題ありと判定します。

問題があれば送信を止める

問題が見つかった場合は、イベントの preventDefault() を呼び出します。これで、ブラウザが本来行う送信が取り消されます。

問題がなければ何もしません。処理が終わると、そのまま通常どおりフォームが送信されます。

メッセージを入力欄の近くに表示する

エラーの内容は、該当する入力欄のすぐ近くに表示します。あらかじめ空の要素を置いておき、textContent でメッセージを書き込む方法が簡単です。

「メールアドレスが一致しません」のように、何をどう直せばよいかが分かる文にします。再度送信するときは、前回のメッセージを消してから確認し直します。

エラーが複数ある場合は、最初の問題がある入力欄の要素で focus() を呼び出します。カーソルがその欄に移動し、利用者はすぐに修正を始められます。

ブラウザの確認と組み合わせる

requiredなどの属性を書いたフォームでは、ブラウザの確認が先に働きます。JavaScriptの処理は、ブラウザの確認を通過した後に実行されます。

メッセージの表示をJavaScriptにそろえたい場合は、formに novalidate を書いてブラウザの確認を止めます。この場合は、必須の確認なども含めてすべてJavaScriptで行う必要があります。

送信ボタンの二度押しを防ぐ

確認を通過したら、送信ボタンを押せない状態にすると、二度押しによる重複送信を防げます。ボタンの要素に disabled = true を設定します。

この処理は、確認で問題がなかった場合だけ行います。問題があるときにボタンを止めると、修正しても送信できなくなります。

JavaScriptの確認だけに頼らない

JavaScriptによる確認は、利用者が入力ミスに早く気づくための仕組みです。JavaScriptを無効にしたり、送信内容を直接作ったりすれば、確認を通らずに送信できます。

そのため、送信先のサーバー側でも必ず同じ確認を行います。

まとめ

formのsubmitイベントで入力内容を調べ、問題があればpreventDefaultで送信を止めます。メッセージは入力欄の近くに具体的に表示します。JavaScriptの確認は補助と考え、サーバー側でも確認します。