submitメソッド
submitメソッドを使用すると、JavaScriptの
イベントsubmitを操作できます。このメソッドにより、
JavaScriptイベントsubmitにハンドラをバインドしたり、
要素上でこのイベントを発生させたりすることが可能になります。
構文
このメソッドに関数ハンドラを渡すことができます。 ハンドラはイベントが発生するたびに実行され、 その中にはイベントオブジェクトが渡される可能性があります:
.submit(ハンドラ関数);
この場合、このメソッドはメソッドonの
構文.on('submit', handler)と同様に機能します。
また、オプションのパラメータとして、イベントハンドラ関数に 渡されるデータを持つオブジェクトをメソッドに渡すこともできます:
.submit([イベントデータ], ハンドラ関数);
あるいは、パラメータを一切渡さないこともでき、その場合、
このメソッドはメソッドtriggerの
.trigger('submit')と同様に機能します:
.submit();
submitイベントは、例えばユーザーがフォーム上の
ボタン'submit'を押したときに要素上で発生します。
このイベントは、formタグの要素にのみアタッチできます。
submitイベントは、例えばユーザーがフォーム上の
ボタン'submit'を押したときに要素上で発生します。
このイベントは、formタグの要素にのみアタッチできます。
例
次の例には、submitメソッドを使用してイベントハンドラを
バインドする単純なフォームがあり、テキストフィールドと
タイプsubmitの入力ボタンがあります。
テキストフィールドにテキストを入力し、ボタンをクリックしたときに
そのテキストを確認してみましょう。'jQuery'と入力した場合、
textメソッドと
showメソッドを使用して
スパンに'Good!'というテキストを表示します。
それ以外の場合は'Bad...'を表示します:
<p>jQuery</p>
<form action="/">
<div>
<input type="text">
<input type="submit">
</div>
</form>
<span></span>
$('form').submit(function(event) {
event.preventDefault();
if ($('input').first().val() === 'jQuery') {
$('span').text('Good!').show();
return;
}
$('span').text('Bad...').show();
});