ElementInternals: labels property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
The labels read-only property of the ElementInternals interface returns the labels associated with the element.
Value
A NodeList containing all of the label elements associated with this element.
Examples
The following example shows a custom checkbox component with a <label> element linked to it.
Printing the value of labels to the console returns a NodeList with one entry, representing this label.
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);
Specifications
| Specification |
|---|
| HTML # dom-elementinternals-labels |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
labels
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support