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

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

コンストラクター

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

プロパティ

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

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

Slotable に含まれるプロパティ

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

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

メソッド

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

Text.replaceWholeText
カレントノードおよび論理的に隣接するノードのテキストを、指定したテキストに置き換えます。
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 の定義
廃止された 最初期の定義

ブラウザー実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOS 版 SafariSamsung Internet
基本対応Chrome 完全対応 1Edge 完全対応 ありFirefox 完全対応 ありIE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android ? Edge Mobile ? Firefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?
Text() constructor
実験的
Chrome 完全対応 28Edge ? Firefox 完全対応 24IE 未対応 なしOpera 完全対応 15Safari 完全対応 8WebView Android 完全対応 ありChrome Android 完全対応 28Edge Mobile ? Firefox Android 完全対応 24Opera Android 完全対応 15Safari iOS 完全対応 8Samsung Internet Android ?
isElementContentWhitespace
非推奨
Chrome 未対応 なしEdge ? Firefox 未対応 ? — 10IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしEdge Mobile ? Firefox Android 未対応 ? — 10Opera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android ?
wholeTextChrome 完全対応 1Edge 完全対応 ありFirefox 完全対応 3.5IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android ? Edge Mobile ? Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?
assignedSlotChrome 完全対応 53Edge 完全対応 ありFirefox 完全対応 ありIE ? Opera 完全対応 40Safari 完全対応 10.1WebView Android 完全対応 53Chrome Android 完全対応 53Edge Mobile 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 40Safari iOS 完全対応 10.1Samsung Internet Android ?
replaceWholeText
非推奨非標準
Chrome 未対応 ? — 45Edge ? Firefox 未対応 ? — 10IE 完全対応 ありOpera 未対応 ? — 32Safari 未対応 なしWebView Android 未対応 ? — 45Chrome Android 未対応 ? — 45Edge Mobile ? Firefox Android 未対応 ? — 10Opera Android 未対応 ? — 32Safari iOS 未対応 なしSamsung Internet Android ?
splitTextChrome 完全対応 1
補足
完全対応 1
補足
補足 Before Chrome 30, the offset argument was optional.
Edge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 あり
補足
完全対応 あり
補足
補足 Before Opera 17, the offset argument was optional.
Safari 完全対応 あり
補足
完全対応 あり
補足
補足 The offset argument is optional.
WebView Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before version 4.4, the offset argument was optional.
Chrome Android 完全対応 18
補足
完全対応 18
補足
補足 Before Chrome 30, the offset argument was optional.
Edge Mobile ? Firefox Android 完全対応 4Opera Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before Opera 17, the offset argument was optional.
Safari iOS 完全対応 あり
補足
完全対応 あり
補足
補足 The offset argument is optional.
Samsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。
実装ノートを参照してください。
実装ノートを参照してください。

関連情報

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

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