From 8d36b3aad25b4ca190ff4abe7326bd53691ebaac Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Mon, 30 Sep 2024 22:24:42 +0900
Subject: [PATCH] =?UTF-8?q?2024/06/19=20=E6=99=82=E7=82=B9=E3=81=AE?=
 =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?=
 =?UTF-8?q?=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/shadowroot/gethtml/index.md  | 58 +++++++++++++++++++
 .../web/api/shadowroot/serializable/index.md  | 39 +++++++++++++
 2 files changed, 97 insertions(+)
 create mode 100644 files/ja/web/api/shadowroot/gethtml/index.md
 create mode 100644 files/ja/web/api/shadowroot/serializable/index.md

diff --git a/files/ja/web/api/shadowroot/gethtml/index.md b/files/ja/web/api/shadowroot/gethtml/index.md
new file mode 100644
index 00000000000000..1f9a491ea6e537
--- /dev/null
+++ b/files/ja/web/api/shadowroot/gethtml/index.md
@@ -0,0 +1,58 @@
+---
+title: "ShadowRoot: getHTML() メソッド"
+short-title: getHTML()
+slug: Web/API/ShadowRoot/getHTML
+l10n:
+  sourceCommit: 4558d208395a5b1df4db44b0c8ef4e9a0f8adbbf
+---
+
+{{APIRef("DOM")}}
+
+**`getHTML()`** は {{domxref("ShadowRoot")}} インターフェイスのメソッドで、シャドウルートの DOM を HTML 文字列にシリアライズするために使用します。
+
+このメソッドは、options 引数を提供しており、シャドウルートである子ノードのシリアライズができるようにします。options を使用すると、{{domxref("ShadowRoot/serializable","シリアライズ可能","",1)}}なネストされたシャドウルートを含めることができます。また、{{domxref("ShadowRoot")}} オブジェクトの指定された配列を含めることもできます。この配列は、開いているものも閉じているものも含みます。
+
+引数がない場合、シャドウルートである子ノードはシリアライズされず、このメソッドは {{domxref("Element.innerHTML")}} の値を読み取る場合と同じ動作をします。
+
+## 構文
+
+```js-nolint
+const html = shadowRoot.getHTML(options)
+```
+
+### 引数
+
+- `options` {{optional_inline}}
+
+  - : 次のオプションのパラメーターを持つオプションオブジェクトです。
+
+    - `serializableShadowRoots`
+      - : 論理値で、[シリアライズ可能](/ja/docs/Web/API/ShadowRoot/serializable)なシャドウルートを含めるかどうかを指定します。
+        既定値は `false` です。
+    - `shadowRoots`
+      - : シリアライズする {{domxref("ShadowRoot")}} オブジェクトの配列です。
+        これらは、`serializable` としてマークされているかどうか、または開かれているか閉じられたかに関係なく含まれます。
+        既定値は空の配列です。
+
+### 返値
+
+文字列で、シャドウルートの HTML シリアライズを表します。
+
+### 例外
+
+なし。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("Element.getHTML()")}}
+- {{domxref("Element.innerHTML")}}
+- {{domxref("ShadowRoot.setHTMLUnsafe()")}}
+- {{domxref("Element.setHTMLUnsafe()")}}
diff --git a/files/ja/web/api/shadowroot/serializable/index.md b/files/ja/web/api/shadowroot/serializable/index.md
new file mode 100644
index 00000000000000..10e1c583459c1f
--- /dev/null
+++ b/files/ja/web/api/shadowroot/serializable/index.md
@@ -0,0 +1,39 @@
+---
+title: "ShadowRoot: serializable プロパティ"
+short-title: serializable
+slug: Web/API/ShadowRoot/serializable
+l10n:
+  sourceCommit: 4558d208395a5b1df4db44b0c8ef4e9a0f8adbbf
+---
+
+{{APIRef("Shadow DOM")}}
+
+**`serializable`** は {{domxref("ShadowRoot")}} インターフェイスの読み取り専用プロパティで、このシャドウルートがシリアライズ可能であれば、`true` を返します。
+
+設定されている場合、このシャドウルートは、{{DOMxRef('Element.getHTML()')}} または {{DOMxRef('ShadowRoot.getHTML()')}} メソッドを `options.serializableShadowRoots` 引数に `true` を指定して呼び出すことでシリアライズできます。
+
+シャドウルートの serializable プロパティは、シャドウルートが作成された際に指定されます。`<template>` 要素に [`shadowrootserializable`](/ja/docs/Web/HTML/Element/template#shadowrootserializable) 属性を（許可された [`shadowrootmode`](/ja/docs/Web/HTML/Element/template#shadowrootmode) 値とともに）追加することで宣言的に指定するか、[`options.serializable`](/ja/docs/Web/API/Element/attachShadow#serializable) 引数を `true` に設定して [`Element.attachShadow()`](/ja/docs/Web/API/Element/attachShadow) を使用します。
+
+## 値
+
+このシャドウルートがシリアライズ可能であれば `true`、そうでなければ `false`。
+
+## 例
+
+```js
+let customElem = document.querySelector("my-shadow-dom-element");
+let shadow = customElem.shadowRoot;
+
+// ...
+
+// シリアライズ可能かどうか
+let hostElem = shadow.serializable;
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}