HTMLInputElement: 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 July 2015.

The HTMLInputElement.labels read-only property returns a NodeList of the <label> elements associated with the <input> element, if the element is not hidden. If the element has the type hidden, the property returns null.

Value

A NodeList containing the <label> elements associated with the <input> element.

Examples

HTML

html
<label id="label1" for="test">Label 1</label>
<input id="test" />
<label id="label2" for="test">Label 2</label>

JavaScript

js
window.addEventListener("DOMContentLoaded", () => {
  const input = document.getElementById("test");
  for (const label of input.labels) {
    console.log(label.textContent); // "Label 1" and "Label 2"
  }
});

Specifications

Specification
HTML Standard
# dom-lfe-labels-dev

Browser compatibility

BCD tables only load in the browser