javascript TextRange对象--查找与选择

来源:互联网 发布:xp无法映射网络驱动器 编辑:程序博客网 时间:2024/04/19 09:20

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

--------------------------------------------------------------------------------

示例1:<mce: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();   

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

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

<input type="button" name="btnMove" value="移动">


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

1.createTextRange()

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

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

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

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

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

3.select()

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


--------------------------------------------------------------------------------

示例2:<mce: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();            

}
// --></mce:script>

 

<textarea name="txtBox" rows="7" cols="50" id="txtBox">

千里之外

歌手:周杰伦/费玉清 专辑:依然范特西

 

屋檐如悬崖风铃如沧海我等燕归来

时间被安排演一场意外你悄然走开

故事在城外浓雾散不开看不清对白

你听不出来风声不存在是我在感慨

 

梦醒来是谁在窗台把结局打开

那薄如蝉翼的未来经不起谁来拆

我送你离开千里之外你无声黑白

沉默年代或许不该太遥远的相爱

我送你离开天涯之外你是否还在

琴声何来生死难猜用一生去等待

 

闻泪声入林寻梨花白只得一行青苔

天在山之外雨落花台我两鬓斑白

闻泪声入林寻梨花白只得一行青苔

天在山之外雨落花台我等你来


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