From 35c09065825eccdf0fcade81b0b38dd994744a9c Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 18 Jan 2022 21:26:28 +0900 Subject: 2021/10/22 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/shadowroot/index.md | 166 ++++++++++++++++------------------- 1 file changed, 78 insertions(+), 88 deletions(-) diff --git a/files/ja/web/api/shadowroot/index.md b/files/ja/web/api/shadowroot/index.md index 41ec8b880c..ee30857aa4 100644 --- a/files/ja/web/api/shadowroot/index.md +++ b/files/ja/web/api/shadowroot/index.md @@ -4,65 +4,65 @@ slug: Web/API/ShadowRoot tags: - API - Interface - - Reference + - リファレンス - ShadowRoot - - Web Components - - shadow dom - - インターフェイス + - ウェブコンポーネント + - シャドウ DOM +browser-compat: api.ShadowRoot translation_of: Web/API/ShadowRoot --- -
{{APIRef('Shadow DOM')}}
- -

ShadowRoot インターフェイスは Shadow DOM API の1つで、文書の DOM ツリーから分離してレンダリングされた部分木の根ノードを指します。

- -

shadow ツリーが mode オプションを open に指定して {{domxref("Element.attachShadow()")}} から作られた場合、shadow root への参照は {{domxref("Element.shadowRoot")}} プロパティによって読み出すことが出来ます。

- -

プロパティ

- -
-
{{domxref("ShadowRoot.delegatesFocus")}} {{readonlyinline}} {{non-standard_inline}}
-
シャドウが添付されたときに delegatesFocus が設定されていたかどうかを示す真偽値を返します ({{domxref("Element.attachShadow()")}} を参照)。
-
{{domxref("ShadowRoot.host")}} {{readonlyinline}}
-
ShadowRoot が追加された DOM 要素への参照を返します。
-
{{domxref("ShadowRoot.innerHTML")}} {{non-standard_inline}}
-
ShadowRoot の内部ツリーへの参照を設定する、または受け取ることが出来ます。
-
{{domxref("ShadowRoot.mode")}} {{readonlyinline}}
-
ShadowRoot のモードで open または closed の値を取ります。これはシャドウルートの内部の機能に JavaScript からアクセスできるかどうかを定義します。
-
- -

DocumentOrShadowRoot 由来のプロパティ

- -

ShadowRoot インターフェイスは {{domxref("DocumentOrShadowRoot")}} で定義された以下のプロパティを含みます。これは Chrome ブラウザーのみ実装されており、他のブラウザーでは依然 {{domxref("Document")}} インターフェイスで実装されています。

- -
-
{{domxref("DocumentOrShadowRoot.activeElement")}} {{readonlyInline}}
-
shadow ツリーの範囲内で、フォーカスされている {{domxref('Element')}} を返します。
-
{{domxref("DocumentOrShadowRoot.styleSheets")}} {{readonlyInline}}
-
文書に明示的にリンクされている、または埋め込まれている{{domxref('CSSStyleSheet')}} オブジェクトの {{domxref('StyleSheetList')}} を返します。
-
- -

メソッド

- -

ShadowRoot インターフェイスは {{domxref("DocumentOrShadowRoot")}} で定義された以下のプロパティを含みます。これは Chrome ブラウザーのみ実装されており、他のブラウザーでは依然 {{domxref("Document")}} インターフェイスで実装されています。

- -
-
{{domxref("DocumentOrShadowRoot.getSelection()")}}
-
ユーザーによって選択されたテキストの範囲または現在のキャレットの位置を表現する {{domxref('Selection')}} オブジェクトを返します。
-
{{domxref("DocumentOrShadowRoot.elementFromPoint()")}}
-
指定された座標における最上位の要素を返します。
-
{{domxref("DocumentOrShadowRoot.elementsFromPoint()")}}
-
指定された座標における全要素からなる配列を返します。
-
{{domxref("DocumentOrShadowRoot.caretPositionFromPoint()")}}
-
キャレットを含む DOM ノードとキャレットのオフセットを含む {{domxref('CaretPosition')}} オブジェクトを返します。
-
- -

例

- -

以下のコードは、サイズと色の属性が指定された四角形の要素を作る life-cycle-callbacks の例です。 (実行例)

- -

<custom-square> 要素のクラス定義の中に、外部関数である updateStyle を呼び出す life-cycle-callbacks が含まれています。updateStyle は要素のサイズと色を適用しています。this (カスタム要素自身) をパラメータとして関数に渡していることが分かるでしょう。

- -
connectedCallback() {
+{{APIRef('Shadow DOM')}}
+
+**`ShadowRoot`** は Shadow DOM API のインターフェイスで、文書の DOM ツリーから分離してレンダリングされた部分ツリーのルートノードを指します。
+
+要素のシャドウルートへの参照は {{domxref("Element.shadowRoot")}} プロパティで受け取ることができます。これは {{domxref("Element.attachShadow()")}} で `mode` オプションが `open` に設定されて作成されたときに提供されます。
+
+## プロパティ
+
+- {{domxref("ShadowRoot.activeElement")}} {{readonlyInline}}
+  - : フォーカスを持っているシャドウツリー内の {{domxref('Element')}} を返します。
+- {{domxref("ShadowRoot.delegatesFocus")}} {{readonlyinline}} {{non-standard_inline}} {{deprecated_inline}}
+  - : シャドウが取り付けられたときに  `delegatesFocus` が設定されていたかどうかを示す論理値を返します ({{domxref("Element.attachShadow()")}} を参照)。
+- {{DOMxRef("ShadowRoot.fullscreenElement")}} {{ReadOnlyInline}}
+  - : このシャドウツリーで現在全画面モードになっている要素です。
+- {{domxref("ShadowRoot.host")}} {{readonlyinline}}
+  - : `ShadowRoot` が取り付けられた DOM 要素への参照を返します。
+- {{domxref("ShadowRoot.innerHTML")}} {{non-standard_inline}}
+  - : `ShadowRoot` の内部の DOM ツリーへの参照を設定したり返却したりします。
+- {{domxref("ShadowRoot.mode")}} {{readonlyinline}}
+  - : `ShadowRoot` のモードで `open` または `closed` の値を取ります。これはシャドウルートの内部の機能に JavaScript からアクセスできるかどうかを定義します。
+- {{DOMxRef("ShadowRoot.pictureInPictureElement")}} {{ReadOnlyInline}}
+  - : シャドウツリー内で現在ピクチャインピクチャモードで表示されている {{DOMxRef('Element')}} を返します。
+- {{DOMxRef("ShadowRoot.pointerLockElement")}} {{ReadOnlyInline}}
+  - : ポインターがロックされている間、マウスイベントのターゲットとして設定されている {{DOMxRef('Element')}} を返します。
+    ロックが保留中か、ポインターがロックされていないか、ターゲットがほかのツリーにある場合は `null` を返します。
+- {{domxref("ShadowRoot.styleSheets")}} {{readonlyInline}}
+  - : シャドウツリーに明示的にリンクされている、または埋め込まれている {{domxref('CSSStyleSheet')}} オブジェクトの {{domxref('StyleSheetList')}} を返します。
+
+### イベントハンドラー
+
+- {{domxref("ShadowRoot.onslotchange")}}
+  - : [イベントハンドラー](/en-US/docs/Web/Events/Event_handlers)で、 {{domxref("HTMLSlotElement/slotchange_event", "slotchange")}} イベントが発行されたときに呼び出されるコードを表します。
+
+## メソッド
+
+- {{DOMxRef("ShadowRoot.getAnimations()")}}
+  - : 現在有効なすべての {{DOMxRef("Animation")}} オブジェクトのうち、ターゲット要素がシャドウツリーの子孫であるものの配列を返します。
+- {{domxref("ShadowRoot.getSelection()")}}
+  - : ユーザーによって選択されたテキストの範囲または現在のキャレットの位置を表現する {{domxref('Selection')}} オブジェクトを返します。
+- {{domxref("ShadowRoot.elementFromPoint()")}}
+  - : 指定された座標における最上位の要素を返します。
+- {{domxref("ShadowRoot.elementsFromPoint()")}}
+  - : 指定された座標における全要素からなる配列を返します。
+
+## 例
+
+以下のコードは、サイズと色の属性が指定された四角形の要素を作る [life-cycle-callbacks](https://github.com/mdn/web-components-examples/tree/master/life-cycle-callbacks) の例です。 ([ライブでも確認](https://mdn.github.io/web-components-examples/life-cycle-callbacks))
+
+`` 要素のクラス定義の中に、外部関数である `updateStyle()` を呼び出すライフサイクルコールバックが含まれています。`updateStyle()` は要素のサイズと色を適用します。`this` (カスタム要素自身) を引数として関数に渡していることが分かるでしょう。
+
+```js
+connectedCallback() {
   console.log('四角形のカスタム要素がページに追加されました。');
   updateStyle(this);
 }
@@ -70,42 +70,32 @@ translation_of: Web/API/ShadowRoot
 attributeChangedCallback(name, oldValue, newValue) {
   console.log('四角形のカスタム要素の属性が変更されました。');
   updateStyle(this);
-}
+} +``` -

updateStyle 関数の中では、{{domxref("Element.shadowRoot")}} を利用して shadow DOM への参照を取得しています。shadow DOM 内では、標準的な DOM の探索手法を用いて {{htmlelement("style")}} を探し、CSS を更新しています。

+`updateStyle()` 関数の中では、{{domxref("Element.shadowRoot")}} を利用してシャドウ DOM への参照を取得しています。シャドウ DOM 内では、標準的な DOM の探索手法を用いて {{htmlelement("style")}} を探し、CSS を更新しています。 -
function updateStyle(elem) {
+```js
+function updateStyle(elem) {
   var shadow = elem.shadowRoot;
   var childNodes = shadow.childNodes;
-  for(var i = 0; i < childNodes.length; i++) {
+  for(var i = 0; i < childNodes.length; i++) {
     if(childNodes[i].nodeName === 'STYLE') {
-      childNodes[i].textContent = 'div {' +
-                          ' width: ' + elem.getAttribute('l') + 'px;' +
-                          ' height: ' + elem.getAttribute('l') + 'px;' +
-                          ' background-color: ' + elem.getAttribute('c');
+      childNodes[i].textContent =
+        'div {' +
+          'width: ' + elem.getAttribute('l') + 'px;' +
+          'height: ' + elem.getAttribute('l') + 'px;' +
+          'background-color: ' + elem.getAttribute('c') + ';' +
+        '}';
     }
   }
-}
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('DOM WHATWG','#interface-shadowroot','Interface ShadowRoot')}}{{Spec2('DOM WHATWG')}} 
- -

ブラウザーの対応

- -

{{Compat("api.ShadowRoot")}}

+} +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} -- cgit v1.2.3-54-g00ecf