js控制输入框光标位置(setSelectionRange详解)

本文介绍如何使用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);

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

兼容性

那么,这个方法的兼容性怎么样呢?

FeatureChromeFirefox(Gecko)Internet ExplorerOperaSafari
Basic support1.01.0 (1.7 or earlier)98.0(Yes)
selectionDirection158.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操作最后执行,可以发现,在测试中,时常会出现其失效的情况。

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

最终的解决方案

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

  1. 通过文档的按键监听来判断是使用tab操作还是鼠标点击操作,并设置标志位
  2. 当触发focus监听时,判断操作方式,如果focus事件的来源为tab操作则转执行changeCursorPos,否则使其失去焦点
  3. 在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('不兼容该方法');
  }
}

在线演示
可以看到,在演示代码中,使用了全局标量tab作为标志,代码复用性较低,不太好,在实际项目中可以使用一些闭包或模块方式来进行处理,做成一个更加通用的功能。此处抛砖引玉,主要是展示实现的思路。

总结

setSelectionRange方法可以帮助我们很容易的选中文本中的某一部分内容。同时,活用该方法也可以实现设置光标位置的功能。然而,chrome中存在的一个小bug导致该功能在鼠标点击时失效。文中研究了修复该bug的一些方法。然而作为抛砖引用,还是期待更多简便与解决方案。

<think>我们需要在Vue中实现一个输入框,仅允许输入汉字、字母、数字以及-_·.@这些字符。 思路: 1. 我们可以使用输入框的input事件来监听用户的输入。 2. 当输入内容时,使用正则表达式过滤掉不允许的字符。 3. 将过滤后的字符串重新赋值给输入框绑定的变量。 注意:由于直接修改输入框的值可能会导致光标位置变动,我们可以通过以下方式避免: - 在输入事件中,我们获取当前输入的值,然后过滤非法字符,再将过滤后的值赋给绑定的变量。 - 但是,如果直接替换整个字符串,会导致光标跳到最后。为了保持光标位置,我们可以使用更复杂的方法,比如记录光标位置,然后设置光标位置。但这里我们采用一个简单的方法:在输入时过滤,同时使用一个临时变量来保存旧值,然后通过$nextTick来设置输入框的值和光标位置(这种方法相对复杂)。 另一种更简单且用户体验较好的做法是使用自定义指令,在输入时过滤非法字符,同时处理光标位置。 然而,为了简化,我们可以使用一个简单的方法:在输入事件中,我们替换非法字符为空,然后更新绑定值。这种方法在大多数情况下可以接受,但可能会在用户使用退格键或插入文本时出现光标跳动的问题。 这里我们采用一个折中的方案:使用一个方法过滤输入,并更新绑定值,同时利用Vue的v-model绑定。 步骤: 1. 在模板中,给输入框绑定input事件,并在事件处理函数中过滤输入。 2. 使用v-model绑定数据,但注意,我们会在input事件中修改这个数据。 但是,直接使用v-model和input事件处理函数可能会造成冲突,因为v-model本身会监听input事件。所以我们可以这样: - 使用v-model绑定数据,同时监听input事件,在input事件处理函数中修改绑定的值。 具体实现: - 在input事件处理函数中,获取输入框的值,然后过滤非法字符,将过滤后的值赋给v-model绑定的变量。 由于过滤后赋值,会触发重新渲染,光标位置会跳到末尾。为了解决这个问题,我们可以使用自定义指令来保持光标位置。 但是,为了保持简单,我们先实现基本功能,然后再考虑优化光标位置。 基本实现: 正则表达式:我们允许的字符包括: - 汉字:\u4e00-\u9fa5 - 字母:a-zA-Z - 数字:0-9 - 特殊字符:-_·.@ 因此,我们可以使用正则表达式:/^[\u4e00-\u9fa5a-zA-Z0-9\-_·.@]*$/ 但是,我们是要过滤掉非这些字符,所以可以用一个正则表达式来匹配非法字符,然后替换为空。 非法字符的正则:/[^\u4e00-\u9fa5a-zA-Z0-9\-_·.@]/g 注意:在正则表达式中,点(.)在字符组中需要转义吗?实际上,在字符组中,大部分特殊字符不需要转义,但是为了清晰,我们可以转义,或者不转义也可以。但是要注意,点(.)在字符组中表示字面量点,所以不需要转义。但是为了安全,我们可以转义,因为转义后也可以匹配点。另外,连字符(-)需要放在字符组的开头或结尾,否则会被当成范围符号。 因此,我们将连字符放在字符组末尾,避免歧义。正则表达式可以写成:/[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g 但是注意,点(.)在字符组中不需要转义,因为在中括号里面,大部分特殊字符都会失去特殊含义。不过,为了可读性,我们可以不转义。 实现代码: 方法1:使用input事件处理函数(简单,但可能光标跳动) 示例代码: 模板: <input v-model="inputValue" @input="filterInput"> 方法: filterInput(event) { // 获取当前值 let value = event.target.value; // 过滤非法字符 let filteredValue = value.replace(/[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g, ''); // 更新绑定值 this.inputValue = filteredValue; } 但是,这种方法会导致光标每次都会跳到末尾,因为每次输入都会将整个输入框的值替换。 为了保持光标位置,我们可以记录当前光标位置,然后在更新值后恢复光标位置。 改进: filterInput(event) { let value = event.target.value; let start = event.target.selectionStart; // 记录光标开始位置 let end = event.target.selectionEnd; // 记录光标结束位置 let filteredValue = value.replace(/[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g, ''); this.inputValue = filteredValue; // 使用$nextTick确保在DOM更新后设置光标位置 this.$nextTick(() => { event.target.setSelectionRange(start, end); }); } 但是,注意:当我们过滤字符后,字符串长度可能发生变化,因此光标位置可能也需要调整。比如,如果我们在字符串中间输入了一个非法字符,它被过滤掉,那么光标位置应该保持不变(因为删除了一个字符,光标应该在原位置的前一个位置?)。但实际上,我们替换了整个字符串,所以光标位置需要根据过滤后的字符串进行调整。 调整方法:我们可以计算从开始到光标位置之前的字符串中,被过滤掉了多少个字符,然后调整光标位置。 然而,这样实现起来比较复杂。因此,我们可以采用另一种思路:在用户输入时,阻止非法字符的输入,而不是在输入后过滤。这可以通过keydown事件来实现,但是keydown事件无法判断字符(特别是组合输入,如中文输入法),所以不太可靠。 因此,我们采用一个折中的方案:接受光标跳到末尾,因为用户通常不会在中间输入大量非法字符,或者使用自定义指令。 这里我们使用一个自定义指令来实现,这样可以在多个地方复用。 自定义指令实现: 我们可以创建一个指令,在输入框上使用,当输入框的值变化时,过滤非法字符,并调整光标位置。 自定义指令代码: 在Vue项目中,我们可以这样定义指令: 在main.js中,或者单独定义然后在main.js引入: ```javascript Vue.directive('filter-input', { inserted: function (el) { el.addEventListener('input', function (event) { const target = event.target const reg = /[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g // 记录光标位置 let start = target.selectionStart let end = target.selectionEnd // 记录当前值 let value = target.value // 过滤前的光标位置之前的字符 let before = value.substring(0, start) // 过滤后的字符 let beforeFiltered = before.replace(reg, '') // 计算光标位置偏移量(过滤了多少个字符) let offset = before.length - beforeFiltered.length // 新的光标位置 let newStart = start - offset let newEnd = end - (value.length - value.replace(reg, '').length) // 更新值 target.value = value.replace(reg, '') // 设置光标位置 target.setSelectionRange(newStart, newEnd) // 触发input事件,使v-model更新 target.dispatchEvent(new Event('input')) }) } }) ``` 但是,上面的自定义指令中,计算新光标位置比较复杂,而且我们过滤了整个字符串,然后重新设置整个字符串的值,所以我们可以简化:只记录过滤前的光标位置,然后过滤整个字符串,然后计算从开始到原光标位置之间的字符串被过滤后还剩多少字符,作为新光标位置。 另一种做法:在过滤后,将光标设置到新字符串的相同位置(即原位置减去被过滤的字符数)。但是,由于我们不知道在光标前有多少个非法字符被过滤,所以无法准确计算。 因此,我们可以采用一个简单的方法:在过滤后,将光标设置到过滤后字符串的末尾?这样用户体验不好。 经过权衡,我们决定使用简单的方法:在输入事件中过滤,然后设置光标到末尾(如果用户是在中间输入,那么输入一个非法字符后,光标会跳到末尾,但是用户继续输入合法字符,光标又回到末尾,体验不好)。因此,我们采用自定义指令,并尝试保持光标位置。 这里我们参考一个实现:在过滤时,只过滤新输入的字符?但是input事件是输入框整个值的变化,我们不知道用户输入的位置。 所以,我们采用以下方法: 1. 记录当前光标位置输入框的值。 2. 过滤整个字符串。 3. 计算在光标位置之前的字符串中,被过滤掉的字符数,然后调整光标位置为:原光标位置 - 被过滤的字符数(在光标之前的)。 具体实现: let value = target.value; let newValue = value.replace(reg, ''); // 计算在光标之前的字符串被过滤了多少个字符 let before = value.substring(0, start); let beforeFiltered = before.replace(reg, ''); let offset = before.length - beforeFiltered.length; let newStart = start - offset; let newEnd = newStart; // 或者也可以计算end,但通常我们只需要设置开始位置,结束位置和开始位置一样(没有选择文本) // 但是如果有选择文本,那么我们需要计算结束位置? let after = value.substring(end); let afterFiltered = after.replace(reg, ''); let endOffset = after.length - afterFiltered.length; let newEnd = end - (offset + endOffset); // 这样计算不对,因为整个字符串都被过滤了,我们只需要计算整个字符串被过滤的字符数,然后调整结束位置? 实际上,我们无法精确计算选择区域的变化,所以我们可以将光标位置设置为newStart,并将选择区域设置为长度为0(即没有选择文本)。 因此,我们只设置光标位置为newStart,结束位置也设置为newStart。 代码: 在自定义指令的input事件处理函数中: const reg = /[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g; let start = target.selectionStart; let end = target.selectionEnd; let value = target.value; let newValue = value.replace(reg, ''); // 计算在光标之前的字符串被过滤的字符数 let before = value.substring(0, start); let beforeFiltered = before.replace(reg, ''); let offset = before.length - beforeFiltered.length; let newStart = start - offset; // 设置新值 target.value = newValue; // 设置光标位置 target.setSelectionRange(newStart, newStart); // 触发input事件,更新v-model target.dispatchEvent(new Event('input')); 但是,这个计算可能并不完全准确,因为如果用户选择了文本然后输入,那么选择文本会被替换,所以我们需要考虑选择文本被替换的情况。但上述方法在大多数情况下是有效的。 然而,由于输入法组合期间,输入事件可能会被多次触发,而且我们过滤了非法字符,可能会干扰输入法。所以,我们还需要考虑输入法状态。 我们可以通过compositionstart和compositionend事件来标记是否在输入法组合输入过程中。在组合输入过程中,我们不进行过滤,等组合结束(输入法选词完成)后再过滤。 所以,我们需要在自定义指令中增加对输入法状态的处理。 考虑到实现的复杂性,我们决定采用一个已有的库或者使用更简单的方法:在input事件中,如果处于输入法组合状态,则跳过过滤。 因此,我们增加一个标记: let composing = false; el.addEventListener('compositionstart', () => { composing = true; }); el.addEventListener('compositionend', (event) => { composing = false; // 组合结束后,我们需要触发一次过滤 // 因为组合结束后,输入框的值已经改变,所以我们需要在这里调用input事件处理函数 // 但是注意,在compositionend事件后,会触发input事件,所以我们可以不用在这里处理,或者在这里处理后再触发一次input事件 // 实际上,在compositionend之后,浏览器会触发input事件,所以我们可以在input事件中判断composing状态 }); 然后在input事件处理函数中: if (composing) return; 所以,完整的自定义指令: 注意:由于每个输入框实例都需要独立的composing状态,所以我们在指令的inserted钩子中为每个元素单独设置。 代码: ```javascript Vue.directive('filter-input', { inserted: function (el) { let composing = false; el.addEventListener('compositionstart', () => { composing = true; }); el.addEventListener('compositionend', () => { composing = false; // 手动触发input事件,因为输入法结束后,可能输入了非法字符,我们需要过滤 // 但是注意,compositionend后会自动触发input事件,所以这里不需要重复处理,但为了确保,我们可以在input事件中处理 }); el.addEventListener('input', function (event) { if (composing) return; const target = event.target const reg = /[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g const start = target.selectionStart const end = target.selectionEnd const value = target.value const newValue = value.replace(reg, '') // 如果过滤后的值和原来一样,那么不需要调整 if (newValue === value) { return } // 计算新光标位置 let before = value.substring(0, start) let beforeFiltered = before.replace(reg, '') let offset = before.length - beforeFiltered.length let newStart = start - offset // 设置新值 target.value = newValue // 设置光标 target.setSelectionRange(newStart, newStart) // 触发input事件,以便v-model更新(因为直接修改了target.value,所以需要触发input事件) target.dispatchEvent(new Event('input')) }) } }) ``` 使用指令: 在模板中,我们可以这样使用: <input v-model="inputValue" v-filter-input> 这样,输入框就会自动过滤非法字符,并且尽量保持光标位置。 但是,注意:如果输入框的值是通过v-model绑定的,那么我们在自定义指令中修改了target.value,并且手动触发了input事件,所以v-model绑定的值也会更新。 另外,我们也可以使用一个变通的方法:在自定义指令中不直接修改DOM的值,而是通过绑定值的变化,但是这样需要访问组件实例,比较麻烦。所以这里我们直接修改DOM,然后触发input事件,让v-model更新。 现在,我们给出一个完整的Vue组件示例: 假设我们的组件名为MyInput,使用自定义指令。 步骤: 1. 在全局或局部定义自定义指令v-filter-input。 2. 在组件的input元素上使用该指令。 全局定义(在main.js中): Vue.directive('filter-input', ...) 或者在组件中局部定义: 由于时间关系,我们采用全局定义。 组件代码: ```vue <template> <div> <input v-model="inputValue" v-filter-input> </div> </template> <script> export default { data() { return { inputValue: '' } } } </script> ``` 这样,输入框就只允许输入汉字、字母、数字和-_·.@这些字符了。 但是,注意:正则表达式中,我们使用了\u4e00-\u9fa5来匹配汉字,但有些生僻字可能不在这个范围,如果需要更全面的汉字匹配,可以使用[\u4e00-\u9fa5\u3400-\u4db5\u20000-\u2a6d6\u2a700-\u2b734\u2b740-\u2b81d]等,但通常\u4e00-\u9fa5覆盖了大部分常用汉字。 另外,点(.)和连字符(-)在正则表达式中已经处理,注意连字符在字符组中要放在最后。 最后,我们也可以使用另一种方法:在v-model上使用计算属性的setter,但这样同样会遇到光标问题。 综上所述,我们推荐使用自定义指令的方法。 如果项目中没有使用自定义指令,或者不想使用指令,也可以使用组件封装,但原理类似。 下面我们给出完整的自定义指令代码(全局)和组件示例。 注意:在Vue3中,自定义指令的钩子函数有所不同,但思路类似。这里我们以Vue2为例。 对于Vue3,自定义指令的mounted钩子相当于Vue2的inserted。 因此,如果使用Vue3,可以这样定义: ```javascript // Vue3 const app = createApp(App) app.directive('filter-input', { mounted: function (el) { // 同样的代码 } }) ``` 以上,我们实现了需求。 由于代码较长,我们总结一下: 1. 定义自定义指令v-filter-input,在input事件中过滤非法字符,并调整光标位置。 2. 使用composition事件来避免在输入法组合期间过滤。 3. 在过滤后,通过计算光标位置之前的字符串被过滤的字符数,调整光标位置。 最后,我们给出一个完整的示例代码(Vue2): 在main.js中定义全局指令: ```javascript import Vue from 'vue' Vue.directive('filter-input', { inserted: function (el) { let composing = false el.addEventListener('compositionstart', () => { composing = true }) el.addEventListener('compositionend', () => { composing = false }) el.addEventListener('input', function (event) { if (composing) return const target = event.target const reg = /[^\u4e00-\u9fa5a-zA-Z0-9_·.@-]/g const start = target.selectionStart const end = target.selectionEnd const value = target.value const newValue = value.replace(reg, '') if (newValue === value) { return } let before = value.substring(0, start) let beforeFiltered = before.replace(reg, '') let offset = before.length - beforeFiltered.length let newStart = start - offset target.value = newValue target.setSelectionRange(newStart, newStart) // 触发input事件,更新v-model target.dispatchEvent(new Event('input')) }) } }) ``` 然后在组件中使用: ```vue <template> <input v-model="inputValue" v-filter-input> </template> <script> export default { data() { return { inputValue: '' } } } </script> ``` 这样,输入框就只能输入汉字、字母、数字和-_·.@字符了。 注意:这个自定义指令在移动端和PC端都适用,并且考虑了输入法的情况。 但是,如果用户粘贴内容,也可以过滤。因为粘贴也会触发input事件。 因此,这个方案是可行的。 最后,如果用户使用退格键删除,或者使用删除键删除,这些操作不会输入非法字符,所以不会受到影响。 如果遇到问题,比如光标位置计算错误,可以进一步调整。 我们也可以考虑使用现有的库,例如vue-input-filter,但自己实现可以更灵活。 以上,我们完成了需求。 相关问题:</think>### Vue输入框仅允许输入汉字、字母、数字与-_·.@字符的实现 在Vue中实现输入框字符限制,可以通过以下两种方式实现: #### 方法1:使用`@input`事件处理(简单实现,但光标位置可能跳动) ```vue <template> <input v-model="inputValue" @input="handleInput" placeholder="只能输入汉字、字母、数字和-_·.@" > </template> <script> export default { data() { return { inputValue: '' } }, methods: { handleInput(event) { // 正则表达式:允许汉字、字母、数字、-_·.@ const regex = /[^\u4e00-\u9fa5a-zA-Z0-9\-_·.@]/g; this.inputValue = event.target.value.replace(regex, ''); } } } </script> ``` **代码说明**: 1. `v-model`双向绑定输入值 2. `@input`事件实时处理输入 3. 正则`/[^\u4e00-\u9fa5a-zA-Z0-9\-_·.@]/g`匹配非法字符: - `\u4e00-\u9fa5`:汉字范围 - `a-zA-Z`:所有字母 - `0-9`:数字 - `\-_·.@`:特殊字符(-、_、·、.、@) 4. `replace()`删除非法字符 #### 方法2:自定义指令(完美光标处理,推荐) ```javascript // 在main.js或单独文件中定义指令 Vue.directive('filter-input', { bind(el) { let composing = false; el.addEventListener('compositionstart', () => { composing = true; }); el.addEventListener('compositionend', (event) => { composing = false; event.target.dispatchEvent(new Event('input')); }); el.addEventListener('input', (event) => { if (composing) return; const target = event.target; const regex = /[^\u4e00-\u9fa5a-zA-Z0-9\-_·.@]/g; const start = target.selectionStart; const value = target.value; // 过滤非法字符 const newValue = value.replace(regex, ''); if (value === newValue) return; // 计算新光标位置 const diff = value.length - newValue.length; const newStart = start - diff; // 更新值并设置光标 target.value = newValue; target.setSelectionRange(newStart, newStart); // 触发v-model更新 target.dispatchEvent(new Event('input')); }); } }); ``` **使用自定义指令**: ```vue <template> <input v-model="inputValue" v-filter-input placeholder="使用指令:只能输入汉字、字母、数字和-_·.@" > </template> <script> export default { data() { return { inputValue: '' } } } </script> ``` **指令核心逻辑**: 1. **处理输入法组合**: - `compositionstart`:标记中文输入开始 - `compositionend`:标记中文输入结束 2. **光标位置计算**: - 记录原始光标位置`selectionStart` - 计算过滤前后文本长度差`diff` - 使用`setSelectionRange()`精确保存光标位置 3. **触发更新**: - 手动触发`input`事件确保v-model同步 #### 正则表达式详解 ```regex /[^\u4e00-\u9fa5a-zA-Z0-9\-_·.@]/g ``` - `\u4e00-\u9fa5`:中文Unicode范围 - `a-zA-Z`:所有大小写字母 - `0-9`:数字 - `\-_·.@`:允许的特殊字符(注意`-`需要转义) - `[^...]`:匹配不在括号内的任意字符 - `/g`:全局匹配 #### 注意事项 1. **特殊字符说明**: - `·` 是中文中间点(Unicode: U+00B7) - `-` 需转义为`\-`防止被识别为范围符 2. **输入法兼容**: - 通过`compositionstart/end`事件确保中文输入法正常工作 3. **粘贴操作**: - 两种方案都支持粘贴时自动过滤非法字符
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值