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 オブジェクトを各テキストブロック内の単一のノードにマージします。

『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 ビット単位のオフセット。0 から始まる

戻り値:

このノードと同じ型の新しいノード

例外:

DOMException - INDEX_SIZE_ERR: 指定された offset の値が負の値であるか、data 内の 16 ビット単位の数より大きい場合
NO_MODIFICATION_ALLOWED_ERR: このノードが読み取り専用の場合