Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Text

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

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

プロパティ

Text.isElementContentWhitespace 読取専用
text ノードがホワイトスペースしか包含していないかを示す、Boolean フラグを返します。
Text.wholeText 読取専用
当該 Node に論理的に隣接しているすべての Text ノードのテキストを、ドキュメント内で現れる順に結合した DOMString を返します。

コンストラクタ

Text()
引数をテキストコンテンツとして持つ、Text ノードを返します。

メソッド

Text.replaceWholeText
カレントノードおよび論理的に隣接するノードのテキストを、指定したテキストに置き換えます。
Text.splitText
指定したオフセット位置で、ノードを 2 つに分割します。

仕様

仕様書 策定状況 コメント
DOM
Text の定義
現行の標準 isElementContentWhitespace プロパティを削除。
replaceWholeText() メソッドを削除。
Text() コンストラクタを追加。
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 の定義
勧告 最初期の定義

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 1.0 [3] 1.0 (1.7 or earlier) (有) (有) [3] (有) [4]
wholeText 1.0 3.5 (1.9.1) (有) (有) (有)
isElementContentWhitespace 未サポート (有)
10 (10) で削除
未サポート 未サポート 未サポート
replaceWholeText (有) [1] [2] 3.5 (1.9.1)
10 (10) で削除
(有) (有) [1] [2] (有) [4]
Text() コンストラクタ 28.0 24.0 (24.0) 未サポート 15.0 未サポート
機能 Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) [3] 1.0 (1.0) (有) (有) [3] (有) [4]
wholeText (有) 1.0 (1.9.1) (有) (有) (有)
isElementContentWhitespace 未サポート (有)
10.0 (10) で削除
未サポート 未サポート 未サポート
replaceWholeText (有) [1] [2] 1.0 (1.9.1)
10.0 (10) で削除
(有) (有) [1] [2] (有) [4]
Text() コンストラクタ (有) 24.0 (24.0) 未サポート 15.0 未サポート

[1] Chromium は現在、サポートの廃止を検討しています。

[2] Chrome 30 および Opera 17 より前のバージョンでは、引数が仕様書で求められているように必須にされていませんでした。

[3] Chrome 30 および Opera 17 より前のバージョンでは、splitText() の引数が仕様書の要求や IE および Gecko ベースのブラウザのように、必須にされていませんでした。

[4] 仕様書では引数が必須ですが、実装では必須にされていません。

関連情報

ドキュメントのタグと貢献者

タグ: 
 このページの貢献者: yyss
 最終更新者: yyss,