Android自定义密码输入框的简单实现过程

来源：jb51　　时间：2021/11/9 15:50:50　　对本文有异议

一、实现效果及方案

预期效果图：

如上图所示，要实现一个这种密码输入框的样式，原生并未提供类似的效果，所以需要自定义控件的方式实现。

预期的基础效果：

只接受数字；

支持输入加密显示；

支持删除；

密码位数可配置；

文字大小、颜色、数字框背景可配置；

方案分析：

需要解决的问题：

配置性；

输入、删除如何实现？

整体UI如何实现？

1.对于输入删除可以通过setOnKeyListener监听软件盘的事件。

2.可配置性数据可以通过自定义的属性文件配置；

3.对于UI效果：

A:可以基于原生控件做开发，每一个数字布局对应一个TextView，选用数据结构对其管理，再选用一种容器布局，比如LinearLayout进行添加。

B：通过自定义View的方式开发，需要自行绘制，绘制的内容包括背景、及密码内容、密码加密样式内容。

二、实现

这里选用方案B的方式进行实现，尽量使用较少的控件去实现，使用A的方案至少要用到5个原生控件的组合。

1.继承ViewGrop还是View？

如果选用方案A的话其实算是继承了ViewGrop，而内部的单个数字则作为一个独立的子控件，这样的话是可以继承ViewGrop的
，但显然不需要这么麻烦（需要处理layout等），这个密码输入就是一个独立的控件不需要再加入子控件，所以直接继承View。

class PasswordEditText @JvmOverloads constructor(
    context: Context,
    attributeSet: AttributeSet? = null,
) : View(context, attributeSet, 0) {
    
}

2.继承View的话就要处理 wrap_content,所以要重写onMeasure，即在未设置具体的宽度时也要能够正常的显示测量。先定义一些宽高颜色的变量：

 //密码位数
    private var passwordLength = 4
    private var textColor = 0
 
    //间隔  ->   dp2px
    private var itemPadding = 5
 
    //单个数字包括背景宽度 dp2px
    private var itemWidth = 30
    private var bgItemColor = 0
    private val mPaintBg = Paint()
    //用于存储输入后的密码
    private val password = arrayOfNulls<String>(passwordLength)

宽度的话相对来说还是很好计算的：

override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec)
        var width = 0
        when (MeasureSpec.getMode(widthMeasureSpec)) {
            MeasureSpec.UNSPECIFIED,MeasureSpec.AT_MOST ->{
                width = itemWidth * passwordLength + itemPadding * (passwordLength-1)
            }
 
            MeasureSpec.EXACTLY ->{
                width = MeasureSpec.getSize(widthMeasureSpec)
                itemWidth = (width - itemPadding *(passwordLength -1)) / passwordLength
            }
        }
        setMeasuredDimension(width,itemWidth)
    }

看着UI图基本可以算出来了，不涉及太复杂的计算，这里并未对高度进行处理，理论上高度的值应该用指定的就好了；
需要做的测量基本就是这些了，下面开始绘制背景了：

也很简单根据 passwordLength 循环绘制圆角矩形就OK了，而参数的话也很好计算出来：

private fun drawBgItems(canvas: Canvas) {
        for (i in password.indices) {
            未处理padding值 加上即可
            val rect = RectF(
                (i * itemWidth + (i) * itemPadding).toFloat(),
                0f,
                ((i+1) * itemWidth + i * itemPadding).toFloat(),
                itemWidth.toFloat()
            )
            canvas.drawRoundRect(rect, 5f, 5f, mPaintBg)
        }
    }

为了让效果更明显，先画了一个颜色鲜艳的：

背景的话就绘制OK了，下面要做的就是监听事件再绘制密码内容了；

要实现一个OnKeyListener

 //键盘监听
    private val keyListener = OnKeyListener { v, keyCode, event ->
        val action = event.action
        if (action == KeyEvent.ACTION_DOWN) {
            if (keyCode == KeyEvent.KEYCODE_DEL) {
                //删除
                return@OnKeyListener true
            }
            if (keyCode >= KeyEvent.KEYCODE_0 && keyCode <= KeyEvent.KEYCODE_9) {
                 //数字键
 
            }
            if (keyCode == KeyEvent.KEYCODE_ENTER) {
                //确认键
                return@OnKeyListener true
            }
        }
 
        return@OnKeyListener false
    }

这里只是添加好了回调条件，还要做相应的处理。但键盘还没弹出，所以要先处理点击事件调用系统的方法主动弹出软键盘才行

 override fun onTouchEvent(event: MotionEvent?): Boolean {
        if (event!!.action == MotionEvent.ACTION_DOWN) {
            //获取焦点
            requestFocus()
            //getContext().getSystemService(Context.INPUT_METHOD_SERVICE)
            inputManager.showSoftInput(this, InputMethodManager.SHOW_FORCED)
            return true
        }
        return super.onTouchEvent(event)
    }

重写onTouchEvent之后就可以拦截点击事件弹出键盘拉。而View和软键盘的联系需要通过onCreateInputConnection 来实现，具体可以看下源码的介绍。

下面接着处理监听事件，首先是在接受到数字输入时的处理，要把输入的数字存储到容器并绘制出来

这里需要注意keyCode 的值，看下源码并不是KEYCODE_0 就是0了

再存储一下输入的数字：

 if (keyCode >= KeyEvent.KEYCODE_0 && keyCode <= KeyEvent.KEYCODE_9) {
                 //数字键
                password[currentInputPosition] = (keyCode - 7).toString()
                currentInputPosition++
                postInvalidate()
                return@OnKeyListener true
            }

currentInputPosition为了标记当前操作的位置，方便添加和删除，因为都是从两头开始的用这个值就可以了。

下面开始绘制文字了，如果加密的话只需要在每个背景的中心画一个小黑点就OK了，或者直接画一个数字，根据基线用drawText画就好了，而Y轴的基线很好确定就是高度的一半像素减去高度文字一半，通过设置textAlign = Paint.Align.CENTER即可实现横向上的居中（会根据X基线），X轴的基线则需要计算一下，比如第一个框的X基线则应该是，框宽的一半再减去绘制文字宽度的一半，这样才能在中间，第二个框内X的基线应该是：paddingLeft+1框宽+1padding+框宽/2

所以绘制文字的代码就出来了：

 //绘制文字
    private fun drawPasswordNumber(canvas: Canvas) {
        for (i in password.indices) {
            if (password[i] != null) {
                //没有开启明文显示，绘制密码密文
                val txt = if (isCipherEnable) cipherString else password[i]
                mPaintTv.getTextBounds(txt, 0, txt!!.length, rectTv)
                val offset = (rectTv.top + rectTv.bottom) / 2
                canvas.drawText(
                    password[i]!!,
                    (paddingLeft + itemWidth * i + itemPadding * i + itemWidth / 2).toFloat(),
                    (paddingTop + itemWidth / 2).toFloat() - offset, mPaintTv
                )
            }
        }
    }

这里加了是否开启密文显示的开关，最终运行的效果如下：

这个黑点也可以通过画圆的方式进行绘制，但无法通过字符串进行动态配置。

再输入完四位以后在点的话就会数组越界闪退了，所以在完成相应位数的添加后要禁止再绘制。

if (keyCode >= KeyEvent.KEYCODE_0 && keyCode <= KeyEvent.KEYCODE_9) {
                //加入判断 currentInputPosition 
                if (currentInputPosition == passwordLength) {
                    return@OnKeyListener true
                }
                password[currentInputPosition] = (keyCode - 7).toString()
                currentInputPosition++
                postInvalidate()
                return@OnKeyListener true
            }

下面要处理删除操作了，删除要做的就是去除数组中保存的已输入密码，更新操作标记位，再刷新绘制就OK了

if (keyCode == KeyEvent.KEYCODE_DEL) {
                //删除
                if(currentInputPosition == 0){
                    return@OnKeyListener true
                }
                password[currentInputPosition-1] = null
                currentInputPosition--
                postInvalidate()
                return@OnKeyListener true
            }

看下最后的UI效果：

下面可以提供一些对外的方法、接口，比如获取内容，输入删除确认的回调监听。

//获取输入内容
    fun getTextContent():String {
        val sb = StringBuilder()
        for (p in password) {
            p?.let {
                sb.append(p)
            }
        }
        return sb.toString()
    }
 
    //操作回调 加些需要的参数
    interface OperationListener{
        fun inputOperationCallBack()
        
        fun completeOperationCallBack()
        
        fun deleteOperationCallBack()
    }

这里还可以继续开发其他一些主流的样式，比如下划线、网格的样式，但绘制思路基本相同，还可以加上一个任务类执行绘制光标的操作。

总结

一个简单的自定义View Demo，自定义View的难点在于参数的计算和很多API一不用就会忘记，但是继承ViewGroup还是View，测量绘制布局的过程以及基本的绘制方法配置还是要清楚些，或者说能想起来，对于太复杂难以开发的控件感觉如果有现成的还是可以直接用的，毕竟没那么多时间去调试一些复杂的参数，如果能写出来也很牛皮吧。

友情链接：直通硅谷　点职佳　北美留学生论坛