From d853a8e73b4909d6799af8b12f84947738ddf8d4 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 5 Jul 2021 01:54:01 +0900 Subject: Web/API/Node を更新 (#1311) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - conflicting 版は古いので削除 - 2021/06/26 時点の英語版に同期 --- files/ja/_redirects.txt | 16 +- files/ja/_wikihistory.json | 17 - files/ja/conflicting/web/api/node/index.html | 34 -- .../index.html | 22 - files/ja/web/api/node/index.html | 512 +++++++++++---------- 5 files changed, 275 insertions(+), 326 deletions(-) delete mode 100644 files/ja/conflicting/web/api/node/index.html delete mode 100644 files/ja/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html (limited to 'files') diff --git a/files/ja/_redirects.txt b/files/ja/_redirects.txt index 34c2e15c34..09ffb3bdf7 100644 --- a/files/ja/_redirects.txt +++ b/files/ja/_redirects.txt @@ -1349,7 +1349,7 @@ /ja/docs/DOM/Node /ja/docs/Web/API/Node /ja/docs/DOM/Node.appendChild /ja/docs/Web/API/Node/appendChild /ja/docs/DOM/Node.attributes /ja/docs/Web/API/Element/attributes -/ja/docs/DOM/Node.baseURIObject /ja/docs/conflicting/Web/API/Node +/ja/docs/DOM/Node.baseURIObject /ja/docs/Web/API/Node /ja/docs/DOM/Node.childNodes /ja/docs/Web/API/Node/childNodes /ja/docs/DOM/Node.cloneNode /ja/docs/Web/API/Node/cloneNode /ja/docs/DOM/Node.compareDocumentPosition /ja/docs/Web/API/Node/compareDocumentPosition @@ -1368,7 +1368,7 @@ /ja/docs/DOM/Node.namespaceURI /ja/docs/Web/API/Element/namespaceURI /ja/docs/DOM/Node.nextSibling /ja/docs/Web/API/Node/nextSibling /ja/docs/DOM/Node.nodeName /ja/docs/Web/API/Node/nodeName -/ja/docs/DOM/Node.nodePrincipal /ja/docs/conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 +/ja/docs/DOM/Node.nodePrincipal /ja/docs/Web/API/Node /ja/docs/DOM/Node.nodeType /ja/docs/Web/API/Node/nodeType /ja/docs/DOM/Node.nodeValue /ja/docs/Web/API/Node/nodeValue /ja/docs/DOM/Node.normalize /ja/docs/Web/API/Node/normalize @@ -1416,7 +1416,7 @@ /ja/docs/DOM/document.anchors /ja/docs/Web/API/Document/anchors /ja/docs/DOM/document.applets /ja/docs/Web/API/Document/applets /ja/docs/DOM/document.async /ja/docs/Web/API/XMLDocument/async -/ja/docs/DOM/document.baseURIObject /ja/docs/conflicting/Web/API/Node +/ja/docs/DOM/document.baseURIObject /ja/docs/Web/API/Node /ja/docs/DOM/document.bgColor /ja/docs/Web/API/Document/bgColor /ja/docs/DOM/document.body /ja/docs/Web/API/Document/body /ja/docs/DOM/document.characterSet /ja/docs/Web/API/Document/characterSet @@ -1476,7 +1476,7 @@ /ja/docs/DOM/element.addEventListener /ja/docs/Web/API/EventTarget/addEventListener /ja/docs/DOM/element.appendChild /ja/docs/Web/API/Node/appendChild /ja/docs/DOM/element.attributes /ja/docs/Web/API/Element/attributes -/ja/docs/DOM/element.baseURIObject /ja/docs/conflicting/Web/API/Node +/ja/docs/DOM/element.baseURIObject /ja/docs/Web/API/Node /ja/docs/DOM/element.blur /ja/docs/Web/API/HTMLOrForeignElement/blur /ja/docs/DOM/element.childNodes /ja/docs/Web/API/Node/childNodes /ja/docs/DOM/element.classList /ja/docs/Web/API/Element/classList @@ -3898,7 +3898,7 @@ /ja/docs/Web/API/NavigatorLanguage.languages /ja/docs/Web/API/NavigatorLanguage/languages /ja/docs/Web/API/Node.appendChild /ja/docs/Web/API/Node/appendChild /ja/docs/Web/API/Node.attributes /ja/docs/Web/API/Element/attributes -/ja/docs/Web/API/Node.baseURIObject /ja/docs/conflicting/Web/API/Node +/ja/docs/Web/API/Node.baseURIObject /ja/docs/Web/API/Node /ja/docs/Web/API/Node.childNodes /ja/docs/Web/API/Node/childNodes /ja/docs/Web/API/Node.cloneNode /ja/docs/Web/API/Node/cloneNode /ja/docs/Web/API/Node.compareDocumentPosition /ja/docs/Web/API/Node/compareDocumentPosition @@ -3916,7 +3916,7 @@ /ja/docs/Web/API/Node.namespaceURI /ja/docs/Web/API/Element/namespaceURI /ja/docs/Web/API/Node.nextSibling /ja/docs/Web/API/Node/nextSibling /ja/docs/Web/API/Node.nodeName /ja/docs/Web/API/Node/nodeName -/ja/docs/Web/API/Node.nodePrincipal /ja/docs/conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 +/ja/docs/Web/API/Node.nodePrincipal /ja/docs/Web/API/Node /ja/docs/Web/API/Node.nodeType /ja/docs/Web/API/Node/nodeType /ja/docs/Web/API/Node.nodeValue /ja/docs/Web/API/Node/nodeValue /ja/docs/Web/API/Node.normalize /ja/docs/Web/API/Node/normalize @@ -3928,14 +3928,14 @@ /ja/docs/Web/API/Node.removeChild /ja/docs/Web/API/Node/removeChild /ja/docs/Web/API/Node.replaceChild /ja/docs/Web/API/Node/replaceChild /ja/docs/Web/API/Node.textContent /ja/docs/Web/API/Node/textContent -/ja/docs/Web/API/Node/baseURIObject /ja/docs/conflicting/Web/API/Node +/ja/docs/Web/API/Node/baseURIObject /ja/docs/Web/API/Node /ja/docs/Web/API/Node/cloneNode-old /ja/docs/orphaned/Web/API/Node/getUserData /ja/docs/Web/API/Node/firstChild-temp /ja/docs/Web/API/Node/firstChild /ja/docs/Web/API/Node/getUserData /ja/docs/orphaned/Web/API/Node/getUserData /ja/docs/Web/API/Node/innerText /ja/docs/Web/API/HTMLElement/innerText /ja/docs/Web/API/Node/localName /ja/docs/Web/API/Element/localName /ja/docs/Web/API/Node/namespaceURI /ja/docs/Web/API/Element/namespaceURI -/ja/docs/Web/API/Node/nodePrincipal /ja/docs/conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 +/ja/docs/Web/API/Node/nodePrincipal /ja/docs/Web/API/Node /ja/docs/Web/API/Node/prefix /ja/docs/Web/API/Element/prefix /ja/docs/Web/API/NodeList.item /ja/docs/Web/API/NodeList/item /ja/docs/Web/API/NonDocumentTypeChildNode /ja/docs/conflicting/Web/API/Element_861159909c20acebf8e506c3bb0e2f7e diff --git a/files/ja/_wikihistory.json b/files/ja/_wikihistory.json index 86f861bd90..a8efb246e9 100644 --- a/files/ja/_wikihistory.json +++ b/files/ja/_wikihistory.json @@ -48715,23 +48715,6 @@ "Okome" ] }, - "conflicting/Web/API/Node": { - "modified": "2019-03-23T23:33:08.458Z", - "contributors": [ - "SphinxKnight", - "fscholz", - "khalid32", - "ethertank" - ] - }, - "conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556": { - "modified": "2019-03-23T23:38:34.732Z", - "contributors": [ - "fscholz", - "khalid32", - "ethertank" - ] - }, "conflicting/Web/API/URL": { "modified": "2019-03-23T23:31:44.426Z", "contributors": [ diff --git a/files/ja/conflicting/web/api/node/index.html b/files/ja/conflicting/web/api/node/index.html deleted file mode 100644 index 697cffed41..0000000000 --- a/files/ja/conflicting/web/api/node/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Node.baseURIObject -slug: conflicting/Web/API/Node -tags: - - DOM - - DOM 3 - - Gecko - - Node -translation_of: Web/API/Node -translation_of_original: Web/API/Node/baseURIObject -original_slug: Web/API/Node/baseURIObject ---- -
{{ApiRef}} {{Non-standard_header}}
- -

概要

- -

baseURIObject は、文書の基底 URL (base URL) を示す {{Interface("nsIURI")}} オブジェクトを返します。

- -

このプロパティは、HTML 、 XUL、 SVG、 MathML 等のノード全てに存在します。但し、このプロパティの使用を試みるスクリプトが UniversalXPConnect 特権を持つ場合に限ります。

- -

基底 URL の詳細については {{domxref("Node.baseURI")}} の頁をご覧下さい。

- -

構文

- -
uriObj = element.baseURIObject
-
- -

注記

- -

このプロパティは読取専用です。書込を試みた場合、例外がスローされます。また、このプロパティには、特権を持つコードからのみアクセス可能です。

- -

仕様書

- -

標準仕様書には含まれません。

diff --git a/files/ja/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html b/files/ja/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html deleted file mode 100644 index 53585b37f0..0000000000 --- a/files/ja/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Node.nodePrincipal -slug: conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 -tags: - - DOM - - Gecko - - Gecko DOM Reference -translation_of: Web/API/Node -translation_of_original: Web/API/Node/nodePrincipal -original_slug: Web/API/Node/nodePrincipal ---- -
- {{ApiRef}}{{Non-standard_header}}
-

概要

-

nodePrincipal は、ノードの現在のセキュリティ・コンテキストを表す {{interface("nsIPrincipal")}} オブジェクトを返します

-

{{note("このプロパティは、HTML 、XUL 、SVG 、MathML などの全てのノードに存在しますが、スクリプトが使用を試みた場合にのみ、 UniversalXPConnect 特権を持ちます。")}}

-

構文

-
principalObj = element.nodePrincipal
-

注記

-

このプロパティは読取専用です。書込みを試みた場合、例外がスローされます。また、このプロパティには特権コードからのみアクセス可能です。

-

仕様書

-

仕様書はありません。

diff --git a/files/ja/web/api/node/index.html b/files/ja/web/api/node/index.html index 1754c22129..dc20596b32 100644 --- a/files/ja/web/api/node/index.html +++ b/files/ja/web/api/node/index.html @@ -4,293 +4,315 @@ slug: Web/API/Node tags: - API - DOM - - DOM Reference + - Document + - Element - Interface - Node - Reference + - Structure + - hierarchy translation_of: Web/API/Node +browser-compat: api.Node --- -
{{APIRef("DOM")}}
+

{{APIRef("DOM")}}

-

Node はいくつもの DOM API オブジェクトタイプが継承しているインターフェイスで、それらのさまざまなタイプを同じように扱える (同じメソッドのセットを継承する、または同じ方法でテストできる) ようにします。

+

{{Glossary("DOM")}} の Node インターフェイスは、他の多くの DOM API オブジェクトのベースとなる抽象的な基底クラスです。したがって、これらのオブジェクト型と類似しており、しばしば交換して使用することができます。抽象クラスであるため、単なる Node オブジェクトというものは存在しません。 Node の機能を実装しているオブジェクトはすべて、そのサブクラスの一つをベースにしています。最も注目すべきものは、 {{domxref("Document")}}, {{domxref("Element")}}, {{domxref("DocumentFragment")}} です。

-

以下のインターフェイスはすべて、Node からメソッドやプロパティを継承しています: {{domxref("Document")}}, {{domxref("Element")}}, {{domxref("Attr")}}, {{domxref("CharacterData")}} (which {{domxref("Text")}}, {{domxref("Comment")}}, and {{domxref("CDATASection")}} inherit), {{domxref("ProcessingInstruction")}}, {{domxref("DocumentFragment")}}, {{domxref("DocumentType")}}, {{domxref("Notation")}}, {{domxref("Entity")}}, {{domxref("EntityReference")}}

+

それに加えて、あらゆる種類の DOM ノードが Node を基底とするインターフェイスで表現されます。これには、 {{DOMxRef("Attr")}}, {{DOMxRef("CharacterData")}} + ({{DOMxRef("Text")}}, {{DOMxRef("Comment")}}, {{DOMxRef("CDATASection")}}, {{DOMxRef("ProcessingInstruction")}} がすべて既定とするもの), {{DOMxRef("DocumentType")}}, {{DOMxRef("Notation")}}, {{DOMxRef("Entity")}}, {{DOMxRef("EntityReference")}} があります。

-

これらのインターフェイスは、そのメソッドやプロパティが妥当でないときは null を返すことがあります。例外を投げることもあります - 例えば、子が存在できないノードタイプに子を追加するとき。

+

場合によっては、ベースとなる Node インターフェイスの特定の機能が子インターフェイスに適用されないことがあります。この場合、継承するノードは状況に応じて null を返したり、例外を投げたりします。例えば、子を持てないノード型に子を追加しようとすると、例外が発生します。

{{InheritanceDiagram}}

-

プロパティ

+

プロパティ

-

親である {{domxref("EventTarget")}} からプロパティを継承します。[1]

+

以下のプロパティに加え、 Node は親である {{DOMxRef("EventTarget")}} からプロパティを継承しています。

-
{{domxref("Node.baseURI")}} {{readonlyInline}}
-
ベース URL を表す {{domxref("DOMString")}} を返します。ベース URL の概念は、言語によって変わります。HTML ではプロトコル、ドメイン名、ディレクトリー構造に対応しており、最後の '/' までのすべてになります。
-
{{domxref("Node.baseURIObject")}} {{Non-standard_inline}}
-
(ウェブコンテンツでは使用できません) 要素のベース URI を表す、読み取り専用の {{Interface("nsIURI")}} オブジェクトを返します。
-
{{domxref("Node.childNodes")}} {{readonlyInline}}
-
このノードのすべての子孫を含む、生きている {{domxref("NodeList")}} を返します。{{domxref("NodeList")}} が生きているとは、Node の子が変化すれば自動的に {{domxref("NodeList")}} オブジェクトが更新されることを意味します。
-
{{domxref("Node.firstChild")}} {{readonlyInline}}
-
ノードの直下の最初の子ノードを表す {{domxref("Node")}} を返します。子が存在しなければ null を返します。
-
{{domxref("Node.isConnected")}} {{readonlyInline}}
-
ノードが(直接/関節的に)コンテキストオブジェクトに接続されているかを示す論理値。例えば通常の DOM の場合は {{domxref("Document")}} オブジェクト、あるいはシャドーDOM の場合は {{domxref("ShadowRoot")}}。
-
{{domxref("Node.lastChild")}} {{readonlyInline}}
-
ノードの直下の最後の子ノードを表す {{domxref("Node")}} を返します。子が存在しなければ null を返します。
-
{{domxref("Node.nextSibling")}} {{readonlyInline}}
-
ツリー構造で次のノードを表す {{domxref("Node")}} を返します。該当するノードがない場合は null を返します。
-
{{domxref("Node.nodeName")}} {{readonlyInline}}
-
Node の名前を持つ {{domxref("DOMString")}} を返します。名前の構造は、ノードの型によって異なります。例えば、{{domxref("HTMLElement")}} は {{domxref("HTMLAudioElement")}} に対して 'audio' というように対応するタグの名前、{{domxref("Text")}} ノードは '#text' という文字列、{{domxref("Document")}} ノードは '#document' という文字列になります。
-
{{domxref("Node.nodePrincipal")}} {{Non-standard_inline}}
-
ノードのプリンシパルを表す {{Interface("nsIPrincipal")}} を返します。
-
{{domxref("Node.nodeType")}}{{readonlyInline}}
-
ノードの型を表す unsigned short を返します。使用できる値: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
名称値
ELEMENT_NODE1
ATTRIBUTE_NODE {{deprecated_inline}}2
TEXT_NODE3
CDATA_SECTION_NODE {{deprecated_inline}}4
ENTITY_REFERENCE_NODE {{deprecated_inline}}5
ENTITY_NODE {{deprecated_inline}}6
PROCESSING_INSTRUCTION_NODE7
COMMENT_NODE8
DOCUMENT_NODE9
DOCUMENT_TYPE_NODE10
DOCUMENT_FRAGMENT_NODE11
NOTATION_NODE {{deprecated_inline}}12
-
-
{{domxref("Node.nodeValue")}}
-
カレントノードの値を取得または設定します。
-
{{domxref("Node.ownerDocument")}} {{readonlyInline}}
-
ノードが所属する {{domxref("Document")}} を返します。ノードが document 自身の場合は、null を返します。
-
{{domxref("Node.parentNode")}} {{readonlyInline}}
-
このノードの親の {{domxref("Node")}} を返します。ノードがツリーの最上位である、あるいはツリーに加わっていないなど、親が存在しない場合は null を返します。
-
{{domxref("Node.parentElement")}} {{readonlyInline}}
-
このノードの親の {{domxref("Element")}} を返します。ノードに親が存在しない、あるいは親が {{domxref("Element")}} ではない場合は、null を返します。
-
{{domxref("Node.previousSibling")}} {{readonlyInline}}
-
ツリー構造で前のノードを表す {{domxref("Node")}} を返します。該当するノードがない場合は null を返します。
-
{{domxref("Node.textContent")}}
-
要素や要素のすべての子孫のテキストコンテンツを取得または設定します。
+
{{DOMxRef("Node.baseURI")}}{{ReadOnlyInline}}
+
この Node を持つ文書のベース URL を表す {{DOMxRef("DOMString")}} を返します。
+
{{DOMxRef("Node.childNodes")}}{{ReadOnlyInline}}
+
このノードのすべての子孫 (要素、テキスト、コメント) を持つ、生きた {{DOMxRef("NodeList")}} を返します。 {{DOMxRef("NodeList")}} が生きているとは、Node の子が変化すれば自動的に {{DOMxRef("NodeList")}} オブジェクトが更新されることを意味します。
+
{{DOMxRef("Node.firstChild")}}{{ReadOnlyInline}}
+
ノードの直下の最初の子ノードを表す {{DOMxRef("Node")}} を返します。子が存在しなければ null を返します。
+
{{DOMxRef("Node.isConnected")}}{{ReadOnlyInline}}
+
論理値で、ノードが (直接/間接的に) コンテキストオブジェクト、例えば、通常の DOM の場合は {{DOMxRef("Document")}} オブジェクト、あるいはシャドー DOM の場合は {{DOMxRef("ShadowRoot")}} に接続されているかどうかを示します。
+
{{DOMxRef("Node.lastChild")}}{{ReadOnlyInline}}
+
ノードの直下の最後の子ノードを表す {{DOMxRef("Node")}} を返します。子が存在しなければ null を返します。
+
{{DOMxRef("Node.nextSibling")}}{{ReadOnlyInline}}
+
ツリー構造で次のノードを表す {{DOMxRef("Node")}} を返します。該当するノードがない場合は null を返します。
+
{{DOMxRef("Node.nodeName")}}{{ReadOnlyInline}}
+
Node の名前を持つ {{DOMxRef("DOMString")}} を返します。名前の構造は、ノードの型によって異なります。例えば、{{DOMxRef("HTMLElement")}} は {{DOMxRef("HTMLAudioElement")}} に対して 'audio' というように対応するタグの名前、{{DOMxRef("Text")}} ノードは '#text' という文字列、{{DOMxRef("Document")}} ノードは '#document' という文字列になります。
+
{{DOMxRef("Node.nodeType")}}{{ReadOnlyInline}}
+
ノードの型を表す unsigned short を返します。使用できる値は次の通りです。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称値
ELEMENT_NODE1
ATTRIBUTE_NODE {{Deprecated_Inline}}2
TEXT_NODE3
CDATA_SECTION_NODE4
ENTITY_REFERENCE_NODE {{Deprecated_Inline}}5
ENTITY_NODE {{Deprecated_Inline}}6
PROCESSING_INSTRUCTION_NODE7
COMMENT_NODE8
DOCUMENT_NODE9
DOCUMENT_TYPE_NODE10
DOCUMENT_FRAGMENT_NODE11
NOTATION_NODE {{Deprecated_Inline}}12
+
+
{{DOMxRef("Node.nodeValue")}}
+
現在のノードの値を取得または設定します。
+
{{DOMxRef("Node.ownerDocument")}}{{ReadOnlyInline}}
+
ノードが所属する {{DOMxRef("Document")}} を返します。ノードが document 自身の場合は、null を返します。
+
{{DOMxRef("Node.parentNode")}}{{ReadOnlyInline}}
+
このノードの親の {{DOMxRef("Node")}} を返します。ノードがツリーの最上位である、あるいはツリーに加わっていないなど、親が存在しない場合は null を返します。
+
{{DOMxRef("Node.parentElement")}}{{ReadOnlyInline}}
+
このノードの親の {{DOMxRef("Element")}} を返します。ノードに親が存在しない、あるいは親が {{DOMxRef("Element")}} ではない場合は、null を返します。
+
{{DOMxRef("Node.previousSibling")}}{{ReadOnlyInline}}
+
ツリー構造で前のノードを表す {{DOMxRef("Node")}} を返します。該当するノードがない場合は null を返します。
+
{{DOMxRef("Node.textContent")}}
+
要素や要素のすべての子孫のテキストコンテンツを取得または設定します。
-

非推奨プロパティ

+

メソッド

+ +

以下のプロパティに加えて、親である {{DOMxRef("EventTarget")}} からメソッドを継承しています。

-
{{domxref("Node.rootNode")}} {{readOnlyInline}} {{deprecated_inline}}
-
ツリーの最上位ノードを表す {{domxref("Node")}} オブジェクトを返します。自身がツリーの最上位ノードである場合はカレントノードを返します。これは {{domxref("Node.getRootNode()")}} に置き換えられました。
+
{{DOMxRef("Node.appendChild()", "Node.appendChild(childNode)")}}
+
現在のノードの最後の子として、指定した childNode 引数を追加します。
+ 引数が DOM ツリー上の既存のノードを参照している場合は、ノードが現在の位置から外されて新しい位置に追加されます。
+
{{DOMxRef("Node.cloneNode()")}}
+
{{DOMxRef("Node")}} を複製します。また、すべての内容物を複製することもできます。既定で、ノードの内容物を複製します。
+
{{DOMxRef("Node.compareDocumentPosition()")}}
+
現在のノードの位置を、他のドキュメント内の別のノードと比較します。
+
{{DOMxRef("Node.contains()")}}
+
ノードが指定したノードの子孫であるか否かを true または false の値で返します。
+
{{domxref("Node.getBoxQuads()")}} {{experimental_inline}}
+
このノードの CSS ボックスのうち、他のノードに関連するもののリストを返します。
+
{{DOMxRef("Node.getRootNode()")}}
+
コンテキストオブジェクトのルートを返します。任意で、シャドウルートが使用可能である場合にそれを含めることができます。
+
{{DOMxRef("Node.hasChildNodes()")}}
+
要素が子ノードを持っているか否かを示す {{jsxref("Boolean")}} を返します。
+
{{DOMxRef("Node.insertBefore()")}}
+
現在のノードの子として、参照先ノードの前に {{DOMxRef("Node")}} を挿入します。
+
{{DOMxRef("Node.isDefaultNamespace()")}}
+
引数として名前空間の URI を受け入れて、名前空間が指定したノードのデフォルトの名前空間であれば true、そうでない場合は false である {{jsxref("Boolean")}} を返します。
+
{{DOMxRef("Node.isEqualNode()")}}
+
2 つのノードが同じ型であり、定義されているすべてのデータポイントが一致するか否かを表す {{jsxref("Boolean")}}を返します。
+
{{DOMxRef("Node.isSameNode()")}}
+
2 つのノードが同じである (すなわち、同じオブジェクトを参照している) か否かを示す {{jsxref("Boolean")}} 値を返します。
+
{{DOMxRef("Node.lookupPrefix()")}}
+
指定した名前空間 URI の接頭辞があれば、その接頭辞を含む {{DOMxRef("DOMString")}} を返します。接頭辞がない場合は null を返します。複数の接頭辞があった場合の結果は実装依存です。
+
{{DOMxRef("Node.lookupNamespaceURI()")}}
+
接頭辞を受け入れて、指定したノードで接頭辞が関連付けられた名前空間が見つかった場合は名前空間の URI を返します (見つからない場合は null を返します)。接頭辞として null を与えると、デフォルトの名前空間を返します。
+
{{DOMxRef("Node.normalize()")}}
+
要素内のすべてのテキストノードをクリーンアップ (隣接ノードを統合、空のノードを削除) します。
+
{{DOMxRef("Node.removeChild()")}}
+
現在の要素から子ノードを削除します。現在の要素は現在のノードの子であることが必要です。
+
{{DOMxRef("Node.replaceChild()")}}
+
現在のノードの子 {{DOMxRef("Node")}} のひとつを、引数で指定した別のノードで置き換えます。
-

廃止プロパティ

+

廃止メソッド

-
{{domxref("Node.localName")}} {{obsolete_inline}}{{readonlyInline}}
-
要素の修飾名のローカル部分を表す {{domxref("DOMString")}} を返します。 -
-

注記: Firefox 3.5 および以前のバージョンでは、このプロパティで HTML 要素のローカル名が大文字でした (XHTML 要素を除く)。以降のバージョンではこのようになりませんので、このプロパティでは HTML および XHTML の両方が小文字になります。{{gecko_minversion_inline("1.9.2")}}

-
-
-
{{domxref("Node.namespaceURI")}} {{obsolete_inline}}{{readonlyInline}}
-
ノードの名前空間の URI。名前空間がない場合は null になります。 -
-

注記: Firefox 3.5 および以前のバージョンでは、HTML 要素の名前空間はありません。以降のバージョンでは、HTML 要素は HTML ツリーおよび XML ツリーで https://www.w3.org/1999/xhtml/ 名前空間内に存在します。{{gecko_minversion_inline("1.9.2")}}

-
-
-
{{domxref("Node.prefix")}} {{obsolete_inline}}{{readonlyInline}}
-
ノードの名前空間の接頭辞を表す {{domxref("DOMString")}} を返します。接頭辞が指定されていない場合は null を返します。
+
{{DOMxRef("Node.hasAttributes()")}} {{deprecated_inline}}
+
要素がなんらかの属性を持っているか否かを true または false で返します。
+
{{DOMxRef("Node.isSupported()")}} {{deprecated_inline}}
+
DOM 実装が特定の機能を実装しており、またその機能が指定したノードでサポートされているかを確認して、その結果を true または false で返します。
-

メソッド

+

例

-

親である {{domxref("EventTarget")}} からメソッドを継承します。[1]

+

ノード内にあるすべての子を削除 +

-
-
{{domxref("Node.appendChild()")}}
-
カレントノードの最後の子として、指定した childNode 引数を追加します。
- 引数が DOM ツリー上の既存のノードを参照している場合は、ノードが現在の位置から外されて新しい位置に追加されます。
-
{{domxref("Node.cloneNode()")}}
-
{{domxref("Node")}} を複製します。また、すべての内容物を複製することもできます。デフォルトで、ノードの内容物を複製します。
-
{{domxref("Node.compareDocumentPosition()")}}
-
カレントノードの位置を、他のドキュメント内の別のノードと比較します。
-
{{domxref("Node.contains()")}}
-
ノードが指定したノードの子孫であるか否かを示す {{jsxref("Boolean")}} 値を返します。
-
{{domxref("Node.getRootNode()")}}
-
コンテキストオブジェクトのルートを返します。任意で、shadow root が使用可能である場合にそれを含めることができます。
-
{{domxref("Node.hasChildNodes()")}}
-
要素が子ノードを持っているか否かを示す {{jsxref("Boolean")}} を返します。
-
{{domxref("Node.insertBefore()")}}
-
カレントノードの子として、参照先ノードの前に {{domxref("Node")}} を挿入します。
-
{{domxref("Node.isDefaultNamespace()")}}
-
引数として名前空間の URI を受け入れて、名前空間が指定したノードのデフォルトの名前空間であれば true、そうでない場合は false である {{jsxref("Boolean")}} を返します。
-
{{domxref("Node.isEqualNode()")}}
-
2 つのノードが同じ型であり、定義されているすべてのデータポイントが一致するか否かを表す {{jsxref("Boolean")}}を返します。
-
{{domxref("Node.isSameNode()")}}
-
2 つのノードが同じである (すなわち、同じオブジェクトを参照している) か否かを示す {{jsxref("Boolean")}} 値を返します。
-
{{domxref("Node.lookupPrefix()")}}
-
指定した名前空間 URI の接頭辞があれば、その接頭辞を含む {{domxref("DOMString")}} を返します。接頭辞がない場合は null を返します。複数の接頭辞がある場合の結果は実装依存です。
-
{{domxref("Node.lookupNamespaceURI()")}}
-
接頭辞を受け入れて、指定したノードで接頭辞が関連付けられた名前空間が見つかった場合は名前空間の URI を返します (見つからない場合は null を返します)。接頭辞として null を与えると、デフォルトの名前空間を返します。
-
{{domxref("Node.normalize()")}}
-
要素内のすべてのテキストノードをクリーンアップ (隣接ノードを統合、空のノードを削除) します。
-
{{domxref("Node.removeChild()")}}
-
カレント要素から子ノードを削除します。カレント要素はカレントノードの子であることが必要です。
-
{{domxref("Node.replaceChild()")}}
-
カレントノードの子 {{domxref("Node")}} のひとつを、引数で指定した別のノードで置き換えます。
-
+
function removeAllChildren(element) {
+  while (element.firstChild) {
+    element.removeChild(element.firstChild)
+  }
+}
-

廃止メソッド

+

単純な使用方法

-
-
{{domxref("Node.getFeature()")}} {{obsolete_inline}}
-
x
-
{{domxref("Node.getUserData()")}} {{obsolete_inline}}
-
ユーザーが、ノードから {{domxref("DOMUserData")}} を取得できます。
-
{{domxref("Node.hasAttributes()")}} {{obsolete_inline}}
-
要素がなんらかの属性を持っているか否かを示す {{jsxref("Boolean")}} を返します。
-
{{domxref("Node.isSupported()")}} {{obsolete_inline}}
-
DOM 実装が特定の機能を実装しており、またその機能が指定したノードでサポートされているかを確認して、その結果を表す {{jsxref("Boolean")}} を返します。
-
{{domxref("Node.setUserData()")}} {{obsolete_inline}}
-
ユーザーが、ノードに {{domxref("DOMUserData")}} を追加または削除できます。
-
+
/* Note: or use document.body.textContent = "" */
+removeAllChildren(document.body)
-

例

+

すべての子ノードを走査する

-

すべての子ノードを走査する

+

次の関数は、ルートノードに含まれる (ルートノード自身も含めた) すべてのノードに対してコールバック関数を再帰的に呼び出します。

-

次の関数はすべての子ノードを再帰的にループして、それらに対してコールバック関数を呼び出します。（また、親ノード自身に対しても同様に呼び出されます。

+
function eachNode(rootNode, callback) {
+	if (!callback) {
+		const nodes = []
+		eachNode(rootNode, function(node) {
+			nodes.push(node)
+		})
+		return nodes
+	}
 
-
function DOMComb (oParent, oCallback) {
-  if (oParent.hasChildNodes()) {
-    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
-      DOMComb(oNode, oCallback);
-    }
+	if (false === callback(rootNode)) {
+		return false
   }
-  oCallback.call(oParent);
-}

 
-
構文

+	if (rootNode.hasChildNodes()) {
+		const nodes = rootNode.childNodes
+		for (let i = 0, l = nodes.length; i < l; ++i) {
+			if (false === eachNode(nodes[i], callback)) {
+				return
+            }
+        }
+	}
+}
+
+ +

構文

+ +
eachNode(rootNode, callback)
+ +

解説

-
DOMComb(parentNode, callbackFunction);
+

rootNode の (ルート自身を含む) 各子孫ノードに対して、関数を再帰的に呼び出します。

-

説明

+

callback +が省略された場合、この関数は代わりに {{jsxref("Array")}} を返し、そこには rootNode とその中に含まれるすべてのノードが含まれます。

-

parentNode のすべての子ノードと parentNode 自身を再帰的にループして、それらを this オブジェクトとして callbackFunction を実行します。

+

callback が提供され、 false を返した場合、現在の再帰レベルは中止され、関数は最後の親のレベルから実行を再開します。これは、 (特定の文字列を含むテキストノードを検索するなどして) ノードが見つかった時点でループを中止するために利用できます。 +

-

引数

+

引数

-
parentNode
-
親ノード (Node Object)
-
callbackFunction
-
コールバック関数 (Function)
+
rootNode
+
再帰的に子孫の走査を行う Node オブジェクトです。
+
callback {{optional_inline}}
+
省略可能なコールバック関数で、単一の Node を引数として受け取るものです。省略された場合、 eachNode は {{jsxref("Array")}} で、 rootNode の中に含まれる (ルート自身も含む) ノードの一覧を返します。
-

用例

+

単純な使用

-

次の例はボディの中のテキストの内容を console.log に送るものです:

+

以下の例は、"box" という名前の <div> 要素の中にあるそれぞれの <span> 要素の textContent プロパティを出力します。

-
function printContent () {
-  if (this.nodeValue) { console.log(this.nodeValue); }
-}
+
<div id="box">
+  <span>Foo</span>
+  <span>Bar</span>
+  <span>Baz</span>
+</div>

+
+
const box = document.getElementById("box")
+eachNode(box, function(node) {
+  if (null != node.textContent) {
+    console.log(node.textContent)
+  }
+})

+
+
上記の例は、ユーザーのコンソールに以下の文字列を結果として出力します。

+
+
"\n\t", "Foo", "\n\t", "Bar", "\n\t", "Baz"

+
+

+  
注: ホワイトスペースは {{DOMxRef("Text")}} ノードの一部を形成し、インデントと改行は独立した Text を Element ノードの間に形成します。

+

+
+
実際の使い方

+
+
次の例は eachNode() 関数の現実世界での使用方法として、ウェブページ上のテキストの検索を示します。

+
+
検索には  grep というラッパー関数を使用しています。

+
+
function grep(parentNode, pattern) {
+	const matches = []
+	let endScan = false
+
+	eachNode(parentNode, function(node){
+		if (endScan) {
+			return false
+    }
+
+		// Ignore anything which isn't a text node
+		if (node.nodeType !== Node.TEXT_NODE) {
+			return
+    }
+
+		if (typeof pattern === "string") {
+			if (-1 !== node.textContent.indexOf(pattern)) {
+				matches.push(node)
+      }
+		}
+		else if (pattern.test(node.textContent)) {
+			if (!pattern.global) {
+				endScan = true
+				matches = node
+			}
+			else {
+        matches.push(node)
+      }
+		}
+	})
+
+	return matches
+}

+
+
For example, to find {{DOMxRef("Text")}} nodes that contain typos:

+
+
const typos = ["teh", "adn", "btu", "adress", "youre", "msitakes"]
+const pattern = new RegExp("\\b(" + typos.join("|") + ")\\b", "gi")
+const mistakes = grep(document.body, pattern)
+console.log(mistakes)
+

+
+
仕様書

+
+{{Specifications}}
+
+
ブラウザーの互換性

 
-onload = function () {
-  DOMComb(document.body, printContent);
-};
- -

ノードに内包されているすべての子ノードを削除する

- -
Element.prototype.removeAll = function () {
-  while (this.firstChild) { this.removeChild(this.firstChild); }
-  return this;
-};
- -

使用例

- -
/* ... an alternative to document.body.innerHTML = "" ... */
-document.body.removeAll();
- -

仕様

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
仕様書策定状況コメント
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}以下のプロパティを削除: attributes、namespaceURI、prefix、localName。
- 以下のメソッドを削除: isSupported()、hasAttributes()、getFeature()、setUserData()、getUserData()。
{{SpecName('DOM3 Core', 'core.html#ID-1950641247', 'Node')}}{{Spec2('DOM3 Core')}}{{domxref("Document")}} で insertBefore()、replaceChild()、removeChild()、appendChild() メソッドを呼び出すと、もうひとつの種類のエラー (NOT_SUPPORTED_ERR) を返します。
- normalize() メソッドを、適切な {{domxref("DOMConfiguration")}} フラグが設定されていれば {{domxref("Text")}} ノードも正規化できるように変更。
- 以下のメソッドを追加: compareDocumentPosition()、isSameNode()、lookupPrefix()、isDefaultNamespace()、lookupNamespaceURI()、isEqualNode()、getFeature()、setUserData()、getUserData()。
- 以下のプロパティを追加: baseURI、textContent。
{{SpecName('DOM2 Core', 'core.html#ID-1950641247', 'Node')}}{{Spec2('DOM2 Core')}}ownerDocument プロパティを、{{domxref("DocumentFragment")}} が null も返すように若干変更。
- 以下のプロパティを追加: namespaceURI、prefix、localName。
- 以下のメソッドを追加: normalize()、isSupported()、hasAttributes()。
{{SpecName('DOM1', 'level-one-core.html#ID-1950641247', 'Node')}}{{Spec2('DOM1')}}初期定義
- -

ブラウザー実装状況

- -

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

+

{{Compat}}

-- cgit v1.2.3-54-g00ecf