深入了解TextRange对象

TextRange对象是动态HTML(DHTML)的高级特性，使用它可以实现很多和文本有关的任务，例如搜索和选择文本。文本范围让您可以选择性的将字符、单词和句子从文档中挑选出来。TextRange对象是在HTML文档将要显示的文本流上建立开始和结束位置的抽象对象。

　　下面是TextRange的常用属性与方法：

　　属性

　　boundingHeight 获取绑定TextRange对象的矩形的高度

　　boundingLeft 获取绑定TextRange 对象的矩形左边缘和包含TextRange对象的左侧之间的距离

　　offsetLeft 获取对象相对于版面或由offsetParent属性指定的父坐标的计算左侧位置

　　offsetTop 获取对象相对于版面或由offsetParent属性指定的父坐标的计算顶端位置

　　htmlText 获取绑定TextRange对象的矩形的宽度

　　text 设置或获取范围内包含的文本

　　方法

　　moveStart 更改范围的开始位置

　　moveEnd 更改范围的结束位置

　　collapse 将插入点移动到当前范围的开始或结尾

　　move 折叠给定文本范围并将空范围移动给定单元数

　　execCommand 在当前文档、当前选中区或给定范围上执行命令

　　select 将当前选择区置为当前对象

　　findText 在文本中搜索文本并将范围的开始和结束点设置为包围搜索字符串。

　　使用TextRange对象通常包括三个基本的步骤:

　　1.创建文本范围

　　2.设置开始点和结束点

　　3.对范围进行操作

　　Html代码

　　
移动光标到第个位置

　　
移动光标到第个位置

　　1.createTextRange()

　　创建一个TextRange对象,BODY、TEXT、TextArea、BUTTON等元素都支持这个方法。该方法返回一个TextRange对象。

　　2.move("Unit"[,count])

　　move()方法执行两个操作。首先，方法在前一个结束点的位置重叠当前文档，将这里作为一个插入点；下一步，它将插入点向前或向后移动任意个字符、单词或句子单位。

　　方法的第一个参数是字符串，它指定的单位有character(字符)、word(词)、sentence(段落)、textedit。textedit值将插入点移动到整个文本范围的结束处(不需要参数)。如果指定为前三种单位，忽略参数时默认值为1,也可以指定一个整数值来指示单元数，正数代表向前移动，负数代表向后移动。

　　注意在move()方法执行后范围仍是重叠的。

　　3.select()

　　select()方法选择当前文本范围内的文本，这里的显示光标也必须利用它来实现，因为所谓的"光标"可以理解为边界重合的范围

　　搜索文本中的字符串

　　Html代码

　　 菊花台 (满城尽带黄金甲主题曲) 歌手：周杰伦 专辑：依然范特西 你的泪光 柔弱中带伤 惨白的月弯弯 勾住过往 夜太漫长 凝结成了霜 是谁在阁楼上冰冷的绝望 雨轻轻淌 朱红色的窗 我一生在纸上 被风吹乱 梦在远方 化成一缕霞 随风飘散 你的模样 菊花惨淡地伤 你的笑容已泛黄 花落人断肠 我心事静静淌 北风乱夜未央 你的影子剪不断 徒留我孤单在湖面生霜

　　 菊花台 (满城尽带黄金甲主题曲) 歌手：周杰伦 专辑：依然范特西 你的泪光 柔弱中带伤 惨白的月弯弯 勾住过往 夜太漫长 凝结成了霜 是谁在阁楼上冰冷的绝望 雨轻轻淌 朱红色的窗 我一生在纸上 被风吹乱 梦在远方 化成一缕霞 随风飘散 你的模样 菊花惨淡地伤 你的笑容已泛黄 花落人断肠 我心事静静淌 北风乱夜未央 你的影子剪不断 徒留我孤单在湖面生霜

　　上面的例子演示了利用moveStart()和moveEne()方法选择范围，出现的几个方法的说明如下：

　　4.moveStart("Unit"[,count])与moveEnd("Unit"[,count])

　　moveStart()与moveEnd()方法类似于move()方法,默认情况下开始点为容器第一个字符、结束点为最后一个字符

　　我们可以修改上面的selectText()函数来证明:

　　function selectText()

　　{

　　var rng = txtBox.createTextRange();

　　rng.moveStart("character",1);

　　rng.moveEnd("character",-1);

　　rng.select();

　　}

　　将开始点向前移动一个字符、结束点向后移动一个字符，运行后可以看到选择的范围是除第1个字符和最后1个字符的整个文本范围。

　　5.collapse([Boolean])

　　可以用collapse()方法把文本范围从当前尺寸重叠成字符间的单个插入点。collapse()方法的可选参数是Boolean值,它指出范围是在当前范围的开始点重合，还是结束点重合。默认值为true，在开始点重合:

　　5.findText("searchString"[,searchScope,flags])

　　TextRange对象最有用的方法之一是findText()方法，其默认行为是从开始点到结束点浏览文本范围，搜索一个不区分大小写的字符串匹配。如果在范围中发现一个实例，范围的开始点和结束点就放到这个文本中，方法返回true；否则返回false,开始点和结束点都不动。方法仅搜索显示文本，而任何标记或属性都不会被搜索。

　　可选参数searchScope是一个整数值，它指示从开始点的字符数，值越大，包含在搜索范围的文本越多；负值将迫使搜索操作从当前开始点向后搜索。

　　可选参数flag用来设置搜索是否区分大小写，或者是否仅匹配整个单词。参数是整数值，它用按位组合的数学方法计算单个值，这些值能容纳一个或多个设置。匹配整个单词的值为2；匹配大小写的值为4；如果只想匹配一项，则只提供希望的值就够了，但对于两种行为，要用位操作XOR操作符(^操作符)使值为6。

　　findText()方法最常用的应用包括范围中的查找和替换操作，以及格式化一个字符串的实例，因为搜索通常以范围的当前开始点开始，所以再次查询要将开始点移到范围中匹配文本的末尾(如示例3)，移动后才能使findText()继续浏览剩下的文本范围，来查找另一个匹配。可以使用collapse(false)方法迫使开始点移动第一个匹配的范围的结束点。所以示例3的findText()函数也可以修改为:

　　

　　6.parentElement()

　　parentElement()方法返回包含文本范围容器的引用

　　获得光标选中文本的DOM对象

　　Html代码

　　 这是只属于Body的文本

这是包含在div里的文本

这是包含在p里面的文本

这是包含在div->strong里的文本

　　 这是只属于Body的文本

这是包含在div里的文本

这是包含在p里面的文本

这是包含在div->strong里的文本

　　

　　Range对象

　　Range对象表示文档的连续范围区域，如用户在浏览器窗口中用鼠标拖动选中的区域。

　　dom标准Range对象

　　在ie中使用TextRange对象

　　range对象常用的建立方法

　　在开发中除了上述文档中的标准建立方法，大多如下方式建立

　　标准dom:

　　var range=window.getSelection().getRangeAt(0);

　　ie:

　　var range=document.selection.createRange();

　　注意：标准dom是从window中获取selection对象，而ie是从document对象中获取。

　　标准dom range对象(以下称dom rang)和ie的TextRange对象(以下称TextRange),在操作模式上有很大区别，可以说dom range是基于dom结构控制的，TextRange是基于文本节点字节控制的，阅读下面示例会更好理解这二者的操作模式。以下所说的range对象是指在html结构中进行选择和更改（designMode=on contentEditable=true状态下）操作，在textarea中的操作比这简单，不是当前的研究环境。

　　range对象的具体方法和属性请查看上边列出的相关api文档，下面对实际开发过程中常用功能讲解

　　1.区域选择 获取区域中文本

　　TextRange的区域选择

　　TextRange对象主要使用以下方法控制区域的选择：moveStart moveEnd move

　　这三个函数使用相同的参数语法:fn(sUnit [, iCount])

　　第一个参数是指移动的单位，可以使用的参数：character（字符）、word（词）、sentence（段落）、textedit（整个编辑区）

　　第二个参数指移动的数量单位，负数向所在位置之前移动，正数向所在位置之后移动。

　　在实际开发中一般使用character，其他几个参数在中文环境和html编辑时，和预想位置有偏差。

　　例1：TextRange选择光标前4个字符

　　代码如下:

　　var rg=document.selection.createRange();

　　rg.moveStart("character",-4);

　　rg.select();//显式选择文本区域，不调用此函数也可以获得选择的内容

　　var text=rg.text;//获得选择的文本

　　var htmlText=rg.htmlText;//获得选择文本的html代码

　　用rg.htmlText获得选择文本的html代码，但获得结果不尽人意，

　　如:aaaabb ,当选择aabb段时，.htmlTex返回的是aabb而不是aabb

　　其他常用位置控制函数：

　　collapse： 合并前后选择点，true为开始点，false为结尾点。

　　moveToPoint： 移动光标到坐标 moveToBookmark： 移动到书签。

　　dom range的区域选择

　　dom range对象选择区域主要以dom节点为为坐标，所有边界移动和区域选择函数都是以dom节点为参照的

　　setEnd()setStart()是控制范围的前边界点和后边界点位置的函数，

　　有两个参数，第一个参数是dom节点，第二个参数是偏移量，这个参数和TextRange.move中不同，是相对于dom节点的偏移量。

　　如：有文字节点node1 nodeValue是aaabbbccc,setStart(node1,3)则设置开始位置在字符a、b之间

　　那如何像例1一样选择光标前4个字符呢，这需要了解dom range对象的几个属性：

　　endContainer 包含范围的结束点的 dom节点。

　　endOffset endContainer 中的结束点位置。

　　startContainer 包含范围的开始点的 dom节点。

　　startOffset startContainer 中的开始点位置。

　　例2：dom range选择光标前4个字符

　　代码如下:

　　var rg=window.getSelection().getRangeAt(0);

　　rg.setStart(rg.startContainer,rg.startOffset-4);//获得当前range strat所在节点和偏移量，计算后作为参数

　　//在调用setStart后即显式选择，与TextRange不同

　　var text=rg.toString();//获得选择文本

　　rg.collapse(false);//collapse函数与TextRange.collapse相同

　　例2中range选择范围操作适用于单一的文本内容，如果是html内容就需要进一步计算才能正确得到，总的来看dom range在复杂dom结 构中进行相对范围选择是比较麻烦的。

　　另外，dom range没有直接的方法获得选择内容的html代码。在html可编辑状态下可以通过surroundContents()方法用一个span之类的标签包裹住内容后再通过innerHTML获得内容，但是在选择范围边界点在html开始和结束标签内时（如：123边界点在a标签内）会抛出一个异常。

　　以下是测试用完整代码，包含例1和例2的代码和一个测试用html可编辑区。

　　代码如下:

　　

　　

　　

　　

　　

　　

　　

　　

　　

　　

　　2.插入文本

　　TextRange插入文本

　　使用TextRang插入文本比较简单，直接调用pasteHTML()方法就可以直接插入html代码。

　　Dom Range插入文本

　　使用Dom Range插入文本相对复杂一些，Dom Range对象使用insertNode()方法实现插入，但是insertNode是在Range的开始位置插入一 个节点，参数是一个节点而不是字符串，我们可以通过插入文本节点实现，如果使用document.createTextNode建立文本节点，文本中的HTML标记会自动转换，但空格是个特例，并不会自动转换为 ,这使我在开发代码缩进时很头疼，最后解决的办法，是使用Rang.createContextualFragment,这个方法虽然在文档中没有找到，但测试多个浏览器都支持此方法,此方法返回的是一个DocumentFragment对

　　象。以下是示例代码：

　　例3：

　　Js代码

　　代码如下:

　　var rg = window.getSelection().getRangeAt(0);

　　var fragment = rg.createContextualFragment(str);

　　rg.insertNode(fragment);

　　这段代码虽然实现插入了文本，但是光标位置却在插入文本之前，因为“insertNode是在Range的开始位置插入一 个节点”，接下来我们实现光标的控制，这需要设置Range对象的位置，并更新Selection对象的Range，代码如下：

　　例4：

　　Js代码

　　代码如下:

　　var selection=window.getSelection();

　　var rg=selection.getRangeAt(0);

　　var fragment = rg.createContextualFragment(str);

　　var oLastNode = fragment.lastChild; //获得DocumentFragment的末尾位置

　　rg.insertNode(fragment);

　　rg.setEndAfter(oLastNode);//设置末尾位置

　　rg.collapse(false);//合并范围至末尾

　　selection.removeAllRanges();//清除range

　　selection.addRange(rg);//设置range

　　以下是一个代码缩进功能的部分代码作为示例：按tab键时会在当前位置，插入4个空格，解决在编辑时不能输入tab的问题。实际应用中的功能包括多行缩进和自动缩进。

　　代码如下:

　　

　　

　　

　　

　　

　　

　　

　　

　　

　　

　　3.替换

　　综合介绍的选择和插入的方法可完成替换功能，TextRange比较简单pasteHTML方法会替换原来Range选中的文本，Dom Range的insertNode不会删除原range选中内容，需要调用deleteContents()方法先删除选择内容。