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.

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

値

この要素に関連付けられたすべてのラベル要素の入った 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