2024年07月02日

jquery:submit()


このメソッドの説明

submit() はjQueryメソッドです。

プログラムでフォームをサブミットさせます。

 


メソッド

$('form').submit()

 


パラメータ

ありません

 


戻り値

ありません

 


このメソッドを使うケースとは

一般的には、フォームの「onclick属性」でエラーチェックを行いますが、ECプログラムのカスタマイズ等では、これが既に利用されているケースがあります。

例えば下記の様な場合です。

<form method='post' action='' onsubmit='XXXXXX()'><!-- ユーザがカスタマイズできないonsumitが設定されている -->
  <!-- 色々な処理 -->
 <button type='submit' class='real' name='button' value='select' >送信</button>
</form>

1行目:ユーザがカスタマイズできない onsubmit属性 が設定されている。

3行目:ボタンのタイプは 'submit' になっている。

 

上記の様な場合、ユーザがボタン操作を検知してエラー処理するプログラムを作成しても、このフォームのサブミットを中止させる事ができません。

この様な場合は下記の方法でユーザプログラムを作成します。

①ボタンのType属性を submitbutton 変更する。

②ボタンの挿入を検知し、エラー処理をするプログラムを作成する。

③エラーがない場合は、submit()メソッドで、フォームをサブミットする。

 

click()メソッドでも上記と同じ対策に利用できます。

 


利用例

1.プログラムでフォームをサブミットさせる。

セレクト操作を行ってください。

・サイズを選択しないで購入ボタンを挿入すると、エラーメッセージを表示します。

・サイズを選択して購入ボタンを挿入すると(エラーなし)、onsubmit処理が実行された後、サブミットされます。

・リセットボタンを挿入すると、選択を解除します。





 

上記のプログラムは下記から構成されています。

<?php 
	if($_POST['select_name'] != ''){
		$item = $_POST['select_name'];
		$item = preg_replace('/1/','項目1',$item);	// 文字を正規表現で探して置き換える
		$item = preg_replace('/2/','項目2',$item);
		$item = preg_replace('/3/','項目3',$item);
		$select_msg = '選択値は『'.$item.'』です。';
	}
?>
<form method='post' action=''  onsubmit='DB_update()'>
	<label for='select'>選択して下さい<span style='font-size:12px;'> ※必須項目</span></label><br>
	<select id='select' name='select_name'> 
		<option value='#none#'>選択してください</option> 
		<option value='1' <?php if($_POST['select_name']=='1')esc_html_e('selected');?>>項目1</option> 
		<option value='2' <?php if($_POST['select_name']=='2')esc_html_e('selected');?>>項目2</option> 
		<option value='3' <?php if($_POST['select_name']=='3')esc_html_e('selected');?>>項目3</option> 
	</select>
	<br><br>
	<button type='button' class='real'  name='button'	value='select' >送信</button><!-- ボタンタイプをsubmitからbuttonに変更 -->
	<button type='button' class='reset'>リセット</button><br>
	<p class='msg01' style='color:red;'><?php esc_html_e($select_msg);?></p>
</form>
<script>
	function DB_update(){  // onsubmitのダミープログラム
		window.alert('『購入DB』を更新します。');
	}
	$('.real').click(function(){
		var my_select = $('[name="select_name"]').val();
		if(my_select == '#none#'){
			window.alert('オプションが選択されておりません');
			$('.msg01').css('display','none')
		}else{
			$('form').submit(); // フォームをプログラムでサブミットする
		}
	});
	$('.reset').click(function(){
		$('[name="select_name"]').prop('selectedIndex', 0);
		$('.msg01').css('display','none');
	});
</script>

■1~9行目:PHP部分

フォームの送信先(action='')は自分のプログラムなので、$_POST['select_name'] に値がある時だけ、選択されたvale値をテキスト値に置き換えて表示する処理をしています。

■10~22行目:HTML部分

19行目のボタンをtype='button'に変更し、ボタンが挿入されてもサブミットしないボタンに変更します

■23行目~:スクリプト部分

24行目~26行目:onsubmitのダミープログラムを作成しています。

27行目以降

・ボタンがクリックされた時にエラーチェックを行い、エラーがない時はプログラムでフォームをサブミットしています

・リセットボタンが挿入された時は、選択値をクリアしています。

 

 .submit()メソッドの制限

.submit()は、フォームをサブミットするメソッドです。

よって、ボタンに設定されているname属性値はサーバに送られません。

もしボタンのname属性値も渡したい場合は click()メソッド を利用します。

 


参考情報

その他の 操作系メソッド も参照してください。

 


関数一覧
  • 1.JavaScript/jQueryとは
  • 2.[JS] 変数規則と文字連結
  • 3.[JS] if文
  • 4.[JS] 配列操作
  • 5.[JS] 文字列操作
  • 6.[JS] 画面情報&操作
  • 7.[JS] Timer処理
  • console.log()
  • for
  • for in
  • for of
  • indexOf()
  • join()
  • length
  • map()
  • match()
  • Object.keys()
  • Object.values()
  • parseInt()
  • pop()
  • push()
  • replace()
  • shift()
  • slice()
  • split()
  • toString()
  • unshift()
  • 1.jQueryの導入と記述の基本
  • 2.jQueryの機能追加
  • 3.jQuery文法
  • 4.階層構造の要素セレクトと操作
  • 5.要素サイズ取得メソッド
  • animate()
  • append()
  • attr()
  • change(func)
  • click()
  • click(func)
  • css()
  • each(func)
  • effect()
  • empty()
  • fadeTo()
  • get()
  • hover(f1,f2)
  • html()
  • map(func)
  • mousedown(func)
  • prop()
  • resize(func)
  • show()、hide()
  • slideToggle()
  • submit()
  • submit(func)
  • text()
  • toggle()
  • toggleClass()
  • val()