ElementInternals: labels プロパティ

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.

labelsElementInternals インターフェイスのプロパティで、要素に関連付けられたラベルを返します。

この要素に関連付けられたすべてのラベル要素の入った NodeList です。

次の例は、カスタムチェックボックスコンポーネントに <label> 要素をリンクしたものです。 labels の値をコンソールに出力すると、このラベルを表す1つのエントリーを持つ NodeList が返されます。

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);

仕様書

Specification
HTML Standard
# dom-elementinternals-labels

ブラウザーの互換性

BCD tables only load in the browser