節点 (DOM、SGML、XML)

[24] DOM、HTML、XML、XDM、SGML 特性集合における節点 (ノード) (node) は、マーク付け言語やそれに対応するデータモデルにおける木やグラフの構造における情報の単位です。

節点 (DOM)

[1] Node 界面は、 DOM で最も重要なデータ型です。これは文書木中の一つの節 (ノード) を表します。 (但し実際的には Node 型そのものの節の実現値は存在せず、 Node を継承した、例えば Element 型の節として存在します。)

[2] Node 界面の method などの中には、特定種類の節に対しては意味を成さないものもあります。そうしたものは null や例外が返されるかもしれません。 (それぞれ個々の場合ごとに決まっています。)

継承関係

[13] Node インターフェイスは EventTarget インターフェイスを継承しています。

[14] Node インターフェイスを継承した主たるインターフェイスとして ParentNode と ChildNode があります。 DOM Standard で定義されている節点はすべてこのいずれか(のみ)を継承しています。

[15] この2つは DOM Standard で追加されたので、 DOM3 以前はありませんでした。 DOM3 までは Node を継承していて今は継承していない Attr と、 DOM3 まではあって今は廃止された Entity, EntityReference, Notation, XPathNamespace、 DOMDTDEF (非標準) の ElementTypeDefinition, AttributeDefinition はどちらも継承していません。 DOM3 まであって DOM Standard で廃止された CDATASection は Text を継承しているので、 (仮に現在もあれば) ChildNode を継承することになります。

状態

[33]

節点文書: 当該節点が所属する文書です。
文書中: 根が文書かどうかを表します。
根を含む文書中: 影を含む根が文書かどうかを表します。

[34] 他に、節点の種別に依存した状態を持ちます。

各項を参照。

メンバー

[35]

isConnected

定数群	`NodeType`:
定数	`ELEMENT_NODE` := 1	要素節	[DOM1]
定数	`ATTRIBUTE_NODE` := 2	属性節	[DOM1]
定数	`TEXT_NODE` := 3	文節	[DOM1]
定数	`CDATA_SECTION_NODE` := 4	文字データ区間節	[DOM1]
定数	`ENTITY_REFERENCE_NODE` := 5	実体参照節	[DOM1]
定数	`ENTITY_NODE` := 6	実体節	[DOM1]
定数	`PROCESSING_INSTRUCTION_NODE` := 7	処理指令節	[DOM1]
定数	`COMMENT_NODE` := 8	注釈節	[DOM1]
定数	`DOCUMENT_NODE` := 9	文書節	[DOM1]
定数	`DOCUMENT_TYPE_NODE` := 10	文書型節	[DOM1]
定数	`DOCUMENT_FRAGMENT_NODE` := 11	文書断片節	[DOM1]
定数	`NOTATION_NODE` := 12	記法節	[DOM1]
定数	200 まで (up to)	(W3C が予約)	[DOM2]
`all`	`HTMLElement` (WinIE 4)
`children`	`HTMLElement` (WinIE 4)
`contains`	`HTMLElement` (WinIE 4)
`document`	`HTMLElement` (WinIE 4)
読取専用属性	`nodeName`	節名	[DOM1]
読取専用属性	`localName`	局部名	[DOM2]
読取専用属性	`namespaceURI`	名前空間名	[DOM2]
属性	`prefix`	名前空間接頭辞	[DOM2]
属性	`nodeValue`	節値	[DOM1]
読取専用属性	`nodeType`	節型	[DOM1]
読取専用属性	`parentNode`	親節	[DOM1]
読取専用属性	`childNodes`	子節達	[DOM1]
`children`	`HTMLElement` (Trident)
読取専用属性	`firstChild`	最初の子節	[DOM1]
読取専用属性	`lastChild`	最後の子節	[DOM1]
読取専用属性	`previousSibling`	すぐ兄の節	[DOM1]
`parentElement`	`HTMLElement` (WinIE 4)
読取専用属性	`nextSibling`	すぐ弟の節	[DOM1]
読取専用属性	`attributes`	属性達	[DOM1]
読取専用属性	`ownerDocument`	所属文書	[DOM1], [DOM2]
method	`insertBefore`	直前に節挿入	[DOM1]

method	`replaceChild`	子節を置換	[DOM1]
method	`removeChild`	子節を削除	[DOM1]
`swapNode`	`DOMNode` (Trident)
method	`appendChild`	子節を付加	[DOM1]
method	`hasChildNodes`	子節を持つか	[DOM1]
method	`hasAttributes`	属性を持つか	[DOM2]
method	`cloneNode`	節を複製	[DOM1]
method	`normalize`	正規化	[DOM2]
method	`isSupported`	機能対応有無	[DOM2]

[DOM1] Document Object Model (Core) Level 1 <http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-1950641247>
[DOM2] Document Object Model Core <http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1950641247>
[3] Node の集まりの型として、 NodeList と NamedNodeMap があります。
[4] Method normalize は、 DOM 1 では界面 Element で定義されていたものが DOM 2 で移動してきました。
[5] >>4 属性節で使えないのは不便だしね。てかそれだけ?
[6] >>5 他の一部の節にしか適用できないのが Node で定義されている (nodeValue とか。) のを見ると、どうやら複数の継承先で定義するよりはまとめて単一の継承元で定義しとこうという考えなのでしょう。

[7]

Interface NodeExtended
  Attributes
    isBlankNode of type boolean
      Whether the node is blank or not.
      
      @@ What is _blank_?  How different from "hasChildNodes"?
      
      Source: PHP
    offset of type long
      The child index of the node within its parent.
      (?? If the node does not have a parent,
          "-1" is returned.  If the node is the
          first child, "0" is returned. ??)
      Source: eDOM
    parentElement of type Element
      Nearest ancestor or self node which is an element node.
      (?? If there is no ancestor or self node whose
          type is element, the value is "null". ??)
      (?? For Attr, ? is returned. ??)
      Source: WinIE, Safari, eDOM
    removeChildOnly
      Replaces a child node by its children.  In other word,
      removes a node but not the descendants of that node.
      Source: eDOM [defined for Element]
      
      Parameters
        oldChild of type Node
          A node to remove.
      Return Value
        Node      "oldChild" is returned.
      Exceptions
        DOMException HIERARCHY_ERR, NO_MODIFICATION_ALLOWED_ERR
    replaceChildOnly
      Replaces a child node by another node and moves
      the children of the original node into the new node.
      Attributes of the original node are copied to
      the new one if the nodes are elements.
      (?? oldChild and newChild is different type ??)
      Source: eDOM [defined for Element]
      Parameters
        oldChild of type Node
          Child node to replace.
          (?? childToReplace in eDOM ??)
        newChild of type Node
          New child node to replace by.
          (?? newChildName (XHTML local element type name)
              of type DOMString in eDOM ??)
  Methods
    addNamespace
      Adds a namespace declaration attribute to a node.
      
      @@ What if already exist? overwrites?
      
      Source: PHP
      Parameters
        namespaceURI of type DOMString
        prefix of type DOMString
      No Return Value
    descendant
      Returns whether a node is ancestor of the node.
      Source: eDOM
      
      Parameters
        possibleAncestor of type Node
          A node that could be the ancestor of this node.
          (?? eDOM restricts to "element node". ??)
      Return Value
        boolean "true" if "possibleAncestor" is the
                ancestor of this node; "false" otherwise.
                (?? "false" if "possibleAncestor" is 
                    this node itself. ??)
      No Exceptions

[8] IE6 はノードに追加したオレオレプロパティが消せない(delete document.body.hoge が出来ない) - latest log (2010-01-01 12:50:06 +09:00 版) <http://d.hatena.ne.jp/uupaa/20090924/1253734273>

[16] 911477 – Implement DOM4 methods: prepend(), append(), before(), after() and replace() ( (2014-09-30 04:33:55 +09:00 版)) <https://bugzilla.mozilla.org/show_bug.cgi?id=911477>