HTMLInputElement: checked 屬性

Baseline 已廣泛支援

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

HTMLInputElement 介面的 checked 屬性指定了元素的當前選中狀態;也就是說,表單控制元件是否被選中。

布林型 checked 屬性與 radio<input type="radio">)和 checkbox<input type="checkbox">)輸入型別相關。

HTML checked 屬性的存在表示複選框預設是選中的。它不指示當前複選框是否被選中:如果複選框的狀態發生變化,此內容屬性不會反映此變化;只有 HTMLInputElementchecked IDL 屬性會被更新。checked 屬性由 defaultChecked 屬性反映。

當一個單選按鈕的 checked 屬性為 true 時,所有具有相同 name 的其他單選按鈕的該屬性均為 false。如果同一組單選按鈕中的任何一個被 required,只要組內有一個按鈕被 checked,組內每個單選按鈕的 ValidityState 物件的只讀 valueMissing 屬性將為 false

在表單提交時,只有當 checked 為 true 時,複選框的值才會被包含在提交的資料中。HTMLInputElement.indeterminate 屬性的值對複選框的 checked 值沒有影響。

布林值。

示例

js
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;

規範

規範
HTML
# dom-input-checked

瀏覽器相容性

另見