HTMLOutputElement

例項屬性

此介面還繼承了其父級 HTMLElement 的屬性。

HTMLOutputElement.defaultValue

一個字串，表示元素的預設值，初始為空字串。

HTMLOutputElement.form 只讀

一個 HTMLFormElement，表示與控制元件關聯的表單，反映了 form HTML 屬性（如果已定義）。

HTMLOutputElement.htmlFor 只讀

一個 DOMTokenList，反映了 for HTML 屬性，包含文件中其他影響（或以其他方式影響）計算出的 value 的元素的 ID 列表。

HTMLOutputElement.labels 只讀

一個 NodeList，包含與該元素關聯的 <label> 元素。

HTMLOutputElement.name

一個字串，反映 name HTML 屬性，包含提交表單資料時使用的控制元件名稱。

HTMLOutputElement.type 只讀

字串 "output"。

HTMLOutputElement.validationMessage 只讀

一個字串，表示本地化的訊息，描述了控制元件未滿足的驗證約束（如果有）。如果控制元件不是約束驗證的候選者（willValidate 為 false），或者它滿足了其約束，則此字串為空。

HTMLOutputElement.validity 只讀

一個 ValidityState，表示該元素所處的有效性狀態。

HTMLOutputElement.value

一個字串，表示元素內容的“值”。其行為類似於 Node.textContent 屬性。

HTMLOutputElement.willValidate 只讀

返回一個布林值，指示該元素是否是約束驗證的候選者。對於 HTMLOutputElement 物件，此值始終為 false。

例項方法

此介面還繼承了其父級 HTMLElement 的方法。

HTMLOutputElement.checkValidity()

檢查元素的有效性並返回一個包含檢查結果的布林值。

HTMLOutputElement.reportValidity()

此方法向用戶報告元素約束的問題（如果有）。如果存在問題，則在元素上觸發 invalid 事件，並返回 false；如果沒有問題，則返回 true。

當報告問題時，使用者代理可能會將焦點放在元素上，並更改文件的滾動位置，或執行其他將元素引起使用者注意的操作。使用者代理可能會報告多個約束違反，如果該元素同時存在多個問題。如果元素未渲染，使用者代理可能會報告正在執行的指令碼的錯誤，而不是通知使用者。

HTMLOutputElement.setCustomValidity()

為元素設定自定義有效性訊息。如果此訊息不是空字串，則元素存在自定義有效性錯誤，並且不進行驗證。

模式

此元素有兩種模式：“預設”模式和“值”模式。

預設模式

最初，該元素處於預設模式，此時元素的內容既表示元素的值，也表示其預設值。

如果在預設模式下，元素的子孫後代以任何方式發生更改，則 defaultValue 屬性將被設定為 textContent 屬性的值。

重置表單會將元素置於預設模式，並將 textContent 屬性設定為 defaultValue 屬性的值。

值模式

當設定 value 屬性的內容時，該元素進入值模式。value 屬性的行為類似於 textContent 屬性。當元素處於值模式時，只能透過 defaultValue 屬性訪問預設值。

規範

瀏覽器相容性

另見

• 實現此介面的 HTML 元素：<output>。