Text

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 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
TextChrome 完全対応 1Edge 完全対応 ありFirefox 完全対応 ありIE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android ? Firefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?
Text() constructor
実験的
Chrome 完全対応 28Edge ? Firefox 完全対応 24IE 未対応 なしOpera 完全対応 15Safari 完全対応 8WebView Android 完全対応 ありChrome Android 完全対応 28Firefox Android 完全対応 24Opera Android 完全対応 14Safari iOS 完全対応 8Samsung Internet Android ?
assignedSlotChrome 完全対応 53Edge 完全対応 ありFirefox 完全対応 ありIE ? Opera 完全対応 40Safari 完全対応 10.1WebView Android 完全対応 53Chrome Android 完全対応 53Firefox Android 完全対応 ありOpera Android 完全対応 41Safari iOS 完全対応 10.1Samsung Internet Android 完全対応 あり
isElementContentWhitespace
非推奨
Chrome 未対応 なしEdge ? Firefox 未対応 ? — 10IE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしFirefox Android 未対応 ? — 10Opera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android ?
replaceWholeText
非推奨非標準
Chrome 未対応 ? — 45Edge 完全対応 12Firefox 未対応 ? — 10IE 完全対応 ありOpera 未対応 ? — 32Safari 未対応 なしWebView Android 未対応 ? — 45Chrome Android 未対応 ? — 45Firefox Android 未対応 ? — 10Opera Android 未対応 ? — 32Safari iOS 未対応 なしSamsung Internet Android ?
splitTextChrome 完全対応 1
補足
完全対応 1
補足
補足 Before Chrome 30, the offset argument was optional.
Edge 完全対応 12Firefox 完全対応 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.
Firefox Android 完全対応 4Opera Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before Opera 17, the offset argument was optional.
Safari iOS 完全対応 あり
補足
完全対応 あり
補足
補足 The offset argument is optional.
Samsung Internet Android ?
wholeTextChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 3.5IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android ? Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

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

関連情報

最終更新日:

, by MDN contributors
関連トピック
  1. Document Object Model
  2. Text
  3. コンストラクター
    1. Text() [翻訳する]
  4. プロパティ
    1. assignedSlot [翻訳する]
    2. isElementContentWhitespace [翻訳する]
    3. wholeText [翻訳する]
  5. メソッド
    1. replaceWholeText() [翻訳する]
    2. splitText() [翻訳する]
  6. 継承
    1. CharacterData
    2. Node
    3. EventTarget
  7. DOM に関連するページ
    1. AbortController
    2. AbortSignal
    3. Attr
    4. ByteString
    5. CDATASection
    6. CSSPrimitiveValue
    7. CSSValue
    8. CSSValueList
    9. CharacterData
    10. ChildNode
    11. Comment
    12. CustomEvent
    13. DOMConfiguration
    14. DOMError
    15. DOMErrorHandler
    16. DOMException
    17. DOMImplementation
    18. DOMImplementationList
    19. DOMImplementationRegistry
    20. DOMImplementationSource
    21. DOMLocator
    22. DOMObject
    23. DOMParser
    24. DOMPoint
    25. DOMPointInit
    26. DOMPointReadOnly
    27. DOMRect
    28. DOMString
    29. DOMTimeStamp
    30. DOMTokenList
    31. DOMUserData
    32. Document
    33. DocumentFragment
    34. DocumentType
    35. Element
    36. ElementTraversal
    37. Entity
    38. EntityReference
    39. Event
    40. EventTarget
    41. HTMLCollection
    42. MutationObserver
    43. Node
    44. NodeFilter
    45. NodeIterator
    46. NodeList
    47. NonDocumentTypeChildNode
    48. ProcessingInstruction
    49. PromiseResolver
    50. Range
    51. TextDecoder
    52. TextEncoder
    53. TimeRanges
    54. TreeWalker
    55. TypeInfo
    56. USVString
    57. UserDataHandler
    58. XMLDocument