TextRange.text

非标准
该特性是非标准的,请尽量不要在生产环境中使用它!

IE Only

该属性是IE专有的。尽管IE很好地支持它,但大部分其它浏览器已经不支持该属性。该属性仅应在需兼容低版本IE时作为其中一种方案,而不是在跨浏览器的脚本中完全依赖它。

TextRange 接口中的属性 text 用于以 DOMString 形式获取或设置区域内的纯文本内容。该更改直接作用到 DOM 树中,并清除区域内原有的非纯文本元素。注意,该属性忽略所有格式数据,因此若要获取选区中的HTML内容,请使用 TextRange.htmlText 属性。

语法

var tString = textRange.text;
textRange.text = oString;

返回值

一个 DOMString

示例

以下示例在IE9以下有效。该示例通过 document.selection 获取 TextRange,并过滤选区中的富文本元素。IE9以上支持标准的替代方案 Range

var range = document.selection.createRange();
range.htmlText = range.text;
// 将富文本内容设置为纯文本内容,则区域也就变为纯文本。

开发者笔记

关于 text 属性

注意,当通过该属性操作或获取时,不会得到包含非纯文本的信息;如果通过该属性设置,则区域内的元素将被删除,之后通常会变为一个包含指定内容的文本节点。因此,即使通过这个属性操作纯文本内容,结果也将剔除原先的所有格式数据。

如果希望脚本的功能明确可读,最好的办法是不要同时使用该属性和 htmlText 属性设置数据。另外,该属性不是标准的,它从IE4开始在IE中实现,但不在其它浏览器的规范中。

浏览器兼容性

IE 其它浏览器
TextRange.text 支持(IE9后应使用标准API) 不支持(详见Selection API

扩展