安卓开发 自定义软键盘 从原理到应用 可更改个别键颜色等

前言

不啰嗦

正文

对于自定义键盘,官方提供了两个玩意(再简单的键盘也都要用到):KeyboardKeyboardView,当然,为了方便我们会定义一个util:KeyboardUtil

Keyboard

Loads an XML description of a keyboard and stores the attributes of the keys. A keyboard consists of rows of keys.

加载键盘的XML描述并存储键的属性。键盘由一行键组成。(还有翻译,我真贴心)
keyboard是一个xml文件,下面有个例子:

<?xml version="1.0" encoding="utf-8"?>
<Keyboard xmlns:android="http://schemas.android.com/apk/res/android"
          android:keyWidth="33%p"
          android:horizontalGap="1dp"
          android:verticalGap="1dp"
          android:keyHeight="54dp">
    <Row>
        <Key android:codes="49" android:keyLabel="1" android:keyEdgeFlags="left"/>
        <Key android:codes="50" android:keyLabel="2" />
        <Key android:codes="51" android:keyLabel="3" />

    </Row>

    <Row>
        <Key android:codes="52" android:keyLabel="4" android:keyEdgeFlags="left" />
        <Key android:codes="53" android:keyLabel="5" />
        <Key android:codes="54" android:keyLabel="6" />

    </Row>

    <Row>
        <Key android:codes="55" android:keyLabel="7" android:keyEdgeFlags="left"/>
        <Key android:codes="56" android:keyLabel="8" />
        <Key android:codes="57" android:keyLabel="9" />
    </Row>

    <Row>
        <Key android:codes="46" android:keyLabel="." android:keyEdgeFlags="left" />
        <Key android:codes="48" android:keyLabel="0" />
        <Key android:codes="-5" android:isRepeatable="true"
            android:keyIcon="@drawable/delete_tzjesr"/>
    </Row>
</Keyboard>

具体描述如下:

属性 描述
codes 按键对应的输出值,可以为unicode值或则逗号(,)分割的多个值,也可以为一个字 符串。在字符串中通过“\”来转义特殊字符,例如 ‘\n’ 或则 ‘\uxxxx’ 。Codes通常用来定义该键的键码,例如上图中的数字按键1对应的为49;如果提供的是逗号分割的多个值则和普通手机输入键盘一样在多个值之间切换
keyLabel 按键显示的文本内容
keyIcon 按键显示的图标内容,如果指定了该值则在显示的时候显示为图片不显示文本
keyWidth 按键的宽度,可以为精确值或则相对值,对于精确值支持多种单位,例如:像素,英寸 等;相对值为相对于基础取值的百分比,为以% 或则%p 结尾,其中%p表示相对于父容器
keyHeight 按键的高度,取值同keyWidth
horizontalGap 按键前的间隙(水平方向),取值取值同keyWidth
isSticky 按键是否为sticky的。例如Shift大小写切换按键,具有两种状态,按下状态和正常状态,取值为true或则false
isModifier 按键是否为功能键( modifier key ) ,例如 Alt 或则 Shift 。取值为true或则false
keyOutputText 按键输出的文本内容,取值为字符串
isRepeatable 按键是否是可重复的,如果长按该键可以触发重复按键事件则为true,否则为false
keyEdgeFlags 按键的对齐指令,取值为left或则right

实例为三列四行标准格式,接下来聊一聊标准:最标准的莫过于每个键同样的高度同样的宽度,当然这是很理想的一种形式。我们一般会得到UI强制规定的个性化键盘:


UI强制规定的个性化键盘

不同颜色的自定义键下面说别着急,对于上面这样的不规则键盘,因为只能一行一行放置键,

所以首先keyWidth我们设置为25%p我们一行最多要放四个键,一三行我们放四个键二四行放三个键,第一三行最后一个键高度为其他键高度的两倍需要在<key />里面单独写keyHeight,同理如果键宽不一样的话单独设置即可。

KeyboardView

A view that renders a virtual Keyboard. It handles rendering of keys and detecting key presses and touch movements.
呈现虚拟键盘的视图。它处理按键的渲染和检测按键和触摸动作。

这个东西就是写在布局里的view了

示例如下:

<com.ql.jcjr.view.MyKeyboredView
        android:id="@+id/keyboard_view"
        android:layout_width="match_parent"
        android:layout_height="216dp"
        android:background="@color/divider_color"
        android:focusable="true"
        android:shadowRadius="0.0"
        android:shadowColor="@color/c_fffff"
        android:focusableInTouchMode="true"
        android:keyBackground="@drawable/keyboard_key"
        android:keyTextColor="@color/colorPrimaryDark"
        />

这是我重写掉的,后面会讲。

具体属性如下:

属性 描述
android:keyBackground 键的背景图
android:keyPreviewLayout 击键盘上的某个键时,短暂弹出的提示布局文件
android:keyPreviewOffset 击键盘上的某个键时,短暂弹出布局的垂直偏移量
android:keyTextColor 按键中的keyLabel的颜色
android:keyTextSize 按键中的keyLabel的大小
android:labelTextSize 如果有图片时,按键中的keyLabel的大小
android:popupLayout 弹出键盘的布局文件
android:verticalCorrection 补偿触摸Y坐标的偏移量,用于偏移校正

android:shadowRadius="0.0" android:shadowColor="背景色"
这两个属性可以解决键盘上显示的文字糊的问题。

KeyboardUtil

public class KeyboardUtil {
    private View ll_jianpan;
    private KeyboardView mKeyboardView;
    private Keyboard mNumberKeyboard; // 数字键盘
    private Keyboard mLetterKeyboard; // 字母键盘
    private Context mContext;

    private boolean isNumber = false;  // 是否数字键盘
    private boolean isUpper = false;   // 是否大写
    private EditText mEditText;

    /**
     *
     * @param context
     * @param view
     * @param editText
     * @param type  0,空白格 1,小数点  2,身份证X
     */
    public KeyboardUtil(Context context, View view, EditText editText,int type) {
        mContext=context;
        mEditText = editText;
        mLetterKeyboard = new Keyboard(context, R.xml.keyboard_qwerty);
        mKeyboardView = (KeyboardView) view.findViewById(R.id.keyboard_view);
        ll_jianpan= view.findViewById(R.id.ll_jianpan);
        ImageView iv_close= (ImageView) ll_jianpan.findViewById(R.id.iv_close);
        iv_close.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                hideKeyboard();
            }
        });
        if (type==0){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers_blank);
        }else if (type==1){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers);
        }else if (type==2){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers_realname);
        }else if (type==66299){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers_blank);
            iv_close.setVisibility(View.GONE);
        }

        mKeyboardView.setKeyboard(mNumberKeyboard);
        mKeyboardView.setEnabled(true);
        mKeyboardView.setPreviewEnabled(false);
        mKeyboardView.setOnKeyboardActionListener(listener);

    }
    public KeyboardUtil(Context context, Activity activity, EditText editText, int type) {
        mContext=context;
        mEditText = editText;
        if (type==0){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers_blank);
        }else if (type==1){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers);
        }else if (type==2){
            mNumberKeyboard = new Keyboard(context, R.xml.keyboard_numbers_realname);
        }
        mLetterKeyboard = new Keyboard(context, R.xml.keyboard_qwerty);
        mKeyboardView = (KeyboardView) activity.findViewById(R.id.keyboard_view);
        ll_jianpan= activity.findViewById(R.id.ll_jianpan);
        mKeyboardView.setKeyboard(mNumberKeyboard);
        mKeyboardView.setEnabled(true);
        mKeyboardView.setPreviewEnabled(false);
        mKeyboardView.setOnKeyboardActionListener(listener);
        ImageView iv_close= (ImageView) ll_jianpan.findViewById(R.id.iv_close);
        iv_close.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                hideKeyboard();
            }
        });
    }


    private KeyboardView.OnKeyboardActionListener listener = new KeyboardView.OnKeyboardActionListener() {
        @Override
        public void onPress(int primaryCode) {

        }

        @Override
        public void onRelease(int primaryCode) {

        }

        @Override
        public void onKey(int primaryCode, int[] keyCodes) {
            Editable editable = mEditText.getText();
            int start = mEditText.getSelectionStart();
            if (primaryCode == Keyboard.KEYCODE_CANCEL||primaryCode == 66299) { // cancel
                hideKeyboard();
            } else if (primaryCode == Keyboard.KEYCODE_DELETE) { // 回退
                if (editable != null && editable.length() > 0) {
                    if (start > 0) {
                        editable.delete(start - 1, start);
                    }
                }
            } else if (primaryCode == Keyboard.KEYCODE_SHIFT) { // 大小写切换
                changeKeyboart();
                mKeyboardView.setKeyboard(mLetterKeyboard);

            } else if (primaryCode == Keyboard.KEYCODE_MODE_CHANGE) { // 数字与字母键盘互换
                if (isNumber) {
                    isNumber = false;
                    mKeyboardView.setKeyboard(mLetterKeyboard);
                } else {
                    isNumber = true;
                    mKeyboardView.setKeyboard(mNumberKeyboard);
                }

            } else if (primaryCode == 57419) { // 左移
                if (start > 0) {
                    mEditText.setSelection(start - 1);
                }

            } else if (primaryCode == 57419) { // 右移
                if (start > mEditText.length()) {
                    mEditText.setSelection(start + 1);
                }
            } else { // 输入键盘值
                editable.insert(start, Character.toString((char) primaryCode));
            }
        }

        @Override
        public void onText(CharSequence text) {

        }

        @Override
        public void swipeLeft() {

        }

        @Override
        public void swipeRight() {

        }

        @Override
        public void swipeDown() {

        }

        @Override
        public void swipeUp() {

        }
    };

    private void changeKeyboart() {
        List<Keyboard.Key> keyList = mLetterKeyboard.getKeys();
        if (isUpper) { // 大写切换小写
            isUpper = false;
            for (Keyboard.Key key : keyList) {
                if (key.label != null && isLetter(key.label.toString())) {
                    key.label = key.label.toString().toLowerCase();
                    key.codes[0] = key.codes[0] + 32;
                }
            }
        } else { // 小写切换成大写
            isUpper = true;
            for (Keyboard.Key key : keyList) {
                if (key.label != null && isLetter(key.label.toString())) {
                    key.label = key.label.toString().toUpperCase();
                    key.codes[0] = key.codes[0] - 32;
                }
            }
        }
    }

    /**
     * 判断是否是字母
     */
    private boolean isLetter(String str) {
        String wordStr = "abcdefghijklmnopqrstuvwxyz";
        return wordStr.contains(str.toLowerCase());
    }

    public void hideKeyboard() {

        int visibility = ll_jianpan.getVisibility();
        if (visibility == View.VISIBLE) {
            ll_jianpan.startAnimation(AnimationUtils.loadAnimation(mContext,R.anim.anim_bottom_out));
            ll_jianpan.setVisibility(View.GONE);
        }
    }

    public void showKeyboard() {
        int visibility = ll_jianpan.getVisibility();
        if (visibility == View.GONE || visibility == View.INVISIBLE) {
            ll_jianpan.startAnimation(AnimationUtils.loadAnimation(mContext,R.anim.anim_bottom_in));
            ll_jianpan.setVisibility(View.VISIBLE);
        }
    }
}

ll_jianpan其实就是一个包含keyboradview的线性布局
在这里比较重要的就是实现键盘的监听OnKeyboardActionListener

下面有一张对应表code对应ASCII值 然后输出的就是控制字符 :


对应表

当然我们肯定需要自定义一些功能,如关闭键盘切换数字字母键盘左移右移等,这些都放在了OnKeyboardActionListener的onKey中。其实就是根据不同的code处理不同的事件,自定义code尽量个性点防止跟已占用code发生冲突。

既然是自定义键盘,我们当然要阻拦系统键盘,方法如下:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            editText.getCancelEditText().setShowSoftInputOnFocus(false);
 }else {
            editText.getCancelEditText().setInputType(InputType.TYPE_NULL);
  }

PS:setInputType(InputType.TYPE_NULL)会让输入框失去光标,但是没办法21以下的没有setShowSoftInputOnFocus(false)这方法。

至于打开键盘,可以在触摸输入框的时候触发也可直接触发:

 editText.getCancelEditText().setOnTouchListener(new View.OnTouchListener() {
            @Override
            public boolean onTouch(View view, MotionEvent motionEvent) {
                new KeyboardUtil(mContext, Activity.this, editText,0).showKeyboard();
                return false;
            }
        });

最后,重写的Keyboradview:

public class MyKeyboredView extends KeyboardView {


    public MyKeyboredView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public MyKeyboredView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    public MyKeyboredView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
        super(context, attrs, defStyleAttr, defStyleRes);
    }

    @Override
    public void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        List<Keyboard.Key> keys = getKeyboard().getKeys();
        for (Keyboard.Key key : keys) {
            if (key.codes[0] == 66299) {
                Log.e("KEY", "Drawing key with code " + key.codes[0]);
                Drawable dr = (Drawable) JcbApplication.getInstance().getResources().getDrawable(R.drawable.jianpan_sure);
                dr.setBounds(key.x, key.y, key.x + key.width, key.y + key.height);
                dr.draw(canvas);
            } else {

            }
        }
    }
}

重写onDraw()根据code把点九图充满指定的键即可

后记

看到这你可能在找demo源码,不好意思没有的,如果你的时间确实很紧请移步,如果你还有点时间,一天自己学完写完没什么问题的,欢迎提出问题,我们一起学习。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容