Node

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

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

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

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

プロパティ

親である EventTarget からプロパティを継承します。^[1]

Node.baseURI 読取専用

ベース URL を表す DOMString を返します。ベース URL の概念は、言語によって変わります。HTML ではプロトコル、ドメイン名、ディレクトリー構造に対応しており、最後の '/' までのすべてになります。

Node.baseURIObject

(ウェブコンテンツでは使用できません) 要素のベース URI を表す、読み取り専用の nsIURI オブジェクトを返します。

Node.childNodes 読取専用

このノードのすべての子孫を含む、生きている NodeList を返します。NodeList が生きているとは、Node の子が変化すれば自動的に NodeList オブジェクトが更新されることを意味します。

Node.firstChild 読取専用

ノードの直下の最初の子ノードを表す Node を返します。子が存在しなければ null を返します。

Node.isConnected 読取専用

ノードが(直接/関節的に)コンテキストオブジェクトに接続されているかを示す論理値。例えば通常の DOM の場合は Document オブジェクト、あるいはシャドーDOM の場合は ShadowRoot。

Node.lastChild 読取専用

ノードの直下の最後の子ノードを表す Node を返します。子が存在しなければ null を返します。

Node.nextSibling 読取専用

ツリー構造で次のノードを表す Node を返します。該当するノードがない場合は null を返します。

Node.nodeName 読取専用

Node の名前を持つ DOMString を返します。名前の構造は、ノードの型によって異なります。例えば、HTMLElement は HTMLAudioElement に対して 'audio' というように対応するタグの名前、Text ノードは '#text' という文字列、Document ノードは '#document' という文字列になります。

Node.nodePrincipal

ノードのプリンシパルを表す nsIPrincipal を返します。

Node.nodeType読取専用

ノードの型を表す unsigned short を返します。使用できる値:

名称	値
ELEMENT_NODE	1
ATTRIBUTE_NODE	2
TEXT_NODE	3
CDATA_SECTION_NODE	4
ENTITY_REFERENCE_NODE	5
ENTITY_NODE	6
PROCESSING_INSTRUCTION_NODE	7
COMMENT_NODE	8
DOCUMENT_NODE	9
DOCUMENT_TYPE_NODE	10
DOCUMENT_FRAGMENT_NODE	11
NOTATION_NODE	12

Node.nodeValue

カレントノードの値を取得または設定します。

Node.ownerDocument 読取専用

ノードが所属する Document を返します。ノードが document 自身の場合は、null を返します。

Node.parentNode 読取専用

このノードの親の Node を返します。ノードがツリーの最上位である、あるいはツリーに加わっていないなど、親が存在しない場合は null を返します。

Node.parentElement 読取専用

このノードの親の Element を返します。ノードに親が存在しない、あるいは親が Element ではない場合は、null を返します。

Node.previousSibling 読取専用

ツリー構造で前のノードを表す Node を返します。該当するノードがない場合は null を返します。

Node.textContent

要素や要素のすべての子孫のテキストコンテンツを取得または設定します。

非推奨プロパティ

Node.rootNode 読取専用

ツリーの最上位ノードを表す Node オブジェクトを返します。自身がツリーの最上位ノードである場合はカレントノードを返します。これは Node.getRootNode() に置き換えられました。

廃止プロパティ

Node.localName 読取専用

要素の修飾名のローカル部分を表す DOMString を返します。

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

Node.namespaceURI 読取専用

ノードの名前空間の URI。名前空間がない場合は null になります。

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

Node.prefix 読取専用

ノードの名前空間の接頭辞を表す DOMString を返します。接頭辞が指定されていない場合は null を返します。

メソッド

親である EventTarget からメソッドを継承します。^[1]

Node.appendChild()

カレントノードの最後の子として、指定した childNode 引数を追加します。
引数が DOM ツリー上の既存のノードを参照している場合は、ノードが現在の位置から外されて新しい位置に追加されます。

Node.cloneNode()

Node を複製します。また、すべての内容物を複製することもできます。デフォルトで、ノードの内容物を複製します。

Node.compareDocumentPosition()

カレントノードの位置を、他のドキュメント内の別のノードと比較します。

Node.contains()

ノードが指定したノードの子孫であるか否かを示す Boolean 値を返します。

Node.getRootNode()

コンテキストオブジェクトのルートを返します。任意で、shadow root が使用可能である場合にそれを含めることができます。

Node.hasChildNodes()

要素が子ノードを持っているか否かを示す Boolean を返します。

Node.insertBefore()

カレントノードの子として、参照先ノードの前に Node を挿入します。

Node.isDefaultNamespace()

引数として名前空間の URI を受け入れて、名前空間が指定したノードのデフォルトの名前空間であれば true、そうでない場合は false である Boolean を返します。

Node.isEqualNode()

2 つのノードが同じ型であり、定義されているすべてのデータポイントが一致するか否かを表す Booleanを返します。

Node.isSameNode()

2 つのノードが同じである (すなわち、同じオブジェクトを参照している) か否かを示す Boolean 値を返します。

Node.lookupPrefix()

指定した名前空間 URI の接頭辞があれば、その接頭辞を含む DOMString を返します。接頭辞がない場合は null を返します。複数の接頭辞がある場合の結果は実装依存です。

Node.lookupNamespaceURI()

接頭辞を受け入れて、指定したノードで接頭辞が関連付けられた名前空間が見つかった場合は名前空間の URI を返します (見つからない場合は null を返します)。接頭辞として null を与えると、デフォルトの名前空間を返します。

Node.normalize()

要素内のすべてのテキストノードをクリーンアップ (隣接ノードを統合、空のノードを削除) します。

Node.removeChild()

カレント要素から子ノードを削除します。カレント要素はカレントノードの子であることが必要です。

Node.replaceChild()

カレントノードの子 Node のひとつを、引数で指定した別のノードで置き換えます。

廃止メソッド

Node.getFeature()

x

Node.getUserData()

ユーザーが、ノードから DOMUserData を取得できます。

Node.hasAttributes()

要素がなんらかの属性を持っているか否かを示す Boolean を返します。

Node.isSupported()

DOM 実装が特定の機能を実装しており、またその機能が指定したノードでサポートされているかを確認して、その結果を表す Boolean を返します。

Node.setUserData()

ユーザーが、ノードに DOMUserData を追加または削除できます。

例

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

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

function DOMComb (oParent, oCallback) {
  if (oParent.hasChildNodes()) {
    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
      DOMComb(oNode, oCallback);
    }
  }
  oCallback.call(oParent);
}

構文

DOMComb(parentNode, callbackFunction);

説明

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

引数

parentNode

親ノード (Node Object)

callbackFunction

コールバック関数 (Function)

用例

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

function printContent () {
  if (this.nodeValue) { console.log(this.nodeValue); }
}

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();

仕様

ブラウザー実装状況

[1] WebKit と古いバージョンの Blink は、誤って Node が EventTarget から継承していません。

[2] Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) で、attributes プロパティを Element に移動しました。

[3] DOM4 標準に従って、プロパティを Element および Attr API に移動しました。