org.w3c.dom
인터페이스 Text

모든 슈퍼 인터페이스:

CharacterData, Node

알려진 서브 인터페이스 목록 :

CDATASection

public interface Text
extends CharacterData 

Text인터페이스는 CharacterData를 상속해, Element 또는 Attr 텍스트 형식의 내용 (XML 에서는문자 데이터라고 한다)을 나타냅니다. 요소의 컨텐츠내에 마크 업이 존재하지 않는 경우, 텍스트는 Text인터페이스를 구현하는 단일의 객체 (요소의 유일한자식 객체)에 포함됩니다. 마크 업이 존재하는 경우, 텍스트는 정보 항목 (요소, 코멘트등)이나, 그 요소의 자식 요소의 리스트를 형성하는 Text 노드에 해석됩니다.

DOM에 의해 문서가 처음으로 이용 가능한 상태가 된 시점에서는 Text 노드는 텍스트 블록 마다 1개 씩 밖에 존재하지 않습니다. 사용자는 마크 업을 일절 사용하지 않고 소정의 요소의 컨텐츠를 나타내는 인접 Text 노드를 작성할 수 있습니다만, XML 나 HTML 에서는 이러한 노드의 단락을 표현할 수 없다고 하는 것, 즉, 보통, 작성한 노드는 DOM 편집 세션의 종료와 함께 없어진다고 하는 것을 인식해 둘 필요가 있습니다. Node.normalize() 메서드는 이러한 인접 Text 객체를 각 텍스트 블록내의 단일의 노드에 머지 합니다.

Text 노드의 내용에 대해, 자구 구문 체크는 행해지지 않습니다. 문서내의 위치에 응해, 직렬화중에 일부의 문자를 문자 참조를 사용해 이스케이프 할 필요가 있습니다. 예: 텍스트 컨텐츠가 요소의 일부 또는 속성의 일부인 경우의 문자 「<&」, 텍스트 컨텐츠가 요소의 일부인 경우의 캐릭터 라인 「]]>」, 텍스트 컨텐츠가 속성의 일부인 경우의 인용부호 문자 「"」또는 어퍼스트로피 문자 「'」

「Document Object Model (DOM) Level 3 Core Specification」도 참조하십시오.

필드 개요

인터페이스 org.w3c.dom. Node 로부터 상속된 필드

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

메서드 개요

String	getWholeText () 지정한 노드에 논리적으로 인접하는 텍스트 노드인 Text 노드의 모든 텍스트를 문서순서에 연결해 리턴합니다.
boolean	isElementContentWhitespace () 이 텍스트 노드가요소 컨텐츠 공백 문자 (많은 경우, 「무시할 수 있는 공백 문자」라고 불린다)를 포함할지 어떨지를 리턴합니다.
Text	replaceWholeText (String content) 현재의 노드와 논리적으로 인접하는 모든 텍스트 노드의 텍스트를, 지정된 텍스트에 옮겨놓습니다.
Text	splitText (int offset) 이 노드가 지정된 offset 위치에서 2개의 노드에 분할해, 형제 노드로서 트리내에 저장합니다.

인터페이스 org.w3c.dom. CharacterData 로부터 상속된 메서드

appendData, deleteData, getData, getLength, insertData, replaceData, setData, substringData

인터페이스 org.w3c.dom. Node 로부터 상속된 메서드

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

메서드의 상세

splitText

Text  splitText(int offset)
               throws DOMException 

이 노드가 지정된 offset 위치에서 2개의 노드에 분할해, 형제 노드로서 트리내에 저장합니다. 분할 후, 이 노드는 offset 위치까지의 모든 컨텐츠를 가지게 됩니다. offset 위치에서(보다) 뒤의 모든 컨텐츠를 포함한 같은 형태의 새로운 노드가 리턴됩니다 . 원의 노드가 부모노드를 가지고 있었을 경우, 원의 노드의 근처에 형제 노드로서 새로운 노드가 삽입됩니다. offset값이 이 노드의 길이와 동일한 경우, 새로운 노드는 데이터를 가지지 않습니다.

파라미터:

offset - 분할 위치를 나타내는 16 비트 단위의 오프셋(offset). 0 으로부터 시작된다

반환값:

이 노드와 같은 형태의 새로운 노드

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset 값이 잘못된 값 인지, data 내의 16 비트 단위의 수보다 큰 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽기 전용 의 경우

isElementContentWhitespace

boolean isElementContentWhitespace()

이 텍스트 노드가요소 컨텐츠 공백 문자 (많은 경우, 「무시할 수 있는 공백 문자」라고 불린다)를 포함할지 어떨지를 리턴합니다. 문서를 로드안에 혹은 Document.normalizeDocument()를 사용중에 검증을 했을 경우에 텍스트 노드는 요소 컨텐츠에 공백 문자를 포함할지 어떨지를 판정됩니다.

도입된 버전 :

DOM Level 3

getWholeText

String  getWholeText()

지정한 노드에 논리적으로 인접하는 텍스트 노드인 Text 노드의 모든 텍스트를 문서순서에 연결해 리턴합니다.
아래의 예에서는 「bar」를 포함한 Text 노드의 wholeText는 「barfoo」를 돌려주고, 한편, 「foo」를 포함한 Text 노드의 wholeText는 「barfoo」가 리턴됩니다 .

도입된 버전 :

DOM Level 3

replaceWholeText

Text  replaceWholeText(String  content)
                      throws DOMException 

현재의 노드와 논리적으로 인접하는 모든 텍스트 노드의 텍스트를, 지정된 텍스트에 옮겨놓습니다. 치환 텍스트의 접수측이 아닌 한, 현재의 노드를 포함해, 논리적으로 인접하는 모든 텍스트 노드는 삭제됩니다.
이 메서드는 치환 텍스트를 받은 노드를 리턴합니다. 리턴된 노드는 다음과 같습니다.

• 치환 텍스트가 비어있는 캐릭터 라인인 경우는 null
• 현재의 노드가 읽기 전용 인 경우를 제외한, 현재의 노드
• 치환 위치에 삽입된 현재의 노드와 같은 형태 (Text 또는 CDATASection)의 새로운 Text 노드

예를 들어 전술의 예로 「bar」를 포함해, 인수에 「yo」를 가지는 Text replaceWholeText를 호출하면, 다음의 결과를 일으킵니다.
삭제되는 노드가 EntityReference 노드의 읽기 전용 의 자손인 경우, 읽기 전용 의 노드가 아니고, EntityReference 노드가 삭제됩니다. 삭제되는 EntityReference가 EntityReference, Text, 혹은 CDATASection 노드가 아닌 자손을 가지는 경우, replaceWholeText 메서드는 문서의 변경을 실시하기 전에 실패해, NO_MODIFICATION_ALLOWED_ERR 코드를 포함한 DOMException을 Throw 합니다.
예를 들어 「bar」를 포함한 Text 노드의 replaceWholeText 호출은 실패합니다. 이것은, EntityReference 노드 「ent」가 삭제할 수 없는 Element 노드를 포함하기 때문입니다.

파라미터:

content - 치환하고 있는 Text 노드의 컨텐츠

반환값:

지정된 컨텐츠로 작성된 Text 노드

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 치환하고 있는 Text 노드안의 1개가 읽기 전용 의 경우

도입된 버전 :

DOM Level 3