Text

この記事はまだ日本語に翻訳されていません。MDN の翻訳はボランティアによって行われています。是非 MDN に登録し、私たちの力になって下さい。

« DOM Reference

The Text interface represents the textual content of Element or Attr.  If an element has no markup within its content, it has a single child implementing Text that contains the element's text.  However, if the element contains markup, it is parsed into information items and Text nodes that form its children.

New documents have a single Text node for each block of text. Over time, more Text nodes may be created as the document's content changes.  The Node.normalize() method merges adjacent Text objects back into a single node for each block of text.

Properties

Text.isElementContentWhitespace Read only

Returns a Boolean flag indicatingwhether or not the text node contains only whitespace.

Text.wholeText Read only
Returns a DOMString containing the text of all Text nodes logically adjacent to this Node, concatenated in document order.

Constructor

Text()
Returns a Text node with the parameter as its textual content.

Methods

Text.replaceWholeText
Replaces the text of the current node and all logically adjacent nodes with the specified text.
Text.splitText
Breaks the node into two nodes at a specified offset.

Specifications

Specification Status Comment
DOM Living Standard Removed the isElementContentWhitespace property.
Removed the replaceWholeText() method.
Added the Text() constructor.
Document Object Model (DOM) Level 3 Core Specification Recommendation Added the isElementContentWhitespace and wholeText properties.
Added the replaceWholeText() method.
Document Object Model (DOM) Level 2 Core Specification Recommendation No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 [3] 1.0 (1.7 or earlier) (Yes) (Yes) [3] (Yes) [4]
wholeText 1.0 3.5 (1.9.1) (Yes) (Yes) (Yes)
isElementContentWhitespace Not supported (Yes)
Removed in 10 (10)
Not supported Not supported Not supported
replaceWholeText (Yes) [1] [2] 3.5 (1.9.1)
Removed in 10 (10)
(Yes) (Yes) [1] [2] (Yes) [4]
Text() constructor 28.0 24.0 (24.0) Not supported 15.0 Not supported
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) [3] 1.0 (1.0) (Yes) (Yes) [3] (Yes) [4]
wholeText (Yes) 1.0 (1.9.1) (Yes) (Yes) (Yes)
isElementContentWhitespace Not supported (Yes)
Removed in 10.0 (10)
Not supported Not supported Not supported
replaceWholeText (Yes) [1] [2] 1.0 (1.9.1)
Removed in 10.0 (10)
(Yes) (Yes) [1] [2] (Yes) [4]
Text() constructor (Yes) 24.0 (24.0) Not supported 15.0 Not supported

[1] Chromium is currently considering dropping its support.

[2] Before Chrome 30 and Opera 17, the argument wasn't mandatory, like required by the specification.

[3] Before Chrome 30 and Opera 17, splitText() argument was not mandatory, as required by the specification and implemented by IE and Gecko-based browsers.

[4] The argument is not mandatory, though required by the spec.

See also

Document Tags and Contributors

タグ:
Contributors to this page: Sheppy, Jürgen Jeka, jswisher, Brettz9, Ruakh, teoli
最終更新者: teoli,