|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
public interface Node
Node
인터페이스는, 문서 객체 모델 전체에 대한 주데이터형이며, 문서 트리내의 단일의 노드를 나타냅니다. Node
인터페이스를 구현하는 모든 객체는 아이를 처리하기 위한 메소드를 가지고 있습니다만,Node
인터페이스를 구현하는 모든 객체가 아이를 가질 수가 있는 것은 아닙니다. 예를 들어,Text
노드는 아이를 가져 안되어, 이러한 노드에 아이를 추가했을 경우, DOMException
가 발생합니다.
nodeName
속성,nodeValue
속성, 및 attributes
속성은, 특정의 파생 인터페이스에 사로 잡히지 않고 노드 정보를 취득하는 메카니즘입니다. Element
에 대해서 nodeValue
,Comment
에 대해서 attributes
와 같이, 이러한 속성이 특정의 nodeType
에 명확하게 매핑되어 있지 않은 경우는 null
를 돌려줍니다. 각종 전용 인터페이스는, 이외에도, 관련 정보를 취득 및 설정하는 편리한 메카니즘을 다수 갖추고 있습니다.
nodeName
,nodeValue
,attributes
의 값은, 이하와 같이 노드형에 따라서 다릅니다.
인터페이스 | nodeName | nodeValue | attributes |
---|---|---|---|
Attr |
Attr.name 와 같다 |
Attr.value 와 같다 |
null |
CDATASection |
"#cdata-section" |
CharacterData.data (CDATA 섹션의 내용)와 같다 |
null |
Comment |
"#comment" |
CharacterData.data (코멘트의 내용)와 같다 |
null |
Document |
"#document" |
null |
null |
DocumentFragment |
"#document-fragment" |
null |
null |
DocumentType |
DocumentType.name 와 같다 |
null |
null |
Element |
Element.tagName 와 같다 |
null |
NamedNodeMap |
Entity |
엔티티명 | null |
null |
EntityReference |
참조되는 엔티티의 이름 |
null |
null |
Notation |
표기 법명 |
null |
null |
ProcessingInstruction |
ProcessingInstruction.target 와 같다 |
ProcessingInstruction.data 와 같다 |
null |
Text |
"#text" |
CharacterData.data (텍스트 노드의 내용)와 같다 |
null |
「Document Object Model (DOM) Level 3 Core Specification」를 참조해 주세요.
필드의 개요 | |
---|---|
static short |
ATTRIBUTE_NODE
노드는 Attr 입니다. |
static short |
CDATA_SECTION_NODE
노드는 CDATASection 입니다. |
static short |
COMMENT_NODE
노드는 Comment 입니다. |
static short |
DOCUMENT_FRAGMENT_NODE
노드는 DocumentFragment 입니다. |
static short |
DOCUMENT_NODE
노드는 Document 입니다. |
static short |
DOCUMENT_POSITION_CONTAINED_BY
노드는 참조 노드에 포함되어 있습니다. |
static short |
DOCUMENT_POSITION_CONTAINS
노드는 참조 노드를 포함합니다. |
static short |
DOCUMENT_POSITION_DISCONNECTED
2 개의 노드는 절단 됩니다. |
static short |
DOCUMENT_POSITION_FOLLOWING
노드는 참조 노드의 후에 계속됩니다. |
static short |
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
선행할까 후에 올까는 구현에 고유합니다. |
static short |
DOCUMENT_POSITION_PRECEDING
2 번째의 노드는 참조 노드의 전에 있습니다. |
static short |
DOCUMENT_TYPE_NODE
노드는 DocumentType 입니다. |
static short |
ELEMENT_NODE
노드는 Element 입니다. |
static short |
ENTITY_NODE
노드는 Entity 입니다. |
static short |
ENTITY_REFERENCE_NODE
노드는 EntityReference 입니다. |
static short |
NOTATION_NODE
노드는 Notation 입니다. |
static short |
PROCESSING_INSTRUCTION_NODE
노드는 ProcessingInstruction 입니다. |
static short |
TEXT_NODE
노드는 Text 노드입니다. |
메소드의 개요 | |
---|---|
Node |
appendChild (Node newChild)
노드 newChild 를 이 노드의 아이의 리스트의 말미에 추가합니다. |
Node |
cloneNode (boolean deep)
노드의 범용 copy constructor로서 이 노드의 복제를 돌려줍니다. |
short |
compareDocumentPosition (Node other)
이 메소드가 불려 가고 있는 참조 노드를, 파라미터로서 건네받는 노드와 문서내의 위치에 관해서 문서순서와 비교합니다. |
NamedNodeMap |
getAttributes ()
이 노드가 Element 의 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다. |
String |
getBaseURI ()
이 노드의 절대 베이스 URI, 구현이 절대 URI 를 취득할 수 없었던 경우는 null 가 됩니다. |
NodeList |
getChildNodes ()
이 노드의 아이를 모두 포함한 NodeList 입니다. |
Object |
getFeature (String feature,
String version)
이 메소드는, 지정한 기능과 버젼을 가지는 특수한 형식의 API 가 지정되었던 대로 구현하는 특수한 형식의 객체를 돌려줍니다. |
Node |
getFirstChild ()
이 노드의 최초의 자식(child) 노드입니다. |
Node |
getLastChild ()
이 노드의 마지막 자식(child) 노드입니다. |
String |
getLocalName ()
이 노드의 수식명의 로컬 부분을 돌려줍니다. |
String |
getNamespaceURI ()
이 노드의 이름 공간 URI. |
Node |
getNextSibling ()
이 노드의 직후의 노드입니다. |
String |
getNodeName ()
이 노드의 이름입니다. |
short |
getNodeType ()
객체의 형태를 나타내는 코드입니다. |
String |
getNodeValue ()
이 노드의 값입니다. |
Document |
getOwnerDocument ()
이 노드에 관련지을 수 있었던 Document 객체입니다. |
Node |
getParentNode ()
이 노드의 친노드입니다. |
String |
getPrefix ()
이 노드의 이름 공간앞치수식자입니다. |
Node |
getPreviousSibling ()
이 노드의 직전의 노드입니다. |
String |
getTextContent ()
이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다. |
Object |
getUserData (String key)
이 노드의 키에 관련지을 수 있었던 객체를 가져옵니다. |
boolean |
hasAttributes ()
이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 판단합니다. |
boolean |
hasChildNodes ()
이 노드가 자식(child) 노드를 가지고 있을지 어떨지를 판단합니다. |
Node |
insertBefore (Node newChild,
Node refChild)
기존의 refChild 자 노드의 전에 newChild 노드를 삽입합니다. |
boolean |
isDefaultNamespace (String namespaceURI)
이 메소드는, 지정된 namespaceURI 가 디폴트의 이름 공간일지 어떨지를 체크합니다. |
boolean |
isEqualNode (Node arg)
2 개의 노드가 동일한지 어떤지를 테스트합니다. |
boolean |
isSameNode (Node other)
이 노드가 지정된 노드와 같은 노드일지 어떨지를 돌려줍니다. |
boolean |
isSupported (String feature,
String version)
DOM 구현이 특정의 기능을 구현하고 있어, 이 노드가 그 기능이 지정되었던 대로 지원하고 있을지 어떨지를 판정합니다. |
String |
lookupNamespaceURI (String prefix)
지정한 노드로부터 개시해, 주어진(given) 접두사에 관련하는 이름 공간 URI 를 검색합니다. |
String |
lookupPrefix (String namespaceURI)
지정된 노드로부터 개시해, 주어진(given) 이름 공간 URI 에 관련하는 접두사를 검색합니다. |
void |
normalize ()
이 Node 의 서브 트리의 최심부까지 존재하는 모든 Text 노드 (속성 노드를 포함한다)를,Text 노드가 구조 (요소, 코멘트, 처리 명령, CDATA 섹션, 엔티티 참조등)에만 따라 분리되는, 「일반적으로」형식으로 고칩니다. |
Node |
removeChild (Node oldChild)
아이 리스트로부터 oldChild 로 나타나는 자식(child) 노드를 삭제해, 이 자식(child) 노드를 돌려줍니다. |
Node |
replaceChild (Node newChild,
Node oldChild)
아이 리스트안의 자식(child) 노드 oldChild 를 newChild 로 옮겨놓아oldChild 노드를 돌려줍니다. |
void |
setNodeValue (String nodeValue)
이 노드의 값입니다. |
void |
setPrefix (String prefix)
이 노드의 이름 공간앞치수식자입니다. |
void |
setTextContent (String textContent)
이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다. |
Object |
setUserData (String key,
Object data,
UserDataHandler handler)
이 노드의 키에 객체를 관련짓습니다. |
필드의 상세 |
---|
static final short ELEMENT_NODE
Element
입니다.
static final short ATTRIBUTE_NODE
Attr
입니다.
static final short TEXT_NODE
Text
노드입니다.
static final short CDATA_SECTION_NODE
CDATASection
입니다.
static final short ENTITY_REFERENCE_NODE
EntityReference
입니다.
static final short ENTITY_NODE
Entity
입니다.
static final short PROCESSING_INSTRUCTION_NODE
ProcessingInstruction
입니다.
static final short COMMENT_NODE
Comment
입니다.
static final short DOCUMENT_NODE
Document
입니다.
static final short DOCUMENT_TYPE_NODE
DocumentType
입니다.
static final short DOCUMENT_FRAGMENT_NODE
DocumentFragment
입니다.
static final short NOTATION_NODE
Notation
입니다.
static final short DOCUMENT_POSITION_DISCONNECTED
static final short DOCUMENT_POSITION_PRECEDING
static final short DOCUMENT_POSITION_FOLLOWING
static final short DOCUMENT_POSITION_CONTAINS
static final short DOCUMENT_POSITION_CONTAINED_BY
static final short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
메소드의 상세 |
---|
String getNodeName()
String getNodeValue() throws DOMException
null
라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.
DOMException
- DOMSTRING_SIZE_ERR:반환되는 문자수가 너무 많아서
구현 플랫폼상의 DOMString
변수에 들어가지 않는 경우void setNodeValue(String nodeValue) throws DOMException
null
라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.
DOMException
- NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우, 및
null
이다고 정의되어 있지 않은 경우short getNodeType()
Node getParentNode()
Attr
,Document
,DocumentFragment
,Entity
,Notation
를 제외하는 모든 노드는, 친노드를 가질 가능성이 있습니다. 다만, 노드가 작성되었던 바로 직후로 아직 트리에 추가되어 있지 않은 경우나 트리로부터 삭제되었을 경우는 null
가 돌려주어집니다.
NodeList getChildNodes()
NodeList
입니다. 아이가 존재하지 않는 경우, 노드를 가지지 않는 NodeList
가 돌려주어집니다.
Node getFirstChild()
null
가 돌려주어집니다.
Node getLastChild()
null
가 돌려주어집니다.
Node getPreviousSibling()
null
가 돌려주어집니다.
Node getNextSibling()
null
가 돌려주어집니다.
NamedNodeMap getAttributes()
Element
의 경우, 이 노드의 속성을 포함한 NamedNodeMap
입니다. 그 이외의 경우는 null
입니다.
Document getOwnerDocument()
Document
객체입니다. 이것은, 새로운 노드를 작성하는 Document
객체이기도 합니다. 이 노드가 아직 어느 Document
에서도 사용되어 있지 않은 Document
또는 DocumentType
인 경우,null
가 됩니다.
Node insertBefore(Node newChild, Node refChild) throws DOMException
refChild
자 노드의 전에 newChild
노드를 삽입합니다. refChild
가 null
의 경우, 아이 리스트의 마지막에 newChild
를 삽입합니다. newChild
가 DocumentFragment
객체인 경우는, 객체의 모든 아이가 같은 순서로 refChild
의 전에 삽입됩니다. newChild
가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.
주: 노드를 노드 자체의 전에 삽입하는 경우는 구현에 의존합니다.
newChild
- 삽입되는 노드refChild
- 참조 노드. 새로운 노드는 이 노드의
직전에 삽입된다
DOMException
- HIERARCHY_REQUEST_ERR:이 노드가 newChild
노드형의 아이를
허가하지 않는 형태의 노드인 경우,
삽입하는 노드가 이 노드의 조상의 1 개 또는 이 노드 자체인 경우,
혹은 이 노드가 Document
형의 노드이며,
한편 DOM 어플리케이션이 제 2 의
DocumentType
또는 Element
노드를 삽입하려고 했을 경우
newChild
가
이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
refChild
가 이 노드의 자식(child) 노드
(이)가 아닌 경우
Document
형인 경우.
또, DOM 구현이 DocumentType
또는 Element
노드의
삽입을 지원하고 있지 않는 경우에도 이 예외가 throw 된다
가능성이 있는Node replaceChild(Node newChild, Node oldChild) throws DOMException
oldChild
를 newChild
로 옮겨놓아oldChild
노드를 돌려줍니다. newChild
가 DocumentFragment
객체인 경우,oldChild
는,DocumentFragment
의 모든 아이로 옮겨집니다. 모든 아이는, 같은 순서로 삽입됩니다. newChild
가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.
주: 노드를 노드 자체에 옮겨놓는 경우는 구현에 의존합니다.
newChild
- 자 리스트에 삽입하는 새로운 노드oldChild
- 치환의 대상이 되는 리스트내의 노드
DOMException
- HIERARCHY_REQUEST_ERR:이 노드가 newChild
노드형의 아이를
허가하지 않는 형태의 노드인 경우,
또는 삽입하는 노드가 이 노드의 조상의 1 개 또는 이 노드 자체인 경우,
혹은 이 노드가 Document
형의 노드이며,
옮겨놓은 결과,Document
에 제 2 의
DocumentType
또는 Element
노드를 추가
하게 되는 경우
newChild
가
이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
oldChild
가 이 노드의 자식(child) 노드
(이)가 아닌 경우
Document
형인 경우.
또, DOM 구현이 DocumentType
의 아이 또는 Element
의 아이의
치환을 지원하고 있지 않는 경우에도 이 예외가 throw 된다
가능성이 있는Node removeChild(Node oldChild) throws DOMException
oldChild
로 나타나는 자식(child) 노드를 삭제해, 이 자식(child) 노드를 돌려줍니다.
oldChild
- 삭제되는 노드
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
oldChild
가 이 노드의 자식(child) 노드
(이)가 아닌 경우
Document
형인 경우.
또, DOM 구현이 DocumentType
의 아이 또는 Element
의 아이의
삭제를 지원하고 있지 않는 경우에도 이 예외가 throw 된다
가능성이 있는Node appendChild(Node newChild) throws DOMException
newChild
를 이 노드의 아이의 리스트의 말미에 추가합니다. newChild
가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.
newChild
- 추가하는 노드. 추가하는 노드가
DocumentFragment
객체인 경우,
문서 fragment의 전컨텐츠가 이 노드의 아이 리스트로 이동한다
DOMException
- HIERARCHY_REQUEST_ERR:이 노드가 newChild
노드형의 아이를
허가하지 않는 형태의 노드인 경우,
또는 추가하는 노드가 이 노드의 조상의 1 개 또는 이 노드 자체인 경우,
혹은 이 노드가 Document
형의 노드이며,
한편 DOM 어플리케이션이 제 2 의
DocumentType
또는 Element
노드를 추가하려고 했을 경우
newChild
가
이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
newChild
노드가
Document
노드의 아이인 경우.
또, DOM 구현이 DocumentType
의 아이 또는 Element
의 아이의 삭제를
지원하고 있지 않는 경우에도 이 예외가 throw 될 가능성이 있는boolean hasChildNodes()
true
,
없는 경우는 false
Node cloneNode(boolean deep)
parentNode
가 null
), 사용자 데이터를 가지지 않습니다. 임포트 되고 있는 노드에 관련하는 사용자 데이터는 미루어지지 않습니다. 다만, 관련하는 데이터와 함께 UserDataHandlers
가 지정되었을 경우, 핸들러는 이 메소드가 돌려주기 전에 해당하는 파라미터와 함께 불려 갑니다. Element
를 복제하면(자), 그 속성 전부 및 그러한 속성치 (XML 프로세서에 의해 생성된 것을 포함한다)가 카피되어 디폴트의 속성이 됩니다. 다만, 이 메소드는, Element 에 포함되는 아이는, 깊은 복제를 실시하지 않는 한 카피되지 않습니다. 아이 Text
노드에는 텍스트가 포함되므로, 이 텍스트에는 Element
에 포함되는 텍스트도 포함됩니다. Element
의 복제의 일환으로서가 아니고,Attr
를 직접 복제하면(자), 지정된 속성이 돌려주어집니다 (specified
는 true
). Attr
를 복제하면(자), 아이가 Attr 의 값을 나타내므로, 복제의 심도에 관계없이, Attr 의 아이가 항상 복제됩니다. EntityReference
를 복제하면(자), 복제의 심도에 관계없이, 대응하는 Entity
가 존재하는 경우는 자동적으로 EntityReference 서브 트리가 작성됩니다. 다른 형태의 노드를 복제하면(자), 이 노드의 카피가 돌려주어집니다. EntityReference
의 복제의 아이는 읽어내 전용이 됩니다. 또, 미지정의 Attr
노드의 복제가 지정됩니다. Document
,DocumentType
,Entity
,Notation
의 각 노드의 복제는 구현에 의해 다릅니다.
deep
- true
의 경우는 지정된 노드의 서브 트리를 재귀적으로 복제해,
false
의 경우, 지정된 노드만을 복제.
지정된 노드가 Element
인 경우는, 그 속성도 복제
void normalize()
Node
의 서브 트리의 최심부까지 존재하는 모든 Text
노드 (속성 노드를 포함한다)를,Text
노드가 구조 (요소, 코멘트, 처리 명령, CDATA 섹션, 엔티티 참조등)에만 따라 분리되는, 「일반적으로」형식으로 고칩니다. 그 결과, 인접하는Text
노드도 빈 상태(empty)의 Text
노드도 존재하지 않는 상태가 됩니다. 이 조작은, 문서의 DOM 뷰를 보존 후 다시 로드한 상태로 할 수 있다고 하는 점으로써, 특정의 문서 트리 구조에 의존하는 조작 (XPointer「XPointer」룩 업등)을 실시할 필요가 있는 경우에 편리합니다. Node.ownerDocument
에 추가된 DOMConfiguration
객체의 normalize-characters 파라미터가 true
의 경우, 이 메소드는 Text
노드의 문자의 완전한 정규화도 실시합니다.
주: 문서가 CDATASections
를 포함한 경우, 정규화 조작만으로는 충분하지 않을 가능성이 있습니다. 이것은, XPointer 가 Text
노드와 CDATASection
노드를 구별하지 않기 때문입니다.
boolean isSupported(String feature, String version)
feature
- 테스트하는 기능의 이름version
- 테스트하는 기능의 버젼 번호
true
,
그렇지 않은 경우는 false
String getNamespaceURI()
null
가 됩니다. ELEMENT_NODE
와 ATTRIBUTE_NODE
이외의 형태의 노드와Document.createElement()
등의 DOM 레벨 1 메소드로 작성된 노드에 대해서는, 항상 null
가 돌려주어집니다.
주: XML 스펙의 XML 이름 공간의 규정에 의하면, 속성은, 그 접속처 요소로부터 이름 공간을 상속하지 않습니다. 속성에 대해서 명시적으로 이름 공간을 지정하지 않는 한, 그 속성은 이름 공간을 가지지 않게 됩니다.
String getPrefix()
null
가 됩니다. null
라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다. nodeName
속성이 변경됩니다. 이 속성은,Element
인터페이스와 Attr
인터페이스의 tagName
및 name
속성과 함께, 수식명을 가지고 있습니다 (그것이 적절한 경우). 접두사를 null
로 설정하면(자), 접두사는 지정되지 않습니다. 또, 빈 상태(empty)의 캐릭터 라인으로 설정하는 것은 구현 의존입니다. namespaceURI
와 localName
가 그대로이므로, 디폴트 값와 원의 전치수식자를 가지는 새로운 속성은 작성되지 않습니다. ELEMENT_NODE
와ATTRIBUTE_NODE
이외의 형태의 노드와Document
인터페이스의 createElement
와 같이 DOM 레벨 1 메소드로 작성된 노드에 대해서는, 항상 null
가 돌려주어집니다.
void setPrefix(String prefix) throws DOMException
null
가 됩니다. null
라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다. nodeName
속성이 변경됩니다. 이 속성은,Element
인터페이스와 Attr
인터페이스의 tagName
및 name
속성과 함께, 수식명을 가지고 있습니다 (그것이 적절한 경우). 접두사를 null
로 설정하면(자), 접두사는 지정되지 않습니다. 또, 빈 상태(empty)의 캐릭터 라인으로 설정하는 것은 구현 의존입니다. namespaceURI
와 localName
가 그대로이므로, 디폴트 값와 원의 전치수식자를 가지는 새로운 속성은 작성되지 않습니다. ELEMENT_NODE
와ATTRIBUTE_NODE
이외의 형태의 노드와Document
인터페이스의 createElement
와 같이 DOM 레벨 1 메소드로 작성된 노드에 대해서는, 항상 null
가 돌려주어집니다.
DOMException
- INVALID_CHARACTER_ERR:지정된 접두사에, 사용중의 XML 버젼
(Document.xmlVersion
속성으로 지정)(으)로 정해져 있다
부정한 문자가 포함되어 있는 경우
prefix
가
XML 스펙의 이름 공간의 정의에 따른 것 나오지 않는 경우,
이 노드의 namespaceURI
가 null
의 경우,
지정된 접두사가 「xml」이며, 한편 이 노드의 namespaceURI
가
「http://www.w3.org/XML/1998/namespace」란 다른 경우, 이 노드가 속성이며, 지정된 접두사가 「xmlns」이며,
이 노드의 namespaceURI
가「http://www.w3.org/2000/xmlns/」(이)란 다른 경우, 또는 이 노드가 속성이며, 이 노드의 qualifiedName
가
「xmlns」의「XML 이름 공간」인 경우
. String getLocalName()
ATTRIBUTE_NODE
이외의 형태의 노드와Document.createElement()
등의 DOM 레벨 1 메소드로 작성된 노드에 대해서는, 항상 null
가 돌려주어집니다.
boolean hasAttributes()
true
,
그렇지 않은 경우는 false
String getBaseURI()
null
가 됩니다. 이 값은, 설명에 따라 계산됩니다. 다만,Document
가 「HTML」기능「DOM Level 2 HTML」를 지원하는 경우, 베이스 URI 는, 우선 HTML BASE 요소의 href 속성의 값 (존재하는 경우)을 사용해 계산되어 그렇지 않은 경우는 Document
인터페이스의 documentURI
속성의 값을 사용해 계산됩니다.
short compareDocumentPosition(Node other) throws DOMException
other
- 참조 노드와 비교하는 노드
DOMException
- NOT_SUPPORTED_ERR:비교 대상 노드가,
일관한 구현 고유의 결과를 돌려주도록(듯이) 조정하지 않는다
다른 DOM 구현의 노드인 경우String getTextContent() throws DOMException
null
에 정의했을 경우, 설정에 의한 영향은 없습니다. 설정에서는, 이 노드가 가질 수가 있는 생각되는 아이는 모두 삭제되어 새로운 캐릭터 라인이 빈 상태(empty) 또는 null
인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text
노드로 옮겨집니다. Text.isElementContentWhitespace
속성을 참조). 같이 설정에서는, 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다. 노드형 | 컨텐츠 |
---|---|
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE | COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든 자식(child) 노드의 textContent 속성치의 연결. 노드가 아이를 가지지 않는 경우는, 빈 상태(empty)의 캐릭터 라인 |
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE | nodeValue |
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE | null |
DOMException
- DOMSTRING_SIZE_ERR:반환되는 문자수가 너무 많아서
구현 플랫폼상의 DOMString
변수에 들어가지 않는 경우void setTextContent(String textContent) throws DOMException
null
에 정의했을 경우, 설정에 의한 영향은 없습니다. 설정에서는, 이 노드가 가질 수가 있는 생각되는 아이는 모두 삭제되어 새로운 캐릭터 라인이 빈 상태(empty) 또는 null
인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text
노드로 옮겨집니다. Text.isElementContentWhitespace
속성을 참조). 같이 설정에서는, 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다. 노드형 | 컨텐츠 |
---|---|
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE | COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든 자식(child) 노드의 textContent 속성치의 연결. 노드가 아이를 가지지 않는 경우는, 빈 상태(empty)의 캐릭터 라인 |
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE | nodeValue |
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE | null |
DOMException
- NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우boolean isSameNode(Node other)
Node
참조가 같은 객체를 참조할지 어떨지를 판정할 수 있습니다. 2 개의 Node
참조가 같은 객체를 참조하는 경우는, 프록시를 통한 참조의 경우에서도, 모든 속성이 같은 값을 가져, 어느 쪽인가의 참조의 같은 DOM 메소드의 호출이 항상 완전히 같은 효과를 발휘하도록(듯이), 참조를 완전하게 교대로 사용할 수 있습니다.
other
- 테스트 대상의 노드
true
,
그렇지 않은 경우는 false
String lookupPrefix(String namespaceURI)
namespaceURI
- 검색하는 이름 공간 URI
null
. 복수의 접두사가 이름 공간 접두사에 관련지을 수 있고 있는 경우,
반환되는 이름 공간 접두사는 구현에
응해 다른boolean isDefaultNamespace(String namespaceURI)
namespaceURI
가 디폴트의 이름 공간일지 어떨지를 체크합니다.
namespaceURI
- 검색하는 이름 공간 URI
namespaceURI
가 디폴트의
이름 공간인 경우는 true
,
그렇지 않은 경우는 false
String lookupNamespaceURI(String prefix)
prefix
- 검색하는 접두사. 이 파라미터가
null
의 경우, 메소드는 디폴트의 이름 공간 URI 를 돌려준다
(존재하는 경우)
null
boolean isEqualNode(Node arg)
Node.isSameNode()
를 사용해 테스트할 수 있는 노드의 동일성 (2 개의 노드가 같은 객체를 참조할지 어떨지)은 아니고 동등성을 테스트합니다. 같다 모든 노드는 동등하기도 합니다만, 그 역은 반드시 들어맞지 않습니다. nodeName
,localName
,namespaceURI
,prefix
,nodeValue
가 동일하다. 즉, 2 개의 노드가 null
인지, 같은 길이를 가져, 동일 문자의 문자이다
attributes
NamedNodeMaps
가 동일하다. 즉, 2 개의 노드가 양쪽 모두 null
인지, 또는 같은 길이를 가져, 1 개의 맵에 존재하는 각 노드에 대해서 다른 맵에 존재하는 노드가 있어, 동일하지만, 반드시 같은 인덱스에는 없다
childNodes
NodeLists
가 동일하다. 즉, 양쪽 모두 null
인지, 또는 같은 길이를 가져, 같은 인덱스에 동일한 노드를 가진다. 정규화는, 동등성에 영향을 미칠 가능성이 있는 것에 주의가 필요. 이 영향을 피하려면 , 노드를 정규화하고 나서 비교를 실시할 필요가 있다
DocumentType
노드가 동일하기 위해(때문에)는, 다음의 조건이 채워질 필요가 있습니다.
publicId
,systemId
,internalSubset
가 동일하다
entities
NamedNodeMaps
가 동일하다
notations
NamedNodeMaps
가 동일하다
ownerDocument
,baseURI
, 및 parentNode
속성,Attr
노드의 specified
속성,Attr
노드와 Element
노드의 schemaTypeInfo
속성,Text
노드의 Text.isElementContentWhitespace
속성, 및 노드에 등록되어 있는 사용자 데이터 또는 이벤트 청취자
주:일반적으로, 위의 설명으로 다루어지지 않은 것은, 동일성 체크의 면에서 의미가 있지는 않습니다. 이 스펙의 장래 버젼에서는, 보다 많은 속성을 고려해, 이 스펙에 준거하는 구현을 적당 갱신할 예정입니다.
arg
- 동일성을 비교하는 대상의 노드
true
,
그렇지 않은 경우는 false
Object getFeature(String feature, String version)
Node
인터페이스를 지원하고 있지 않는 특수한 형식의 객체를 이용할 수 있습니다.
feature
- 요구된 기능의 이름. 기능명의 전에
추가되는 플러스 기호 「+」은,
이 메소드의 문맥에서는 의미가 있지 않기 때문에 무시되는version
- 테스트하는 기능의 버젼 번호
null
. 이 메소드에 의해 반환되는 DOMObject
가
Node
인터페이스를 구현하는 경우,
이 인터페이스를 주요 코어 Node
에 위양 해,
attributes, childNodes 라고 하는 주요 코어 Node
(와)과 정합하지 않는 결과를 돌려주는 것이 없게 할 필요가 있는Object setUserData(String key, Object data, UserDataHandler handler)
getUserData
를 호출해 취득할 수 있습니다.
key
- 객체를 관련짓는 키data
- 주어진(given) 키에 관련짓는 객체.
주어진(given) 키에 대한 기존의 관련을 삭제하는 경우는 null
handler
- 주어진(given) 키에 관련짓는 핸들러, 또는
null
DOMUserData
.
관련지을 수 있지 않았던 경우는 null
Object getUserData(String key)
setUserData
를 호출해, 이 노드에 대해서 벌써 설정되어 있을 필요가 있습니다.
key
- 객체를 관련지을 수 있고 있는 키
DOMUserData
.
관련지을 수 있지 않았던 경우는 null
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.