Node
Node
는 여러 가지 DOM 타입들이 상속하는 인터페이스이며 그 다양한 타입들을 비슷하게 처리할 수 있게 한다. 예를들어, 똑같은 메소드를 상속하거나 똑같은 방식으로 테스트를 할수있다
다음의 인터페이스들은 모두 Node
로부터 메소드와 프라퍼티를 상속한다: Document
, Element
, CharacterData
(Text
, Comment
, CDATASection
(en-US)이 상속), ProcessingInstruction
(en-US), DocumentFragment
, DocumentType
, Notation
, Entity
, EntityReference
이 인터페이스들은 메소드나 프라퍼티가 적합하지 않은 경우에 null
을 반환할 수 있다. 그들은 예외를 발생할 수 있다 - 예를 들어 자식이 있을 수 없는 노드 타입에 자식을 추가할 때 말이다.
프라퍼티 <속성>
부모인 EventTarget
으로부터 프라퍼티를 상속한다.[1]
Node.baseURI
(en-US) 읽기 전용- : Returns a
DOMString
representing the base URL. The concept of base URL changes from one language to another; in HTML, it corresponds to the protocol, the domain name and the directory structure, that is all until the last'/'
.
- : Returns a
Node.baseURIObject
(en-US) 비표준- : (Not available to web content.) The read-only
nsIURI
object representing the base URI for the element.
- : (Not available to web content.) The read-only
Node.childNodes
읽기 전용Node.firstChild
읽기 전용- : Returns a
Node
representing the first direct child node of the node, ornull
if the node has no child.
- : Returns a
Node.lastChild
읽기 전용- : Returns a
Node
representing the last direct child node of the node, ornull
if the node has no child.
- : Returns a
Node.localName
(en-US) 지원이 중단되었습니다 읽기 전용-
: Returns a
DOMString
representing the local part of the qualified name of an element. In Firefox 3.5 and earlier, the property upper-cases the local name for HTML elements (but not XHTML elements). In later versions, this does not happen, so the property is in lower case for both HTML and XHTML. Though recent specifications requirelocalName
to be defined on theElement
interface, Gecko-based browsers still implement it on theNode
interface.
-
: Returns a
Node.namespaceURI
(en-US) 지원이 중단되었습니다 읽기 전용-
: The namespace URI of this node, or
null
if it is no namespace. In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in thehttp://www.w3.org/1999/xhtml
namespace in both HTML and XML trees. Though recent specifications requirenamespaceURI
to be defined on theElement
interface, Gecko-based browsers still implement it on theNode
interface.
-
: The namespace URI of this node, or
Node.nextSibling
읽기 전용- : Returns a
Node
representing the next node in the tree, ornull
if there isn't such node.
- : Returns a
Node.nodeName
(en-US) 읽기 전용- : Returns a
DOMString
containing the name of theNode
. The structure of the name will differ with the name type. E.g. AnHTMLElement
will contain the name of the corresponding tag, like'audio'
for anHTMLAudioElement
(en-US), aText
node will have the'#text'
string, or aDocument
node will have the'#document'
string.
- : Returns a
Node.nodePrincipal
(en-US) 비표준- : A
nsIPrincipal
representing the node principal.
- : A
Node.nodeType
(en-US)읽기 전용-
: Returns an unsigned short
representing the type of the node. Possible values are:Name Value 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
(en-US)- : Is a
DOMString
representing the value of an object. For mostNode
type, this returnsnull
and any set operation is ignored. For nodes of typeTEXT_NODE
(Text
objects),COMMENT_NODE
(Comment
objects), andPROCESSING_INSTRUCTION_NODE
(ProcessingInstruction
(en-US) objects), the value corresponds to the text data contained in the object.
- : Is a
Node.ownerDocument
읽기 전용- : Returns the
Document
that this node belongs to. If no document is associated with it, returnsnull
.
- : Returns the
Node.parentNode
(en-US) 읽기 전용- : Returns a
Node
that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returnsnull
.
- : Returns a
Node.parentElement
(en-US) 읽기 전용Node.prefix
(en-US) 지원이 중단되었습니다 읽기 전용Node.previousSibling
읽기 전용- : Returns a
Node
representing the previous node in the tree, ornull
if there isn't such node.
- : Returns a
Node.textContent
- : Is a
DOMString
representing the textual content of an element and all its descendants.
- : Is a
메소드
부모인 EventTarget
으로부터 메소드를 상속한다.[1]
Node.appendChild()
-
Adds the specified
childNode
argument as the last child to the current node. If the argument referenced an existing node on the DOM tree, the node will be detached from its current position and attached at the new position. Node.cloneNode()
-
Clone a
Node
, and optionally, all of its contents. By default, it clones the content of the node. Node.compareDocumentPosition()
(en-US)-
Compares the position of the current node against another node in any other document.
Node.contains()
-
Returns
true
orfalse
value indicating whether or not a node is a descendant of the calling node. Node.getRootNode()
(en-US)-
Returns the context object's root which optionally includes the shadow root if it is available.
Node.hasChildNodes()
-
Returns a boolean value indicating whether or not the element has any child nodes.
Node.insertBefore()
-
Inserts a
Node
before the reference node as a child of a specified parent node. Node.isDefaultNamespace()
(en-US)-
Accepts a namespace URI as an argument and returns a boolean value with a value of
true
if the namespace is the default namespace on the given node orfalse
if not. Node.isEqualNode()
(en-US)-
Returns a boolean value which indicates whether or not two nodes are of the same type and all their defining data points match.
Node.isSameNode()
(en-US)-
Returns a boolean value indicating whether or not the two nodes are the same (that is, they reference the same object).
Node.lookupPrefix()
(en-US)-
Returns a string containing the prefix for a given namespace URI, if present, and
null
if not. When multiple prefixes are possible, the result is implementation-dependent. Node.lookupNamespaceURI()
(en-US)-
Accepts a prefix and returns the namespace URI associated with it on the given node if found (and
null
if not). Supplyingnull
for the prefix will return the default namespace. Node.normalize()
-
Clean up all the text nodes under this element (merge adjacent, remove empty).
Node.removeChild()
(en-US)-
Removes a child node from the current element, which must be a child of the current node.
Node.replaceChild()
-
Replaces one child
Node
of the current one with the second one given in parameter.
예제
모든 자식 노드 탐색
The following function recursively cycles all child nodes of a node and executes a callback function upon them (and upon the parent node itself).
function DOMComb (oParent, oCallback) {
if (oParent.hasChildNodes()) {
for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
DOMComb(oNode, oCallback);
}
}
oCallback.call(oParent);
}
Syntax
DOMComb(parentNode, callbackFunction);
Description
Recursively cycle all child nodes of parentNode
and parentNode
itself and execute the callbackFunction
upon them as this
objects.
Parameters
parentNode
-
The parent node (
Node Object
). callbackFunction
-
The callback function (
Function
).
Sample usage
The following example send to the console.log
the text content of the body:
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;
};
Sample usage
/* ... an alternative to document.body.innerHTML = "" ... */
document.body.removeAll();
명세
Specification |
---|
DOM Standard # interface-node |
브라우저 호환성
BCD tables only load in the browser