ElementInternals: labels-Eigenschaft

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die schreibgeschützte labels-Eigenschaft der ElementInternals-Schnittstelle gibt die mit dem Element verknüpften Labels zurück.

Wert

Ein NodeList, das alle mit diesem Element verknüpften label-Elemente enthält.

Beispiele

Das folgende Beispiel zeigt eine benutzerdefinierte Checkbox-Komponente mit einem <label>-Element, das mit ihr verknüpft ist. Das Drucken des Wertes von labels auf die Konsole gibt ein NodeList mit einem Eintrag zurück, der dieses Label repräsentiert.

html
<form id="myForm">
  <custom-checkbox id="custom-checkbox"></custom-checkbox>
  <label for="custom-checkbox">Join newsletter</label>
</form>
js
let element = document.getElementById("custom-checkbox");
console.log(element.internals_.label);

Spezifikationen

Specification
HTML Standard
# dom-elementinternals-labels

Browser-Kompatibilität

BCD tables only load in the browser