ElementInternals: setFormValue() 方法

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來,它已在各種瀏覽器中可用。

ElementInternals 介面的 setFormValue() 方法設定元素的提交值和狀態,將這些資訊傳達給使用者代理。

語法

js
setFormValue(value)
setFormValue(value, state)

引數

value

要提交給伺服器的值,可以是 File、字串或 FormData

state 可選

代表使用者輸入的 File、字串或 FormData。這使得應用程式可以在需要時,以使用者提交的格式重新顯示使用者提交的資訊。

注意: 通常,state 用於傳遞使用者指定的資訊,而 value 適用於(經過清理後)提交給伺服器。例如,如果一個自定義元素要求使用者輸入日期,使用者可能會輸入“3/15/2019”。這就是 state。伺服器期望的日期格式是 2019-03-15,此格式的日期將作為 value 傳遞。

返回值

Undefined。

異常

NotSupportedError DOMException

如果元素沒有將其 formAssociated 屬性設定為 true,則丟擲此異常。

示例

在以下示例中,一個複選框自定義元素將 on 設定為傳送到伺服器的值,將 checked 設定為狀態。

js
this.internals_.setFormValue("on", "checked");

規範

規範
HTML
# dom-elementinternals-setformvalue

瀏覽器相容性