.submit()
.submit( handler(eventObject) ) 返回： jQuery
描述L： 為 "submit" 事件綁定一個處理函數(shù)，或者觸發(fā)元素上的 "submit" 事件。
-
version added: 1.0.submit( handler(eventObject) )
handler(eventObject)每次事件觸發(fā)時會執(zhí)行的函數(shù)。
-
version added: 1.4.3.submit( [ eventData ], handler(eventObject) )
eventData將要傳遞給事件處理函數(shù)的數(shù)據(jù)映射。
handler(eventObject)每次事件觸發(fā)時會執(zhí)行的函數(shù)。
version added: 1.0.submit()
這個函數(shù)的第一種用法是 .bind('submit', handler) 的快捷方式，第二種用法是 .trigger('submit') 的快捷方式。
當用戶試圖提交表單時，submit事件將被發(fā)送到一個元素。它只能附加在<form>元素。表單可以通過點擊一個明確的<input type="submit">, <input type="image">, 或者 <button type="submit">，或者當某些表單元素獲取焦點時敲擊Enter（回車鍵），都可以提交。
根據(jù)不同的瀏覽器，如果表單只能有一個文本字段，回車鍵可能只會導致一個表單提交，或僅當有一個當前的提交按鈕。該接口不應該依賴于一個特定的行為，除非這一關鍵問題是通過觀察就按下回車鍵KeyPress事件被迫的。（The interface should not rely on a particular behavior for this key unless the issue is forced by observing the keypress event for presses of the Enter key.）
舉例來說，請看下面的HTML：
<form id="target" action="destination.html"> <input type="text" value="Hello there" /> <input type="submit" value="Go" /> </form> <div id="other"> Trigger the handler </div>
這個事件處理程序可以綁定到表單
$('#target').submit(function() {
alert('Handler for .submit() called.');
return false;
});
現(xiàn)在當表單提交時，警告將被顯示。出現(xiàn)這種情況的實際提交之前，所以我們可以通過調用事件對象的.preventDefault()或在處理函數(shù)中返回 false 來取消提交：
$('#other').click(function() {
$('#target').submit();
});
這些代碼執(zhí)行后，點擊Trigger the handler 同樣會警報顯示。此外，默認的submit表單上的動作上會被觸發(fā)，所以表格將被提交。
JavaScript的submit事件不會在Internet Explorer的泡沫。However, scripts that rely on event delegation with the submit event will work consistently across browsers as of jQuery 1.4, which has normalized the event's behavior.
Additional Notes:
- 表單及他們的子元素不應該使元素名稱或ID屬性沖突，比如
submit,length, 或method。名稱沖突可能會導致混亂的失敗。對于一個完整的規(guī)則列表，并檢查這些問題標記，看DOMLint。
Examples:
Example: If you'd like to prevent forms from being submitted unless a flag variable is set, try:
<!DOCTYPE html>
<html>
<head>
<style>
p { margin:0; color:blue; }
div,p { margin-left:10px; }
span { color:red; }
</style>
<script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
<p>Type 'correct' to validate.</p>
<form action="javascript:alert('success!');">
<div>
<input type="text" />
<input type="submit" />
</div>
</form>
<span></span>
<script>
$("form").submit(function() {
if ($("input:first").val() == "correct") {
$("span").text("Validated...").show();
return true;
}
$("span").text("Not valid!").show().fadeOut(1000);
return false;
});
</script>
</body>
</html>Demo:
Example: If you'd like to prevent forms from being submitted unless a flag variable is set, try:
$("form").submit( function () {
return this.some_flag_variable;
} );Example: To trigger the submit event on the first form on the page, try:
$("form:first").submit();