js控制输入框光标位置（setSelectionRange详解）

最新推荐文章于 2023-11-02 11:24:00 发布

原创最新推荐文章于 2023-11-02 11:24:00 发布 · 4.3w 阅读

36 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #表单

JavaScript 专栏收录该内容

7 篇文章

订阅专栏

本文介绍如何使用JavaScript控制输入框中的光标位置，实现特定场景下的需求，如自动添加单位后缀。并解决在不同浏览器中的兼容性问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题描述

前段时间碰到一个需求：在表单中有一个字段叫金额，用户希望点击该输入框后（focus），能够自动为其金额数字后加上“万元”两个字。
虽然这个需求可以通过其他的设计方式规避（例如在文本框后加入“万元”等），但是，既然碰到了问题，肯定还是希望能够研究一下技术解决方式。
对这个需求进行抽象，其实需要完成的任务就是：通过js来控制输入框内光标的位置。要完成这个任务，需要介绍一个input元素的方法：
HTMLInputElement.setSelectionRange()

setSelectionRange

介绍

在MDN上可以找到setSelectionRange()的官方介绍。其官方解释如下：

The HTMLInputElement.setSelectionRange() method sets the start and end positions of the current text selection in an element.

翻译过来就是：首先，setSelectionRange()方法是作用在input元素上的，其次，这个方法可以为当前元素内的文本设置备选中范围（selection）。简单来说，就是可以通过设置起始于终止位置，来选中一段文本中的一部分。值得一提的是，在新版中，该方法还接受一个可选参数，这个参数指定的选择的方向。

使用方式

其使用方式如下：

inputElement.setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection);

selectionStart：第一个被选中的字符的序号（index），从0开始。
selectionEnd：被选中的最后一个字符的前一个。换句换说，不包括index为selectionEnd的字符。
selectionDirection：选择的方向。可选值为forward、backward或none。

来做一个简单的实例（在线浏览），当选中一个文本框时，文本框内的文字将会被选中。可以使用点击（click）输入框的方式，也可以使用tab切换焦点的方式，其效果如下：
这里写图片描述
实现代码如下
备注：本文中事件监听未使用兼容IE写法，读者可自行补全

<form>
  <label>这个input在focus时，内部文本会被选中</label><input id="test" placeholder="万元" value="这是一段测试文本">
</form>

body {
  background-color: #f6f6f6;
}

form {
  padding: 30px;
}

input {
  display: block;
  margin-top: 10px;
  padding: 10px;
  font-size: 15px;
  color: #333333;
  border: 1px solid #555555;
  border-radius: 5px;
}

document.getElementById('test').addEventListener('focus', function() {
  changeCursorPos('test');
});

function changeCursorPos(inputId, pos) {
  var inpObj = document.getElementById(inputId);
  if (inpObj.setSelectionRange) {
    inpObj.setSelectionRange(0, inpObj.value.length);
  }
}

其中最重要的语句是

inpObj.setSelectionRange(0, inpObj.value.length);

这段代码会从第一个字符开始，到最后一个字符结束，选中输入框内的所有内容。

兼容性

那么，这个方法的兼容性怎么样呢？

Feature	Chrome	Firefox(Gecko)	Internet Explorer	Opera	Safari
Basic support	1.0	1.0 (1.7 or earlier)	9	8.0	(Yes)
selectionDirection	15	8.0 (8.0)	?	?	(Yes)

可以看到，对于基本的功能，主流浏览器的常用版本（及以上）都有着较好的支持，而selectionDirection作为附加功能，虽然兼容性一般，但是不会影响对于该方法的使用。因此，可以放心使用setSelectionRange()。

控制光标位置

初步测试

以上介绍了inputElement.setSelectionRange()的含义与使用方式，然而，我的目标需求是控制输入框内的光标位置，而不是选中输入框内的部分文本。所以，上面介绍的这些和我的目标需求有关系么？
有。
回到上一部分的实例代码，我们可以将关键代码进行一定的修改

inpObj.setSelectionRange(0, inpObj.value.length-1);//修改了selectionEnd的值

修改之后的结果如下
这里写图片描述
可以明显看到，选中文本区域改变了。那么更进一步问自己一个问题，此时的光标实际停留的位置在哪——“文”字后面。因此，不难发现，代码成功将本该处于文本末端（”本”字后面）的光标，移动至了其前一个字符“文”的后方。通过设置不同的selection，js能够成功将光标设置在不同的字符后方（其实是selection选区的后方）。
有了这个结论，可以进一步猜想，如果将选区的范围设置为0，那么则不会有文字被选中，同时，还可以控制光标的所处位置。显然，这个就是能够满足我需求的点。
为了测试这个功能，我写了一个简单的例子。

代码如下

<form>
  <label>这个input在focus时，光标会移动至文本的开头处</label><input id="test" placeholder="万元" value="这是一段测试文本">
</form>

body {
  background-color: #f6f6f6;
}

form {
  padding: 30px;
}

input {
  display: block;
  margin-top: 10px;
  padding: 10px;
  font-size: 15px;
  color: #333333;
  border: 1px solid #555555;
  border-radius: 5px;
}

document.getElementById('test').addEventListener('focus', function() {
  changeCursorPos('test')
});

function changeCursorPos(inputId, pos) {
  var inpObj = document.getElementById(inputId);
  if (inpObj.setSelectionRange) {
    inpObj.setSelectionRange(0, 0);
  }
}

测试浏览器firefox（chrome请使用tab来切换焦点，具体原因后半部分会进一步解释）。实现结果与预期一致，光标被定位在了文本的最前方。

实现

<form>
  <label>自动添加“万元”单位的input</label>
  <input id="money" name="money" placeholder="万元">
</form>

body {
  background-color: #f6f6f6;
}

form {
  padding: 30px;
}

input {
  display: block;
  margin-top: 10px;
  padding: 10px;
  font-size: 15px;
  color: #333333;
  border: 1px solid #555555;
  border-radius: 5px;
}

document.getElementById('money').addEventListener('focus', function(e) {
  e.preventDefault();
  var val = this.value,
    len = val.length;
  if (val.indexOf('万元') !== -1) {
    pos = len - 2;
    changeCursorPos('money', pos);
  } else {
    $(this).val(val + '万元');
    pos = len;
    changeCursorPos('money', pos);
  }
});

function changeCursorPos(inputId, pos) {
  var inpObj = document.getElementById(inputId);
  if (inpObj.setSelectionRange) {
    inpObj.setSelectionRange(pos, pos);
  } else {
    console.log('不兼容该方法');
  }
}

BUG fix

理论上来说，我已经完成了目标需求，在firefox下点击输入框或用tab、chrome下使用tab都可以实现功能。但是，我在上面也提到了，chrome中，只能使用tab，如果你用点击输入框的方式进行测试，会发现，这个方法失效了，光标仍然处于文本的末尾。
造成这个问题的原因是chrome长期以来存在的一个bug：setSelectionRange() for input/textarea during onFocus fails when mouse clicks
这个bug似乎是由于chrome中默认的事件处理顺序引起的，有人提到

WebKit and Blink handle tasks for mousedown in the following order:
1. Focus
2. Selection
The order looks reversed in other browsers

chrome默认的selection操作将会覆盖focus中的js操作代码。为了解决这个问题，第一个想到的就是阻止浏览器默认行为

e.prevenDefault();
//return false;

然而，尝试之后发现，阻止浏览器默认行为在这个i问题上并不生效。需要寻求其他方法。

第一种方法

解决这个问题的第一个思路就是，将changeCursorPos()这个方法的启动时间延迟，最好能够在浏览器默认行为之后。这个实现非阻塞有异曲同工之处，因此，可以使用定时器setTimeout来改变其在队列中的顺序

setTimeout(function(){
    changeCursorPos('money', pos);
}, 0);

针对这个改动，只需要将原js代码中的

changeCursorPos('money', pos);

全部替换为

setTimeout(function(){
    changeCursorPos('money', pos);
}, 0);

其效果可以在线观看
然而，我们在测试时发现，这个方法存在以下两个重要问题：

效果较差。光标会先处于文本尾部，在跳至文本开头，对用户显示不友好。
失效。更重要的问题是，即使使用setTimeout也不能保证将changeCursorPos操作最后执行，可以发现，在测试中，时常会出现其失效的情况。

解决失效问题

要解决失效问题，其实就是要保证将changeCursorPos的执行顺序添加至最后。
需要了解，在鼠标点击与tab切换时，这两个操作之间的区别。在tab切换时，相当于调用了inputElement.focus()，或者准确地说，在使用setSelectionRange时两者的操作结果相同。而当使用鼠标点击选择输入框时，不仅会触发focus监听，还会触发一个click监听，而且通过测试可以发现，click事件触发晚于focus事件。因此，如果在click监听中也添加changeCursorPos操作，就可以保证该操作不会被chrome的默认行为覆盖掉。
html与css不变，js代码如下

//为input添加一个click监听，保证changeCursorPos在chrome默认focus事件之后执行
document.getElementById('money').addEventListener('click', function(e) {
  var val = this.value,
    len = val.length;
  if (val.indexOf('万元') !== -1) {
    pos = len - 2;
    setTimeout(function() {
      changeCursorPos('money', pos);
    }, 0);
  } else {
    $(this).val(val + '万元');
    pos = len;
    setTimeout(function() {
      changeCursorPos('money', pos);
    }, 0);
  }
});

//保留focus监听，确保tab的正确使用
document.getElementById('money').addEventListener('focus', function(e) {
  var val = this.value,
    len = val.length;
  if (val.indexOf('万元') !== -1) {
    pos = len - 2;
    setTimeout(function() {
      changeCursorPos('money', pos);
    }, 0);
  } else {
    $(this).val(val + '万元');
    pos = len;
    setTimeout(function() {
      changeCursorPos('money', pos);
    }, 0);
  }
});

function changeCursorPos(inputId, pos) {
  var inpObj = document.getElementById(inputId);
  if (inpObj.setSelectionRange) {
    inpObj.setSelectionRange(pos, pos);
  } else {
    console.log('不兼容该方法');
  }
}

点击查看实例
然而，再来看看之前碰到的两个问题：

效果较差。光标会先处于文本尾部，在跳至文本开头，对用户显示不友好。
失效。更重要的问题是，即使使用setTimeout也不能保证将changeCursorPos操作最后执行，可以发现，在测试中，时常会出现其失效的情况。

可见，上一部分代码已经解决了失效的问题，保证了功能的实现。然而，这个方案还不完美，其效果差的问题仍然没有解决。因此，还需要找一个更完美的实现方案。

最终的解决方案

最终的解决方案的思路如下：

通过文档的按键监听来判断是使用tab操作还是鼠标点击操作，并设置标志位
当触发focus监听时，判断操作方式，如果focus事件的来源为tab操作则转执行changeCursorPos，否则使其失去焦点
在click监听中手动触发focus事件，并将设置标志，模拟tab行为

代码如下

<form>
  <label>解决chrome中点击input的bug的方案</label>
  <input id="exception" placeholder="exception">
  <input id="money" name="money" placeholder="万元">
</form>

body {
  background-color: #f6f6f6;
}

form {
  padding: 30px;
}

input {
    display: block;
    margin-top: 10px;
    padding: 10px;
    font-size: 15px;
    color: #333333;
    border: 1px solid #555555;
    border-radius: 5px;
  }

var tab = false;
document.addEventListener('keydown', function(e) {
  if (e.keyCode == 9) {
    tab = true;
  }
});
document.getElementById('exception').addEventListener('focus', function() {
  tab = false;
});
document.getElementById('money').addEventListener('click', function() {
  tab = true;
  this.focus();
});

document.getElementById('money').addEventListener('focus', function() {
  if (tab) {
    var val = this.value,
      len = val.length;
    if (val.indexOf('万元') !== -1) {
      pos = len - 2;
      setTimeout(function() {
        changeCursorPos('money', pos);
      }, 0);
    } else {
      $(this).val(val + '万元');
      pos = len;
      setTimeout(function() {
        changeCursorPos('money', pos);
      }, 0);
    }
  } else {
    this.blur();
  }
  tab = false;
});

function changeCursorPos(inputId, pos) {
  var inpObj = document.getElementById(inputId);
  if (inpObj.setSelectionRange) {
    inpObj.setSelectionRange(pos, pos);
  } else {
    console.log('不兼容该方法');
  }
}