Text

Text インターフェイスは、Element または Attr のテキストコンテンツを表します。要素の内部にマークアップが含まれていない場合、その要素は要素内のテキストを包含する Text を実装する子を 1 つ持ちます。一方要素がマークアップを含む場合は情報アイテムと、要素の子を構成する Text ノードに解析されます。

新しいドキュメントは、テキストのブロックごとに 1 つの Text ノードを持ちます。ドキュメントの内容の変化に応じて、さらに多くの Text ノードが生成されます。Node.normalize() メソッドは、テキストのブロックごとに 1 つのノードに戻るよう、隣接する Text オブジェクトを結合します。

コンストラクター

Text() これは実験段階の API です。製品内のコードで使用しないようご注意ください。
引数をテキストコンテンツとして持つ、Text ノードを返します。

プロパティ

親である CharacterData からプロパティを継承します。

Text.isElementContentWhitespace 読取専用 これは廃止された API であり、動作は保証されていません。
text ノードがホワイトスペースしか包含していないかを示す、Boolean フラグを返します。
Text.wholeText 読取専用
当該 Node に論理的に隣接しているすべての Text ノードのテキストを、ドキュメント内で現れる順に結合した DOMString を返します。
Text.assignedSlot 読取専用
要素に関連付けられた HTMLSlotElement オブジェクトを返します。

Slotable に含まれるプロパティ

Text インターフェイスは、Slotable ミックスインで定義された以下のプロパティを含んでいます。

Slotable.assignedSlot 読取専用
ノードが挿入されている <slot> を表す HTMLSlotElement を返します。

メソッド

親である CharacterData からメソッドを継承します。

Text.replaceWholeText これは廃止された API であり、動作は保証されていません。
カレントノードおよび論理的に隣接するノードのテキストを、指定したテキストに置き換えます。
Text.splitText
指定したオフセット位置で、ノードを 2 つに分割します。

仕様

仕様書 策定状況 コメント
DOM
Text の定義
現行の標準 isElementContentWhitespace プロパティを削除。
replaceWholeText() メソッドを削除。
Text() コンストラクターを追加。
assignedSlot プロパティを追加。
Document Object Model (DOM) Level 3 Core Specification
Text の定義
廃止 isElementContentWhitespace および wholeText プロパティを追加。
replaceWholeText() メソッドを追加。
Document Object Model (DOM) Level 2 Core Specification
Text の定義
廃止 Document Object Model (DOM) Level 1 Specification から変更なし。
Document Object Model (DOM) Level 1 Specification
Text の定義
廃止 最初期の定義

ブラウザー実装状況

BCD tables only load in the browser

関連情報