HTMLButtonElement

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

HTMLButtonElement 介面提供了用於操作 <button> 元素的屬性和方法(除了它透過繼承從 HTMLElement 介面繼承的常規屬性和方法)。

EventTarget Node Element HTMLElement HTMLButtonElement

例項屬性

繼承自其父級 HTMLElement 的屬性。

HTMLButtonElement.command

一個字串值,指示要在此按鈕所控制的元素上執行的操作。

HTMLButtonElement.commandForElement

指向一個現有 Element 的引用,該元素由此按鈕控制。

HTMLButtonElement.disabled

一個布林值,指示控制元件是否被停用,這意味著它不接受任何點選。

HTMLButtonElement.form 只讀

一個 HTMLFormElement,反映了此按鈕所屬的表單。如果按鈕是表單元素的後代,則此屬性是對該表單的關聯 HTMLFormElement 的引用。如果按鈕不是表單元素的後代,則此屬性可以是同一文件中與其相關的任何 HTMLFormElement 元素的引用,如果沒有匹配項,則為 null 值。

HTMLButtonElement.formAction

一個字串,反映了處理由按鈕提交的資訊的資源的 URI。如果指定了此屬性,它將覆蓋擁有此元素的 <form> 元素的 action 屬性。

HTMLButtonElement.formEnctype

一個字串,反映了用於將表單提交到伺服器的內容型別。如果指定了此屬性,它將覆蓋擁有此元素的 <form> 元素的 enctype 屬性。

HTMLButtonElement.formMethod

一個字串,反映了瀏覽器用於提交表單的 HTTP 方法。如果指定了此屬性,它將覆蓋擁有此元素的 <form> 元素的 method 屬性。

HTMLButtonElement.formNoValidate

一個布林值,指示在提交表單時不對其進行驗證。如果指定了此屬性,它將覆蓋擁有此元素的 <form> 元素的 novalidate 屬性。

HTMLButtonElement.formTarget

一個字串,反映了在提交表單後顯示響應的名稱或關鍵字。如果指定了此屬性,它將覆蓋擁有此元素的 <form> 元素的 target 屬性。

HTMLButtonElement.labels 只讀

一個 NodeList,表示一組 <label> 元素,它們是此按鈕的標籤。

HTMLButtonElement.name

提交表單時物件的名稱。如果指定,則不能為空字串。

HTMLButtonElement.popoverTargetAction

獲取和設定由控制按鈕執行的操作("hide""show""toggle")以控制彈出框元素。它反映了 popovertargetaction HTML 屬性的值。

HTMLButtonElement.popoverTargetElement

獲取和設定要透過按鈕控制的彈出框元素。是 popovertarget HTML 屬性的 JavaScript 等價物。

HTMLButtonElement.type

一個字串,指示按鈕的行為。這是一個列舉屬性,具有以下可能值:

  • submit:按鈕提交表單。如果未指定該屬性,或者將其動態更改為空字串或無效值,則此為預設值。
  • reset:按鈕重置表單。
  • button:按鈕不執行任何操作。
  • menu:按鈕顯示選單。 實驗性
HTMLButtonElement.willValidate 只讀

一個布林值,指示按鈕是否是約束驗證的候選物件。如果任何條件阻止其進行約束驗證,則為 false,包括:其 type 屬性為 resetbutton;它有 <datalist> 祖先;或者 disabled 屬性設定為 true

HTMLButtonElement.validationMessage 只讀

一個字串,表示本地化的訊息,描述控制元件不滿足的驗證約束(如果有)。如果控制元件不是約束驗證的候選物件(willValidatefalse),或者它滿足其約束,則此屬性為空字串。

HTMLButtonElement.validity 只讀

一個 ValidityState,表示此按鈕所處的有效性狀態。

HTMLButtonElement.value

一個字串,表示按鈕的當前表單控制元件值。

例項方法

繼承自其父級 HTMLElement 的方法.

HTMLButtonElement.checkValidity()

如果元素的價值沒有有效性問題,則返回 true;否則返回 false

HTMLButtonElement.reportValidity()

執行與 checkValidity() 相同的操作,但如果 invalid 事件未被取消,還會將結果報告給使用者。

HTMLButtonElement.setCustomValidity()

設定元素的自定義有效性訊息。使用空字串表示該元素*不*具有自定義有效性錯誤。

規範

規範
HTML
# htmlbuttonelement

瀏覽器相容性

另見

  • 實現此介面的 HTML 元素:<button>