详探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.对范围进行操作

<script language="javascript">

function moveCursor()
{
    var temp = this.txtNum.value;
    if(isNaN(temp))
    {
     alert("请输入一个数字");
     return;
    }
    var rng = this.txtTest.createTextRange();
    rng.move("character",temp);
    rng.select();   
} 

</script>

<input type="text" name="txtTest" value="明·罗贯中《三国演义》第二十一回 操曰:“夫英雄者,胸怀大志,腹有良谋,有包藏宇宙之机,吞吐天地之志者也。" size="100"><br>

移动光标到第<input type="text" name="txtNum" size="5">个位置

<input type="button" name="btnMove" value="移动" onclick="moveCursor()"> 

上面的例子实现了一个简单的光标定位,涉及到了textRange的几个方法:

1.createTextRange()

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

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

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

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

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

3.select()

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

<script language="javascript">

function selectText(sp,ep)
{
  if(isNaN(sp)||isNaN(ep))
  {
    alert("请输入数字!");
    return;
  }
  //弱语言自动转换
  sp = sp*1;
  ep = ep*1; 
  if(sp>=ep)
  {
    alert("开始位置必须比结束位置小");
    return;
  }
  if(sp>txtBox.value.length||ep>txtBox.value.length)
  {
    alert("当前字符数最大为"+txtBox.value.length+",请重新输入");
    return;
  } 
  var rng = this.txtBox.createTextRange();
 
  //将开始点和结束点在容器起始位置重合
  rng.moveStart("character",-txtBox.value.length);
  rng.moveEnd("character",-txtBox.value.length);
  rng.collapse(true);
 
  //按参数值移动
  rng.moveStart("character",sp);
  rng.moveEnd("character",ep);
 
  rng.select();            
} 

</script>

<textarea name="txtBox" rows="7" cols="50" id="txtBox">
千里之外
歌手:周杰伦/费玉清 专辑:依然范特西 

屋檐如悬崖风铃如沧海我等燕归来
时间被安排演一场意外你悄然走开
故事在城外浓雾散不开看不清对白
你听不出来风声不存在是我在感慨

梦醒来是谁在窗台把结局打开
那薄如蝉翼的未来经不起谁来拆
我送你离开千里之外你无声黑白
沉默年代或许不该太遥远的相爱
我送你离开天涯之外你是否还在
琴声何来生死难猜用一生去等待

闻泪声入林寻梨花白只得一行青苔
天在山之外雨落花台我两鬓斑白
闻泪声入林寻梨花白只得一行青苔
天在山之外雨落花台我等你来
</textarea><br>

指定选择范围: 

<input type="text" size="5" id="txtStart">

-- <input type="text" size="5" id="txtEnd"> 

<input type="button" value="选择" onclick="selectText(txtStart.value,txtEnd.value)"> 

上面的例子演示了利用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,在开始点重合。

<textarea name="txtBox" rows="7" cols="50" id="txtBox">
菊花台 (满城尽带黄金甲主题曲)
歌手:周杰伦 专辑:依然范特西 

你的泪光 柔弱中带伤
惨白的月弯弯 勾住过往
夜太漫长 凝结成了霜
是谁在阁楼上冰冷的绝望
雨轻轻淌 朱红色的窗
我一生在纸上 被风吹乱
梦在远方 化成一缕霞
随风飘散 你的模样 

菊花惨淡地伤 你的笑容已泛黄
花落人断肠 我心事静静淌
北风乱夜未央 你的影子剪不断
徒留我孤单在湖面生霜
</textarea><br>

<input type="text" value="输入要查询的内容" id="txtFind">

<input type="button" value="查找下一个" onclick="findText(txtFind.value)">

<script language="javascript">

var rng = txtBox.createTextRange();

function findText(str)
{
   if(str=="")
   return;
   //定义一个变量,作为moveStart()函数的偏移量,即开始点跳过选择文本
   var num = 0;
   if(document.selection)  
   num = document.selection.createRange().text.length;
   //每次调用函数,结束点都为末尾,而开始点是跳过选择文本后的新开始点
   rng.moveStart("character",num);
   rng.moveEnd("character",txtBox.value.length);
   //搜索到后选择文本  
   if(rng.findText(str))
   rng.select();
   //搜索到最后的范围还是找不到,则提示搜索完毕,并重新恢复rng最初的范围(否则无法执行新搜索)  
   if(rng.text!=str)
   {  
   alert("搜索完毕");
   rng = txtBox.createTextRange();
   }
}   

</script> 

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

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

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

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

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

<script language="javascript">

var rng = txtBox.createTextRange();

function findText(str)
{
    if(str=="")
    return;
  
    if(rng.findText(str))
   {
    rng.select();
   rng.collapse(false);
    }
    //搜索到最后的范围还是找不到,则提示搜索完毕,并重新恢复rng最初的范围(否则无法执行新搜索)  
    else
    {  
    alert("搜索完毕");
    rng = txtBox.createTextRange();
    }
}   

</script> 

6.parentElement()

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

<script>
function getParElem()
{
    var rng = document.selection.createRange();
    var container = rng.parentElement();
    alert(container.tagName);
}
</script>

这是只属于Body的文本
<div>这是包含在div里的文本</div>
<p>这是包含在p里面的文本</p>
<div><strong>这是包含在div->strong里的文本</strong></div>

<input type="button" value="选择文本后点击" onClick="getParElem()">
时间: 2024-11-10 13:16:26

详探TextRange对象--查找与选择的相关文章

关于document.selection和TextRange对象的介绍

document.selection只有IE支持 window.getSelection()也只有FireFox和Safari支持,都不是标准语法. selection 对象代表了当前激活选中区,即高亮文本块,或文档中用户可执行某些操作的其它元素.selection 对象的典型用途是作为用户的输入,以便识别正在对文档的哪一部分正在处理,或者作为某一操作的结果输出给用户. 用户和脚本都可以创建选中区.用户创建选中区的办法是拖曳文档的一部分.脚本创建选中区的办法是在文本区域或类似对象上调用 sele

JavaScript中textRange对象使用方法总结

TextRange对象是动态HTML(DHTML)的高级特性,使用它可以实现很多和文本有关的任务,例如搜索和选择文本.文本范围让您可以选择性的将字符.单词和句子从文档中挑选出来.TextRange对象是在HTML文档将要显示的文本流上建立开始和结束位置的抽象对象. 下面是TextRange的常用属性与方法: 属性 boundingHeight 获取绑定TextRange对象的矩形的高度 boundingLeft 获取绑定TextRange 对象的矩形左边缘和包含TextRange对象的左侧之间的

dom对象详解--document对象

 document对象 Document对象代表整个html文档,可用来访问页面中的所有元素,是最复杂的一个dom对象,可以说是学习好dom编程的关键所在. Document对象是window对象的一个成员属性,通过window.document来访问,当然也可以直接使用document. document对象常用的函数和属性可参考http://www.w3school.com.cn/jsref/dom_obj_document.asp. getElementById() 返回对拥有指定 ID

JavaScript原生对象属性和方法详解——Array对象 转载

length 设置或返回 数组中元素的数目. 注意:设置 length 属性可改变数组的大小.如果设置的值比其当前值小,数组将被截断,其尾部的元素将丢失.如果设置的值比它的当前值大,数组将增大,新的元素被添加到数组的尾部,它们的值为 undefined.所以length不一定代表数组的元素个数. var arr = new Array(3) arr[0] = "John" arr[1] = "Andy" arr[2] = "Wendy" cons

轻量级的.NET对象查找服务和AOP开发框架Netop.Core源码解说(2)--配置

先把Netop.Core的最核心部分"对象查找服务"放一放,先说说应用系统的配置. 一个应用系统的配置是少不了的,除非你是一个纯硬代码族顽固者. 也见过有的应用系统通过系统提供的健值(key-value)方法在appSettings节点下设了几十个甚至上百个,不堪入目,更别说条理性了. 开发一个应用框架,配置一般是少不了,如log4net就有自己的配置,不会让你在appSettings设几十个条目. 开发配置是很简单的,下面慢慢说来. 在NET应用中,配置信息以XML文档储存.WEB应

轻量级的.NET对象查找服务和AOP开发框架Netop.Core源码解说(4)--AOP

上节谈了谈类工厂/对象查找服务,本节谈谈AOP的实现. AOP为Aspect Oriented Programming的缩写,意为:面向切面编程,通过预编译方式和运行期动态代理实现程序功能的统一维护的一种技术. Netop.Core的AOP采用代理的实现方式.采用代理方式,您的类就必须继承一个基类(当然不是那个默认的Object,如您的类已经有一个父类,那可以让那个类的父类去继承)-- ContextBoundObject或Netop.Core.Aspect.AspectObject.当然Net

轻量级的.NET对象查找服务和AOP开发框架Netop.Core源码解说(1)-导言

Netop.Core是我程序开发积累的一个轻量级的.NET对象查找服务和AOP开发框架,现将源码公开,共享给各位NET程序员后面相关的文章对这个开发框架进行程序解说和使用解说. Netop.Core--轻量级的.NET对象查找服务和AOP开发框架概述:1.    对象查找服务(本地服务实例生成,远程服务,WCF服务)和AOP服务.2.    其它普通服务:配置, 对话上下文,日志,缓冲等.3.    类库:Netop.Core.dll  4.    必需的外部类库:Microsoft.Pract

轻量级的.NET对象查找服务和AOP开发框架Netop.Core源码解说(3)--类工厂/对象查找服务

上节谈了谈Netop.Core的对于应用系统的配置信息的处理,对于Netop.Core最核心的服务--类工厂/对象查找服务当然要用到配置服务,等下会说到. 对于NET类工厂/对象查找服务,名气大的有Spring.Net(对应于Java的Spring--号称轻量级中间件),为什么还要再造一个轮子呢?如果说Spring是轻量级的,那Netop.Core就只 能是微量级的,够用就好,学习曲线会大幅下降,学习研究代码的时间也会大幅下降. 够用就好,何乐而不为?况且Netop.Core的类工厂/对象查找服

轻量级的.NET对象查找服务和AOP开发框架Netop.Core源码解说(5)--其它

Netop.Core主要提供的服务是类工厂服务及AOP服务,当然还其它一些小服务: 一.对话上下文Netop.Core.Context.SessionContext       此对话上下文可用在桌面程序和ASP.NET程序,可用SetData和GetData在上下文中传递数据.方法有:       public static bool IsWeb()       public static string GetAppMapPath (string path)       public stat