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