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 오브젝트를 각 텍스트 블록내의 단일의 노드에 merge 합니다.

「Document Object Model (DOM) Level 2 Core Specification 」를 참조해 주세요.

필드의 개요

인터페이스 org.w3c.dom. Node 에서 상속받은 필드

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

메소드의 개요

Text	splitText (int offset) 이 노드가 지정된 offset 위치에서 2 개의 노드에 분할해, 형제 노드로서 트리내에 보존합니다.

인터페이스 org.w3c.dom. CharacterData 에서 상속받은 메소드

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

인터페이스 org.w3c.dom. Node 에서 상속받은 메소드

appendChild , cloneNode , getAttributes , getChildNodes , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , hasAttributes , hasChildNodes , insertBefore , isSupported , normalize , removeChild , replaceChild , setNodeValue , setPrefix

메소드의 상세

splitText

public 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: 이 노드가 읽어내 전용의 경우