このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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
# dom-elementinternals-labels

ブラウザーの互換性