HOWTO · JavaScript

JavaScript でフォームの送信を防ぐ方法

submit イベントリスナー、インライン onsubmit ハンドラー、または jQuery を使用して、クライアント側の検証が失敗したときにフォームが送信されないようにします。

このページの内容

データがクライアント側の検証に合格しないときにフォームが送信されないようにするには、フォームの submit イベントを処理し、チェックが失敗したときにのみ event.preventDefault() を呼び出します。リスナーは送信ボタンではなくフォームにアタッチしてください。フォームの submit イベントはキーボードによる送信もカバーします。データが有効な場合は、デフォルトのアクションをそのままにして、ブラウザがフォームを送信できるようにします。

submit イベントリスナーでフォームの送信を防ぐ

submit リスナーは、新しい JavaScript コードで通常選択される方法です。この自己完結型の Node.js の例は、ブラウザのフォームが使用するイベントインターフェースをモデル化し、有効なメールアドレスが通常の送信パスに到達する様子を示しています。ページでは、同じハンドラーを form.addEventListener('submit', handleSubmit) で登録します。

const form = {
  listener: null,
  addEventListener(type, callback) {
    if (type === 'submit') this.listener = callback;
  },
  submit(event) {
    this.listener(event);
    return !event.defaultPrevented;
  }
};

const email = 'reader@example.com';
const handleSubmit = (event) => {
  if (!email.includes('@')) event.preventDefault();
};

form.addEventListener('submit', handleSubmit);
const event = {
  defaultPrevented: false,
  preventDefault() {
    this.defaultPrevented = true;
  }
};
console.log(form.submit(event) ? 'Form may submit' : 'Submission prevented');

この例の小さなフォームオブジェクトにより、ハンドラーを Node.js で実行できます。ブラウザでは、ブラウザがフォームとイベントを提供します。ページでは、ハンドラー内で関連するコントロールを読み取り、チェックが失敗したときに event.preventDefault() を呼び出します。これを呼び出すとブラウザのデフォルトの送信アクションがキャンセルされます。他のページへ移動したり、履歴を戻ったりすることはありません。送信ボタンのクリックとフォームコントロールでの Enter キーの押下は、どちらもフォームの submit イベントにつながります。

インライン onsubmit ハンドラーを使用する

インラインの onsubmit ハンドラーは、既存のマークアップに対する代替手段です。たとえば、<form onsubmit="return validateForm()"> は、フォームが送信されたときに関数を呼び出します。検証が失敗した場合は false を返して送信をキャンセルし、フォームが送信できる状態の場合は true を返します。関数をページで利用できるようにしておき、すべてのパスで値を返すようにしてください。新しいコードでは、リスナーを使うことで通常は動作を HTML から分離できます。

jQuery で送信を防ぐ

プロジェクトですでに jQuery を使用している場合は、$('#myForm').on('submit', function (event) { ... }) でフォームにハンドラーをアタッチします。コールバック内でフォームの値をチェックし、検証が失敗したときにのみ event.preventDefault() を呼び出します。送信を防ぐためにハンドラーから $('#myForm').submit() を呼び出さないでください。それはブラウザのデフォルトアクションをキャンセルするのではなく、送信動作を引き起こします。jQuery は任意です。ネイティブの addEventListener が依存関係なしに同じフォームイベントを提供します。

入力を検証してフィードバックを提供する

チェックが失敗したら、送信を防ぎ、注意が必要なフィールドの横に簡潔なメッセージを表示します。そのメッセージをコントロールに関連付け、エラーを支援技術に公開し、適切な場合は修正が必要な最初のフィールドにフォーカスを移動します。唯一のフィードバックとしてアラートに頼るのは避けてください。すべてのチェックに合格したら、送信を続行させ、サーバー側でも受信したデータを検証させます。クライアント側のチェックは操作性を向上させますが、それだけでデータを保護できるわけではありません。

required、type="email"、minlength などの HTML 制約は、フォームに合う場合に使用します。ブラウザは通常の submit イベントが送信される前にこれらの失敗を報告できます。カスタムチェックでは、HTML 制約では表現できないルールを追加できます。ユーザーが入力を修正するための明確な手段は依然として必要なので、検証の代わりに送信ボタンを無効化しないでください。