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 des HTMLInputElement-Interfaces gibt an, ob das Element aktuell ausgewählt ist oder nicht; das heißt, ob das Formularelement markiert ist oder nicht.
Die boolesche checked-Eigenschaft ist für die radio (<input type="radio">) und checkbox (<input type="checkbox">) Eingabetypen relevant.
Die Anwesenheit des HTML-Attributs checked zeigt an, dass das Kontrollkästchen standardmäßig aktiviert ist. Es zeigt nicht an, ob dieses Kontrollkästchen derzeit aktiviert ist: Wenn der Zustand des Kontrollkästchens geändert wird, spiegelt dieses Inhaltsattribut die Änderung nicht wider; nur die checked IDL-Eigenschaft des HTMLInputElement wird aktualisiert. Das checked-Attribut wird durch die defaultChecked-Eigenschaft widergespiegelt.
Wenn die checked-Eigenschaft eines Radioinputs true ist, sind alle anderen Radioinputs mit demselben name false. Wenn irgendein Radiobutton in einer Gruppe von Radiobuttons mit demselben Namen required ist, wird solange ein Button in der Gruppe checked ist, die schreibgeschützte valueMissing-Eigenschaft des ValidityState-Objekts für jeden Radiobutton in der Gruppe false sein.
Der Wert eines Kontrollkästchens wird nur in den übermittelten Daten bei der Formularübermittlung aufgenommen, wenn checked wahr ist. Der Wert der HTMLInputElement.indeterminate-Eigenschaft hat keinen Einfluss auf den checked-Wert eines Kontrollkästchens.
Wert
Ein boolescher Wert.
Beispiele
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;
Spezifikationen
| Specification |
|---|
| HTML # dom-input-checked |
Browser-Kompatibilität
Siehe auch
<input>HTMLInputElement.validity:checkedPseudoklasse