HTMLInputElement: checked-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die checked-Eigenschaft der HTMLInputElement-Schnittstelle gibt an, ob das Element aktuell ausgewählt ist oder nicht; das heißt, ob das Formularsteuerelement aktiviert ist.

Die boolesche checked-Eigenschaft ist relevant für die Input-Typen radio (<input type="radio">) und checkbox (<input type="checkbox">).

Das Vorhandensein des HTML-Attributes checked zeigt an, dass die Checkbox standardmäßig aktiviert ist. Es gibt jedoch nicht an, ob diese Checkbox momentan aktiviert ist: Wenn der Zustand der Checkbox geändert wird, spiegelt dieses Inhaltsattribut die Änderung nicht wider; nur die HTMLInputElement-Eigenschaft checked wird aktualisiert. Das checked-Attribut wird durch die defaultChecked-Eigenschaft reflektiert.

Wenn eine radio-Input-Eigenschaft checked true ist, sind alle anderen Radio-Inputs mit demselben name false. Sollte ein Radiobutton in einer gleichnamigen Gruppe von Radiobuttons required sein, muss mindestens ein Button in der Gruppe checked sein, damit die schreibgeschützte valueMissing-Eigenschaft des ValidityState-Objekts für jeden Radiobutton in der Gruppe false ist.

Ein Checkbox-Wert wird nur bei der Formularübermittlung in die übermittelten Daten aufgenommen, wenn checked wahr ist. Der Wert der HTMLInputElement.indeterminate-Eigenschaft hat keinen Einfluss auf den checked-Wert einer Checkbox.

Wert

Ein boolescher Wert.

Beispiele

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

Spezifikationen

Specification
HTML
# dom-input-checked

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch