Android View篇之自定義驗證碼輸入框

RAE發表於2019-05-07

首先,我們來看看實現的是怎麼樣的效果:

驗證碼輸入框效果圖

如果我們拿到這樣的UI,想到的佈局應該是用4個EditText包在橫向的LinearLayout裡面,但今天要講的View,所以我們決定用一個自定義的EditText 畫出來。

學到什麼?

  • 基本理解畫布概念
  • 畫布的狀態、平移
  • 佈局測量
  • 畫圖片

功能需求

  • 高亮當前輸入框
  • 輸入滿4個數字自動呼叫方法

思路

完全重畫一個EditText,就包含了測量佈局重新繪製這兩個關鍵步驟。好了,到這裡理一下整體的思路:

  • 根據驗證碼個數以及邊框大小來計算輸入框顯示的寬度
  • 覆蓋原來的EditText畫布,重新繪製方框
  • 根據輸入的索引來確定高亮的方框
  • 重寫onTextChanged 但滿足驗證碼個數的時候呼叫自動完成方法

開始動手

準備開始了,果斷繼承一個AppCompatEditText 來初始化基本引數先:

  • 驗證碼個數
  • 輸入方框的大小
  • 邊框的大小及間距


/**
 * 驗證碼輸入框,重寫EditText的繪製方法實現。
 * @author RAE
 */
public class CodeEditText extends AppCompatEditText {
    
   //  驗證碼文字顏色
    private int mTextColor;
    // 輸入的最大長度
    private int mMaxLength = 4;
    // 邊框寬度
    private int mStrokeWidth;
    // 邊框高度
    private int mStrokeHeight;
    // 邊框之間的距離
    private int mStrokePadding = 20;
    // 用矩形來儲存方框的位置、大小資訊
    private final Rect mRect = new Rect();
    // 方框的背景
    private Drawable mStrokeDrawable;

   /**
     * 構造方法
     *
     */
    public CodeEditText(Context context, AttributeSet attrs) {
        super(context, attrs);
        TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.CodeEditText);
        int indexCount = typedArray.getIndexCount();
        for (int i = 0; i < indexCount; i++) {
            int index = typedArray.getIndex(i);
            if (index == R.styleable.CodeEditText_strokeHeight) {
                this.mStrokeHeight = (int) typedArray.getDimension(index, 60);
            } else if (index == R.styleable.CodeEditText_strokeWidth) {
                this.mStrokeWidth = (int) typedArray.getDimension(index, 60);

            } else if (index == R.styleable.CodeEditText_strokePadding) {
                this.mStrokePadding = (int) typedArray.getDimension(index, 20);

            } else if (index == R.styleable.CodeEditText_strokeBackground) {
                this.mStrokeDrawable = typedArray.getDrawable(index);

            } else if (index == R.styleable.CodeEditText_strokeLength) {
                this.mMaxLength = typedArray.getInteger(index, 4);
            }
        }
        typedArray.recycle();

        if (mStrokeDrawable == null) {
            throw new NullPointerException("stroke drawable not allowed to be null!");
        }

        setMaxLength(mMaxLength);
        setLongClickable(false);
        // 去掉背景顏色
        setBackgroundColor(Color.TRANSPARENT);
        // 不顯示游標
        setCursorVisible(false);
    }

    @Override
    public boolean onTextContextMenuItem(int id) {
        return false;
    }

   /**
     * 設定最大長度
     */
    private void setMaxLength(int maxLength) {
        if (maxLength >= 0) {
            setFilters(new InputFilter[]{new InputFilter.LengthFilter(maxLength)});
        } else {
            setFilters(new InputFilter[0]);
        }
    }
}
複製程式碼

開始測量佈局

初始化完了就要開始測量佈局了,計算公式為:

輸入框寬度 = 邊框寬度 * 數量 + 邊框間距 *(數量-1)


    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
        // 當前輸入框的寬高資訊
        int width = getMeasuredWidth();
        int height = getMeasuredHeight();
        int widthMode = MeasureSpec.getMode(widthMeasureSpec);
        int heightMode = MeasureSpec.getMode(heightMeasureSpec);

        // 判斷高度是否小於推薦高度
        if (height < mStrokeHeight) {
            height = mStrokeHeight;
        }

        // 輸入框寬度 = 邊框寬度 * 數量 + 邊框間距 *(數量-1)
        int recommendWidth = mStrokeWidth * mMaxLength + mStrokePadding * (mMaxLength - 1);
        // 判斷寬度是否小於推薦寬度
        if (width < recommendWidth) {
            width = recommendWidth;
        }

        widthMeasureSpec = MeasureSpec.makeMeasureSpec(width, widthMode);
        heightMeasureSpec = MeasureSpec.makeMeasureSpec(height, heightMode);
        // 設定測量佈局
        setMeasuredDimension(widthMeasureSpec, heightMeasureSpec);
    }

複製程式碼

畫家登場

來到最重要的步驟了,重畫輸入框!來一步步看程式碼註釋:

    @Override
    protected void onDraw(Canvas canvas) {
        // 在畫支援設定文字顏色,把系統化的文字透明掉,相當於覆蓋
        mTextColor = getCurrentTextColor();
        setTextColor(Color.TRANSPARENT);
        //  系統畫的方法
        super.onDraw(canvas);
        // 重新設定文字顏色
        setTextColor(mTextColor);
        // 重繪背景顏色
        drawStrokeBackground(canvas);
        // 重繪文字
        drawText(canvas);
    }
複製程式碼

繪製背景方框


    /**
     * 繪製方框
     */
    private void drawStrokeBackground(Canvas canvas) {
        // 下面繪製方框背景顏色
        // 確定反饋位置
        mRect.left = 0;
        mRect.top = 0;
        mRect.right = mStrokeWidth;
        mRect.bottom = mStrokeHeight;
        int count = canvas.getSaveCount(); //  當前畫布儲存的狀態
        canvas.save(); // 儲存畫布
        for (int i = 0; i < mMaxLength; i++) {
            mStrokeDrawable.setBounds(mRect); // 設定位置
            mStrokeDrawable.setState(new int[]{android.R.attr.state_enabled}); // 設定影像狀態
            mStrokeDrawable.draw(canvas); //  畫到畫布上
            //  確定下一個方框的位置
            float dx = mRect.right + mStrokePadding; // X座標位置
            // 儲存畫布
            canvas.save();
            // [注意細節] 移動畫布到下一個位置
            canvas.translate(dx, 0);
        }
        // [注意細節] 把畫布還原到畫反饋之前的狀態,這樣就還原到最初位置了
        canvas.restoreToCount(count);
        // 畫布歸位
        canvas.translate(0, 0);

        // 下面繪製高亮狀態的邊框
        // 當前高亮的索引
        int activatedIndex = Math.max(0, getEditableText().length());
        mRect.left = mStrokeWidth * activatedIndex + mStrokePadding * activatedIndex;
        mRect.right = mRect.left + mStrokeWidth;
        mStrokeDrawable.setState(new int[]{android.R.attr.state_focused});
        mStrokeDrawable.setBounds(mRect);
        mStrokeDrawable.draw(canvas);

    }

複製程式碼

一般畫布的移動canvas.translate(x,y)會結合canvas.save();來使用。 1、呼叫canvas.save();儲存當前畫布的狀態,用PS來解析就是按下ctrl +s鍵,然後幫你新建一個新的圖層。你之後畫的內容不會影響到之前畫的內容,要回到之前的狀態就呼叫canvas.restoreToCount(count)來還原。 2、把畫布的位置移到下一個位置canvas.translate(x,y),下圖所示,你會發現方框在畫布中的位置沒有發生變化而是畫布距離發生了變化。這就是畫布平移的效果了。

畫布平移

畫驗證碼文字

    /**
     * 重繪文字
     */
    private void drawText(Canvas canvas) {
        int count = canvas.getSaveCount();
        canvas.translate(0, 0);
        int length = getEditableText().length();
        for (int i = 0; i < length; i++) {
            String text = String.valueOf(getEditableText().charAt(i));
            TextPaint textPaint = getPaint();
            textPaint.setColor(mTextColor);
            // 獲取文字大小
            textPaint.getTextBounds(text, 0, 1, mRect);
            // 計算(x,y) 座標
            int x = mStrokeWidth / 2 + (mStrokeWidth + mStrokePadding) * i - (mRect.centerX());
            int y = canvas.getHeight() / 2 + mRect.height() / 2;
            canvas.drawText(text, x, y, textPaint);
        }
        canvas.restoreToCount(count);
    }
複製程式碼

監聽文字變化回撥自動完成方法

    @Override
    protected void onTextChanged(CharSequence text, int start,
                                 int lengthBefore, int lengthAfter) {
        super.onTextChanged(text, start, lengthBefore, lengthAfter);

        // 當前文字長度
        int textLength = getEditableText().length();

        if (textLength == mMaxLength) {
            hideSoftInput();
            if (mOnInputFinishListener != null) {
                mOnInputFinishListener.onTextFinish(getEditableText().toString(), mMaxLength);
            }
        }

    }
複製程式碼

檢視完整的原始碼

到這裡你能大概理解畫布的概念了,本文完。

相關文章