一个数字键盘引发的血案——移动端H5输入框、光标、数字键盘全假套件实现
为啥要写假键盘?
还是输入框、光标全假的假键盘?
手机自带的不用非得写个假的,吃饱没事干吧?
装逼?炫技?
宝宝也是被逼的,宝宝也很委屈~.~
问题产生背景
移动端H5项目需求点:
进入某页面自动弹出带小数点的数字键盘,并且自带输入验证,比如金额——只能输入数字和小数点,并且只能输入一位小数点、小数位不超过2位,且输入前验证不合法就不让输入、(UE特加功能——定制光标颜色>.<简直是反人类的需求)。细分如下:
- 进入相关页面,输入框自动获取焦点
- 键盘自动弹出
- 弹出带小数点的数字键盘
- 数字输入前自动验证,只能输入一个小数点,小数位数不超过2位,超过就不能继续输入
- 如果光标在第一位,此时键入的是'.',则自动放入'0'再插入'.'
实现方案拟定
1. 基于input + 手机自带键盘实现方案
(1) 针对功能点1,可以给 input 设置属性 autofocus , 输入框就能自动聚焦。 轻松搞定
(2) 针对功能点2 ,给input设置属性 autofocus 会自动聚焦但是键盘并不会自动弹出;
必须手动点击输入框键盘才会弹出; 于是在进入页面的时候用js触发click或者foucus,发现键
盘也不会自动弹出,延时click、focus也没能弹出;那么只有最后一种方案——就是让NA端提
供让键盘弹出的方法。 纯前端无法搞定,需要NA端协助/,或者找PM砍掉自动弹键盘的需求
>.<(勉强能够接受)
(3) 针对功能点3,弹数字键盘的方法可以设置 type = "number" 或者type = "tel"; 前者
在Andriod可以弹出数字键盘在ios端只能弹全键盘,后者在Android和ios弹出的都是数字键
盘,但是!!坑爹的,弹出的数字键盘没有小数点!(我的华为荣耀9倒是很给力的给我弹了
个带小数点的数字键盘,不容易啊啊) 只能选择type = "number",勉强能接受ios弹全键盘吧
(4) 针对功能点4, 设置type = "number",发现可以不停的输入小数点啊啊
啊啊看着真的要疯了,第一次输入小数点也不能自动变成'0.'
这时候聪明的你一定想到要使用事件监听键入的字符,在输入之前进行判断,然后决定
是否放入输入框。
你肯定又会开心的想到一堆可能有用的事件:onkeydown,onkeyup,onchange,oninput,
onpropertychange,textInput。
路漫漫其修远兮啊~经过不断尝试之后仍然发现很多问题。
- onkeyup——虽然每增加删除字符都会触发,但增加字符的时候是值输入之后才触发,无法做到输入前验证;
- onchange——是在内容改变(两次内容有可能相等)且失去焦点时触发,也无法做到输入前验证。
- onpropertychange——onchange事件在内容改变(两次内容有可能还是相等的)且失去焦点时触发;即每增加或删除一个字符就会触发,通过js改变也会触发该事件,但是该事件IE专有。
- oninput——移动端很多手机不支持。
(只剩下onkeyup/textInput,还有一线希望刚芭蕾>.<。)
- onkeyup——其事件有两个相关属性event.key和event.keyCode。event.key在我的华为荣耀9手机上都不生效(其他低版本手机可想而知)。但其还有一个属性event.keyCode其在PC端的值是键入字符的ascii码。但在手机端输入任何数字或者小数点其值均为229(华为荣耀9测试),所以onkeyup也不能用。
- ontextInput——在pc和移动端都支持!!!(功夫不负有心人)其event.data可以获取到输入的值。欢天喜地,举国欢庆,啊哈哈~~
终于松了一口气,只要能在输入前获取值就能验证了呀。
自信满满的一口气写完验证过程:
html
<input
id="amount-input"
autofocus
type="number"
@textInput="checkNumber"
v-model="amount"
require/>
js
checkNumber(event) {
var key = event.data || '';
if (key.search(/[0-9\.]/) > -1) {
var value = document.getElementById('amount-input').value;
if (key === '.' && value.search(/\./) > -1) {
event.preventDefault();
if (value.search(/\.\d{2}/) > -1) {
event.preventDefault();
} else {
event.preventDefault();
杯具再次发生了~~~~~我所期望的效果仍然没有达到。
通过value获取输入框内所有字符失败
发现 input type = number 取到的value只能是数值 , 无法获取输入框里的所有字符。
也就是说如果输入'12.',通过value获取到是'12',只输入'.',value获取到的是' '空字符串,
获取不到小数点。
这样就无法判断是否输入小数点,因而不能判断是否还能输入小数点,那就还是能输入无数个
小数点,问题依然得不到解决。
尝试:
- 使用VUE中双向绑定的this.amount来获取输入的所有字符,发现this.amount获取到的和value获取值的情况相同。尝试失败。
- 通过textInput获取到的输入值,自己维护一个字符数组。但是textInput在删除时不会触发,因而不能实时获取input输入框里面的所有准确字符;而且由于无法获取光标在input输入框的具体位置而无法确定删除的是哪个字符,因而字符数组无法准确维护。尝试失败。
(5) 针对功能点5,功能4解决了,功能5是小case。。。
所以基于input + 手机自带键盘实现方案要满足以上需求难以实现。
2. 基于input + 假数字键盘实现方案
若是用假键盘加原生input输入框,需要做到:
- 禁用手机自带键盘
- 获取Input输入框中的内容
禁用手机自带键盘,在没有NA暴露的方法支持的情况下,可以设置Input的readonly属性。这
样的话输入框也不能添加删除字符了。
若在可以要NA端提供禁用手机自带键盘的方法的前提下,要实现点击假键盘输入框能添加删
除字符。
若是只从后面添加删除,很容易实现,只需要将点击键盘对应的字符拼接到 Input type=text
获取到的value的后面,删除同理。
但是要是光标不在最后一位,而是在中间
那么当我们点击假键盘添加或删除字符的时候,如何能知道添加或删除字符的位置呢。
也许需要获取光标位置。
目前只有IE和火狐支持的document.selection,selectionStart可以获取光标位置。
// 获取光标位置
function getCursortPosition (textDom) {
var cursorPos = 0;
if (document.selection) {
// IE Support
textDom.focus ();
var selectRange = document.selection.createRange();
selectRange.moveStart ('character', -textDom.value.length);
cursorPos = selectRange.text.length;
}else if (textDom.selectionStart || textDom.selectionStart == '0') {
// Firefox support
cursorPos = textDom.selectionStart;
return cursorPos;
由于我们的是移动端H5开发项目,考虑兼容性,显然以上方法不能兼容大部分的机型。
3. 输入框、光标、数字键盘全假实现方案
以上两种方案均难以实现,因此我只能大胆想象,要实现满足以上需求的假键盘就得实现假输
入框、假光标、假keyboard的一套装备。这样所有的元素我都能控制,上面的那些问题全
部可以解决。
雏形
若是实现只能从最后面增加删除没有光标的假键盘非常容易,只需要给每个键绑定一个click事
件,维护一个数组,每次从后面push或者pop就能维护输入框中的内容。
但是这样跟正真的输入框效果比体验太差了。
难点
要实现体验跟原生键盘一样并且自带输入验证的假键盘,难点主要在于:
- 有光标,且光标闪动
- 光标定位,点击数字中间光标自动移过去
- 根据光标的位置实现插入删除
- 失去焦点光标隐藏,点击输入框光标显示并且弹出键盘
原生js实现
对于光标实现,创造一个元素设置背景色,可以控制它隐藏和出现。
对于“点击数字中间光标自动移过去 ”,可以每添加一个数字或者小数点就先加一个带点击事件的空元素space,再添加要输入的字符。space是为了绑定一个点击事件,告诉光标要移动到的位置。
//字符插入,在光标前插入字符
function insert(value) {
var span = document.createElement("span"); //创建包含值的元素
span.className = 'val';
span.innerText = value;
var space = document.createElement("span");
space.className = 'space';
space.addEventListener('click', moveCursor);
var cursor = document.getElementsByClassName('cursor')[0];
inputArea.insertBefore(space, cursor);//插入空列
inputArea.insertBefore(span, cursor);//插入值
删除时也是先删除光标之前的数字字符,再删除space元素。
//删除元素
function deleteElement() {
setCursorFlash();
var cursor = document.getElementsByClassName('cursor')[0];
var n = 2; //两个删除动作
while(cursor.previousSibling && n > 0) {
inputArea.removeChild(cursor.previousSibling );
n--;
if(getInputStr().search(/^\.\d*/) > -1) {
insert(0);
if(getInputStr() === ''){ //元素为空placeholder显示
var placeHolder = document.getElementsByClassName('holder')[0];
placeHolder.className = 'holder';
通过chrome里面元素审查可以看到添加删除的过程。
每一个space元素都绑定一个click事件,用来移动光标,最右边有个right-space可以用来放placeholder,也可以添加click事件,点击时光标总是移到最后一位。
//移动光标位置
function moveCursor(event) {
var cursor = document.getElementsByClassName('cursor')[0];//获取光标
if(event.currentTarget.className == 'right-space'){
if(!cursor.nextSibling || cursor.nextSibling.nodeName == '#text'){
return;
} else {
var ele = cursor.nextSibling;
inputArea.insertBefore(inputArea.lastElementChild, ele);
inputArea.appendChild(cursor);
}else {
var tempEle = event.currentTarget.nextSibling;
// var nodeName = event.currentTarget.nextSibling.nodeName;
// var cursor = document.getElementsByClassName('cursor')[0];
if(!tempEle || tempEle.nodeName == '#text') {
var temp = event.currentTarget.previousSibling;
var ele = inputArea.replaceChild( event.currentTarget, cursor);//把光标替换成当前元素
inputArea.appendChild(ele);
} else {
var temp = event.currentTarget.nextSibling;
var ele = inputArea.replaceChild( event.currentTarget, cursor);//把光标替换成当前元素
inputArea.insertBefore(ele, temp);
从上面的GIF图可以看出,光标始终只有一个而且有个定时任务。光标的闪动设置如下,使用原生的setInterval实现。
//设置光标定时任务
function setCursorFlash() {
//placeholder 隐藏
var placeHolder = document.getElementsByClassName('holder')[0];
placeHolder.className = 'holder hidden';
var cursor = document.getElementsByClassName('cursor')[0];
var inputContainer = document.getElementsByClassName('input-container')[0];
cursor.className = "cursor";
var isShowCursor = true;
inputContainer.focus();
showKeyBoard();
if (intervalId) {
clearInterval(intervalId);
intervalId = setInterval(function() {
isShowCursor = !isShowCursor;
if (isShowCursor) {
cursor.className = 'cursor';
} else {
cursor.className = 'cursor hidden';
}, 1000);
最终使用原生js实现的带输入框、光标,keyboard的假数字键盘。
除了完成以上功能,还实现了输入前验证功能,为了跟接近真实输入框表现,同时实现了点击
输入框获取焦点、光标闪动、弹出键盘;失去焦点光标消失。
为什么不使用jQuery?
一是因为,当前的H5项目没有使用jQuery。
二是因为使用VUE之后很少需要直接操作DOM,少数方法自己实现更轻量,若是只为了使用
其一两个方法而引入jQuery,会使得项目更重。
原生js实现效果
源码 https:// github.com/DaisyWang88/ js-keyboard
手机扫码验证:
http:// sandbox.runjs.cn/show/m vjrcagy (chrome插件url二维码生成器 GetCrx.cn )
由于移动端click事件有300毫秒延时,因此原生js实现的效果,有点不是很流畅。若使用原生
JS实现版的需要使fastclick或zepto的tap事件解决延时问题。
PS : 之前说‘VUE本身解决300毫秒延时问题’,考证之后发现不对,给大家带来困扰实在抱歉。
考证之后发现VUE的click事件都是原生的click并没有处理这个延时。
为了不让大家困扰,github上的demo已经使用fastClick解决了延时问题,(之前太懒了>.<)。现在原生的js实现效果也很顺畅了。
VUE组件化
考虑到项目里有的应用场景有多个输入框,当然输入的时候只需要一个键盘,因此组件化的时
候将输入框作为一个组件v-input,键盘作为一个组件v-keyboard。
输入框和键盘的交互
交互图如下:
考虑到本项目里面存在一个页面多个输入框的场景,因此需要控制键盘与哪个输入框配合使
用。
为了达到这样的目的,采用“ 当点击输入框获取焦点的时候,将当前v-input输入框组件的实
例传给v-keyboard键盘组件 ”的方式。
this.$refs.virtualKeyBoard.$emit('getInputVm', this.$refs.virtualInput);
如图6 ,v-keyboard组件会监听'getInputVm'事件,获取v-input的实例。
键盘组件v-keyboard获取到输入框组件v-input的实例之后就可以根据键盘的点击事件——添
加或删除,操作输入框组件v-input来放入或者删除字符了。
这样即使有多个输入框,也方便控制键盘和输入框之间的操作。
输入框自动获取焦点,键盘自动弹出
需求里要求进入某个页面输入框自动获取焦点,键盘自动弹出。
- 输入框自动获取焦点可以通过设置is-auto-focus来控制是否自动获取焦点。
<v-input
ref="virtualInput"
v-model="amount"
:placeholder="placeText"
:is-auto-focus="true"
@show-key-board="showKeyBoard">
</v-input>
- 要自动弹出键盘如图6,需要在页面实例化完成之后将相应的输入框组件v-input的实例传给键盘组件v-keyboard。
this.$refs.virtualKeyBoard.$emit('getInputVm', this.$refs.virtualInput);
键盘组间捕获'getInputVm'事件之后获取了相应输入框的实例,同时自动弹出。
this.$on('getInputVm', function(obj) {
this.refObject = obj;
this.isShow = true;
v-model支持
vue支持自定义v-model,子组件设置一个value 的 props。
props: {
value: {