在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:KingKeyboard开源软件地址:https://gitee.com/jenly1314/KingKeyboard开源软件介绍:KingKeyboardKingKeyboard for Android 是一个自定义键盘。内置了满足各种场景的键盘需求:包括但不限于混合、字母、数字、电话、身份证、车牌号等可输入场景。还支持自定义。集成简单,键盘可定制化。 Gif 展示
引入Gradle:
allprojects { repositories { //... mavenCentral() }}
implementation 'com.github.jenly1314:kingkeyboard:1.0.4' 以前发布至JCenter的版本 //AndroidXimplementation 'com.king.keyboard:kingkeyboard:1.0.0' 自定义按键值 /* * 在KingKeyboard的伴生对象中定义了一些核心的按键值,当您需要自定义键盘时,可能需要用到 */ //------------------------------ 下面是定义的一些公用功能按键值 /** * Shift键 -> 一般用来切换键盘大小写字母 */ const val KEYCODE_SHIFT = -1 /** * 模式改变 -> 切换键盘输入法 */ const val KEYCODE_MODE_CHANGE = -2 /** * 取消键 -> 关闭输入法 */ const val KEYCODE_CANCEL = -3 /** * 完成键 -> 长出现在右下角蓝色的完成按钮 */ const val KEYCODE_DONE = -4 /** * 删除键 -> 删除输入框内容 */ const val KEYCODE_DELETE = -5 /** * Alt键 -> 预留,暂时未使用 */ const val KEYCODE_ALT = -6 /** * 空格键 */ const val KEYCODE_SPACE = 32 /** * 无作用键 -> 一般用来占位或者禁用按键 */ const val KEYCODE_NONE = 0 //------------------------------ /** * 键盘按键 -> 返回(返回,适用于切换键盘后界面使用,如:NORMAL_MODE_CHANGE或CUSTOM_MODE_CHANGE键盘) */ const val KEYCODE_MODE_BACK = -101 /** * 键盘按键 ->返回(直接返回到最初,直接返回到NORMAL或CUSTOM键盘) */ const val KEYCODE_BACK = -102 /** * 键盘按键 ->更多 */ const val KEYCODE_MORE = -103 //------------------------------ 下面是自定义的一些预留按键值,与共用按键功能一致,但会使用默认的背景按键 const val KEYCODE_KING_SHIFT = -201 const val KEYCODE_KING_MODE_CHANGE = -202 const val KEYCODE_KING_CANCEL = -203 const val KEYCODE_KING_DONE = -204 const val KEYCODE_KING_DELETE = -205 const val KEYCODE_KING_ALT = -206 //------------------------------ 下面是自定义的一些功能按键值,与共用按键功能一致,但会使用默认背景颜色 /** * 键盘按键 -> 返回(返回,适用于切换键盘后界面使用,如:NORMAL_MODE_CHANGE或CUSTOM_MODE_CHANGE键盘) */ const val KEYCODE_KING_MODE_BACK = -251 /** * 键盘按键 ->返回(直接返回到最初,直接返回到NORMAL或CUSTOM键盘) */ const val KEYCODE_KING_BACK = -252 /** * 键盘按键 ->更多 */ const val KEYCODE_KING_MORE = -253 /* 用户也可自定义按键值,primaryCode范围区间为-999 ~ -300时,表示预留可扩展按键值。 其中-399~-300区间为功能型按键,使用Special背景色,-999~-400自定义按键为默认背景色 */ 示例代码示例 //初始化KingKeyboard kingKeyboard = KingKeyboard(this,keyboardParent) //然后将EditText注册到KingKeyboard即可 kingKeyboard.register(editText,KingKeyboard.KeyboardType.NUMBER) /* * 如果目前所支持的键盘满足不了您的需求,您也可以自定义键盘,KingKeyboard对外提供自定义键盘类型。 * 自定义步骤也非常简单,只需自定义键盘的xml布局,然后将EditText注册到对应的自定义键盘类型即可 * * 1. 自定义键盘Custom,自定义方法setKeyboardCustom,键盘类型为{@link KeyboardType#CUSTOM} * 2. 自定义键盘CustomModeChange,自定义方法setKeyboardCustomModeChange,键盘类型为{@link KeyboardType#CUSTOM_MODE_CHANGE} * 3. 自定义键盘CustomMore,自定义方法setKeyboardCustomMore,键盘类型为{@link KeyboardType#CUSTOM_MORE} * * xmlLayoutResId 键盘布局的资源文件,其中包含键盘布局和键值码等相关信息 */ kingKeyboard.setKeyboardCustom(R.xml.keyboard_custom)// kingKeyboard.setKeyboardCustomModeChange(xmlLayoutResId)// kingKeyboard.setKeyboardCustomMore(xmlLayoutResId) kingKeyboard.register(et12,KingKeyboard.KeyboardType.CUSTOM) //获取键盘相关的配置信息 var config = kingKeyboard.getKeyboardViewConfig() //... 修改一些键盘的配置信息 //重新设置键盘配置信息 kingKeyboard.setKeyboardViewConfig(config) //按键是否启用震动 kingKeyboard.setVibrationEffectEnabled(isVibrationEffectEnabled) //... 还有各种监听方法。更多详情,请直接使用。 //在Activity或Fragment相应的生命周期中调用,如下所示 override fun onResume() { super.onResume() kingKeyboard.onResume() } override fun onDestroy() { super.onDestroy() kingKeyboard.onDestroy() } v1.0.2 新增:KingKeyboard.sendKey(params) 的用法示例: val beforeCount = 0 kingKeyboard.register(et,KingKeyboard.KeyboardType.LICENSE_PLATE_PROVINCE) //通过监听输入框内容改变,来通过发送功能键来切换键盘(这里只是举例展示kingKeyboard.sendKey的用法,具体怎么用还需根据需求场景去决定) et.addTextChangedListener(object : TextWatcher{ override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) { beforeCount = s?.length ?: 0 } override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) { when(s?.length){ 0 -> {//车牌键盘:如果输入的内容长度改变为0,并且当前的键盘不是省份键盘模式时,通过发送“返回”功能按键值,让键盘自动切换到省份键盘模式 if(kingKeyboard.getKeyboardType() != KingKeyboard.KeyboardType.LICENSE_PLATE_PROVINCE){ kingKeyboard.sendKey(KingKeyboard.KEYCODE_BACK) } } 1 -> {//车牌键盘:如果输入的内容长度从0改变为1,并且当前的键盘为省份键盘模式时,通过发送“模式改变”功能按键值,让键盘自动切换到字母键盘模式 if(beforeCount == 0 && kingKeyboard.getKeyboardType() == KingKeyboard.KeyboardType.LICENSE_PLATE_PROVINCE){ kingKeyboard.sendKey(KingKeyboard.KEYCODE_MODE_CHANGE) } } } } override fun afterTextChanged(s: Editable?) { } }) 相关说明
//Kotlin 写法 var keyCode = KingKeyboard.KEYCODE_SHIFT //Java 写法 int keyCode = KingKeyboard.Companion.KEYCODE_SHIFT; 更多使用详情,请查看app中的源码使用示例或直接查看API帮助文档 相关推荐SplitEditText 一个灵活的分割可编辑框;常常应用于 验证码输入 、密码输入 等场景。版本记录v1.0.4:2021-11-18
v1.0.3:2021-10-22
v1.0.2:2021-9-29
v1.0.1:2021-9-3 (从v1.0.1开始发布至 MavenCentral)
v1.0.0:2020-1-16
赞赏如果您喜欢KingKeyboard,或感觉KingKeyboard帮助到了您,可以点右上角“Star”支持一下,您的支持就是我的动力,谢谢 您也可以扫描下面的二维码,请作者喝杯咖啡 关于我Name: Jenly Email: jenly1314#gmail.com / jenly1314#vip.qq.com CSDN: jenly121 CNBlog: jenly Github: jenly1314 加入QQ群: 20867961 |
请发表评论