org.w3c.dom
インタフェース Text

すべてのスーパーインタフェース:

CharacterData, Node

既知のサブインタフェースの一覧:

CDATASection

public interface Text

extends CharacterData

Element または Attr のテキストによる内容 (XML では文字データと呼ばれる) を表します。要素の内容の中にマークアップがない場合は、テキストは要素の唯一の子である Text インタフェースを実装する単一のオブジェクトに含まれます。マークアップがある場合は、テキストは情報項目 (要素、コメントなど) に構文解析され、要素の子リストを形成する Text ノードとなります。

ドキュメントが DOM を介して最初に使用できるようになったときは、各テキストブロックに対してただ一つの Text ノードが存在します。ユーザは、特定の要素の内容を表す隣接 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: 指定されたオフセットが負の数であるか data に格納されている16 ビット単位の個数よりも大きい場合に発行される
NO_MODIFICATION_ALLOWED_ERR: このノードが読み取り専用の場合に発行される