--- title: slug: Web/HTML/Element/input/submit translation_of: Web/HTML/Element/input/submit ---
{{HTMLRef}}
{{HTMLElement("input")}} 元素的 "submit"
類型會被視為提交按鈕(submit button)——點選的話就能把表單提交到伺服器。
<input type="submit" value="Submit to me">
{{EmbedLiveSample("summary-example2", 650, 30)}}
{{anch("Value")}} | 用作按鈕 label 的 {{domxref("DOMString")}} |
事件 | {{event("click")}} |
常見的支援屬性 | {{htmlattrxref("type", "input")}} 與 {{htmlattrxref("value", "input")}} |
IDL 屬性 | value |
方法 | 無 |
<input type="submit">
元素的 {{htmlattrxref("value", "input")}} 屬性會包含用作按鈕 label 的 {{domxref("DOMString")}}。
<input type="submit" value="Submit to me">
{{EmbedLiveSample("summary-example3", 650, 30)}}
如果不指定 value
,視瀏覽器不同,按鈕會是 Submit/Submit Query/提交 之類的預設值:
<input type="submit">
{{EmbedLiveSample("summary-example1", 650, 30)}}
<input type="submit">
按鈕用於提交表單。如果想自訂按鈕、並透過 JavaScript 自訂其行為,你應該用 <input type="button">
、或更好的,{{htmlelement("button")}} 元素。
請記住,如果表單內只有一個按鈕元素(例如 <button>My button</button>
)的話,瀏覽器會自動把它視為提交按鈕。你要在其他按鈕之外,明確宣告一個提交按鈕。
我們要開始建立一個新的提交按鈕:
<form> <div> <label for="example">Let's submit some text</label> <input id="example" type="text" name="text"> </div> <div> <input type="submit" value="Submit to me"> </div> </form>
它會被渲染為:
{{EmbedLiveSample("A_simple_submit_button", 650, 100)}}
試著在文字區塊內輸入些文字,接著提交表單。
提交時,送到伺服器的成對 name/value 資料會 be along the lines of text=mytext
,視你在文字區塊內輸入了什麼。資料在哪裡並如何被送出,取決於 <form>
屬性和其他細節的設定:請參見傳送表單資料。
鍵盤快捷鍵,又稱熱鍵,能讓用戶透過鍵盤按鍵或組合觸發按鈕事件。要給提交按鈕添加鍵盤快捷鍵——如同 {{HTMLElement("input")}} 那樣——你需要使用全域屬性 {{htmlattrxref("accesskey")}}。
下例之中,s 被指定為快捷鍵(you'll need to press s plus the particular modifier keys for your browser/OS combination; see {{htmlattrxref("accesskey")}} for a useful list of those)。
<form> <div> <label for="example">Let's submit some text</label> <input id="example" type="text" name="text"> </div> <div> <input type="submit" value="Submit to me" accesskey="s"> </div> </form>
{{EmbedLiveSample("Adding_a_submit_keyboard_shortcut", 650, 100)}}
注意:上例的問題很明顯,就是用戶不知道要按什麼快捷鍵!在實際網站中,你要提供不干擾網站整體設計的快捷鍵資訊:像是提供易於訪問的連結,告訴用戶說網站的快捷鍵是什麼。
要禁用提交按鈕,就如同下例般指定全域屬性 {{htmlattrxref("disabled")}}:
<input type="submit" value="Disabled" disabled>
你可以在 run time 時藉由設定 disabled
的 true
or false
來禁用或啟用提交按鈕。在 JavaScript 就看起來像 btn.disabled = true
。
注意:請參見 <input type="button">
頁面以取得關於禁用/啟用提交按鈕的詳細資訊。
注意:Firefox 不若其他瀏覽器,它預設上會在 {{HTMLElement("button")}} 跨網頁加載時保持動態禁用狀態。請用 {{htmlattrxref("autocomplete","button")}} 屬性控制這個功能。
提交按鈕不參與強制驗證:they have no real value to be constrained.
上面已經有一些程式碼了。這裡也沒有什麼還能講的。
規範 | 狀態 |
{{SpecName('HTML WHATWG', 'forms.html#submit-button-state-(type=submit)', '<input type="submit">')}} | {{Spec2('HTML WHATWG')}} |
{{SpecName('HTML5 W3C', 'forms.html#submit-button-state-(type=submit)', '<input type="submit">')}} | {{Spec2('HTML5 W3C')}} |
{{CompatibilityTable}}
功能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
基本支援 | 1.0 | {{CompatGeckoDesktop("1.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | 1.0 |
功能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
基本支援 | {{CompatVersionUnknown}} | {{CompatGeckoMobile("4.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |