text.replaceWholeText

已废弃
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Summary

replaceWholeText replaces the text of the node and all of its logically adjacent text nodes with the specified text. The replaced nodes are removed, including the current node, unless it was the recipient of the replacement text.

Warning: This method has been deprecated in DOM level 4 and is no longer implemented in recent browsers, including Gecko 10.0 (Firefox 10.0 / Thunderbird 10.0 / SeaMonkey 2.7).

Syntax

replacementNode = textnode.replaceWholeText(content)

Parameters

replacementNode is a Text node.
content is a string specifying the text with which to replace the node's current contents.

Exceptions

NO_MODIFICATION_ALLOWED_ERR : A DOMException thrown if one of the text nodes being replaced is read only.

Example

See the example for the text.wholeText property.

Notes

This method returns the text node which received the replacement text, or null if the replacement text is an empty string. The returned node is the current node unless the current node is read only, in which case the returned node is a newly created text node of the same type which has been inserted at the location of the replacement.

Note: Firefox's implementation of this method does not yet support EntityReference nodes as defined by the specification.

Specification

replaceWholeText