The labels
read-only property of the ElementInternals
interface returns the labels associated with the element.
ElementInternals: labels property
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.
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 Standard # dom-elementinternals-labels |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | ||
labels |
77 | 79 | 98 | 64 | 16.4 | 77 | 98 | 55 | 16.4 | 12.0 | 77 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels