HTMLButtonElement
Baseline 廣泛可用 *
HTMLButtonElement 介面提供了用於操作 <button> 元素的屬性和方法(除了它透過繼承從 HTMLElement 介面繼承的常規屬性和方法)。
例項屬性
繼承自其父級 HTMLElement 的屬性。
-
一個字串值,指示要在此按鈕所控制的元素上執行的操作。
-
指向一個現有
Element的引用,該元素由此按鈕控制。 -
一個布林值,指示控制元件是否被停用,這意味著它不接受任何點選。
-
一個
HTMLFormElement,反映了此按鈕所屬的表單。如果按鈕是表單元素的後代,則此屬性是對該表單的關聯HTMLFormElement的引用。如果按鈕不是表單元素的後代,則此屬性可以是同一文件中與其相關的任何HTMLFormElement元素的引用,如果沒有匹配項,則為null值。 -
一個字串,反映了處理由按鈕提交的資訊的資源的 URI。如果指定了此屬性,它將覆蓋擁有此元素的
<form>元素的action屬性。 -
一個字串,反映了用於將表單提交到伺服器的內容型別。如果指定了此屬性,它將覆蓋擁有此元素的
<form>元素的enctype屬性。 -
一個字串,反映了瀏覽器用於提交表單的 HTTP 方法。如果指定了此屬性,它將覆蓋擁有此元素的
<form>元素的method屬性。 -
一個布林值,指示在提交表單時不對其進行驗證。如果指定了此屬性,它將覆蓋擁有此元素的
<form>元素的novalidate屬性。 -
一個字串,反映了在提交表單後顯示響應的名稱或關鍵字。如果指定了此屬性,它將覆蓋擁有此元素的
<form>元素的target屬性。 -
提交表單時物件的名稱。如果指定,則不能為空字串。
-
獲取和設定由控制按鈕執行的操作(
"hide"、"show"或"toggle")以控制彈出框元素。它反映了popovertargetactionHTML 屬性的值。 -
獲取和設定要透過按鈕控制的彈出框元素。是
popovertargetHTML 屬性的 JavaScript 等價物。 -
一個字串,指示按鈕的行為。這是一個列舉屬性,具有以下可能值:
submit:按鈕提交表單。如果未指定該屬性,或者將其動態更改為空字串或無效值,則此為預設值。reset:按鈕重置表單。button:按鈕不執行任何操作。menu:按鈕顯示選單。 實驗性
-
一個布林值,指示按鈕是否是約束驗證的候選物件。如果任何條件阻止其進行約束驗證,則為
false,包括:其type屬性為reset或button;它有<datalist>祖先;或者disabled屬性設定為true。 -
一個字串,表示本地化的訊息,描述控制元件不滿足的驗證約束(如果有)。如果控制元件不是約束驗證的候選物件(
willValidate為false),或者它滿足其約束,則此屬性為空字串。 -
一個
ValidityState,表示此按鈕所處的有效性狀態。 -
一個字串,表示按鈕的當前表單控制元件值。
例項方法
繼承自其父級 HTMLElement 的方法.
-
如果元素的價值沒有有效性問題,則返回
true;否則返回false。 -
執行與
checkValidity()相同的操作,但如果invalid事件未被取消,還會將結果報告給使用者。 -
設定元素的自定義有效性訊息。使用空字串表示該元素*不*具有自定義有效性錯誤。
規範
| 規範 |
|---|
| HTML # htmlbuttonelement |
瀏覽器相容性
載入中…
另見
- 實現此介面的 HTML 元素:
<button>