亲宝软件园·资讯

展开

Android 通用格式化编辑 Android 优雅的实现通用格式化编辑

张坤的笔记 人气:0
想了解Android 优雅的实现通用格式化编辑的相关内容吗,张坤的笔记在本文为您仔细讲解Android 通用格式化编辑的相关知识和一些Code实例,欢迎阅读和指正,我们先划重点:Android,格式化编辑,Android,格式化,下面大家一起来学习吧。

格式化编辑的需求一般是从编辑手机号开始的,UI 给出的效果不是11个连续的数字,而是采用3、4、4的形式,每段中间会空一个字符。在技术实现的时候,一般会自定义一个控件 TelEditText 实现功能,随着项目迭代,格式化编辑的需求可能会增加,比如说SFZ号、自定义的优惠券码等,这个时候再给每种情况自定义一个控件就没必要了,通过一个控件实现多种格式化编辑需求是更好的方案。

其实还可以更进一步,格式化编辑的核心逻辑就是给 EditText 添加一个 TextWatcher,通过 TextWatcher 中的文本变化回调来调整 EditText 中的文本,所以自定义 EditText 并不是必须的,对于开发者需要调用的字段和方法,可以通过扩展函数的方式提供。

使用

格式化编辑手机号

布局:

<androidx.appcompat.widget.AppCompatEditText
 android:id="@+id/etPhone"
 android:layout_width="match_parent"
 android:layout_height="wrap_content"
 android:inputType="number" />

代码:

// format is ' '
etPhone.setFormatRules(3, 4, 4)

// format is '-'
etPhone.setFormatRules(3, 4, 4, formatChar = '-')

格式化编辑SFZ号

布局:

<androidx.appcompat.widget.AppCompatEditText
 android:id="@+id/etIDNumber"
 android:layout_width="match_parent"
 android:layout_height="wrap_content"
 android:digits="@string/digits_id_number"/>

资源:

<string name="digits_id_number">0123456789xX</string>

代码:

etIDNumber.setFormatRules(6, 4, 4, 4)

设置监听

etPhone.setOnFormatEditListener { isComplete, text ->
 if (isComplete) { // 编辑完成
  // 使用 toast 显示移除格式化的文本
  Toast.makeText(this, text, Toast.LENGTH_SHORT).show()
 }
}

移除格式化的文本

etPhone.textWithFormatRemoved

实现原理

自定义一个 TextWatcher,定义一个字段 formatChar,值为格式化字符,默认是空格。定义一个字段 formatCharIndexList,值为 EditText 文本中格式化字符所在位置的列表,比如对于格式化编辑手机号, formatCharIndexList 中的值为 [3, 8],既在 EditText 文本中格式化字符的位置应该是3和8。

var formatChar: Char = ' '

val formatCharIndexList = ArrayList<Int>()

EditText 文本发生变化后,如果 EditText 文本的最后一个字符为格式化字符,则删除最后一个字符;然后遍历 EditText 文本中的每一个字符,如果该字符的位置等于格式化字符位置但不是格式化字符,则在该位置插入一个格式化字符,如果该字符的位置不等于格式化字符的位置但又是格式化字符,则删除该格式化字符。

调用 insertFormatChar 或者 deleteChar 后,afterTextChanged 又会立即回调一次,可能会引起多次添加或删除,导致格式化错误。所以每次 afterTextChanged 回调最多进行一次操作,如果后续还需要操作,放在下一次 afterTextChanged 回调中进行。

override fun afterTextChanged(s: Editable?) {
 val value = s?.toString() ?: return
 if (value.isEmpty()) return
 
 if (value.last() == formatChar) {
  deleteChar(s, value.lastIndex)
  return
 }
 
 value.forEachIndexed { index, c ->
  if (formatCharIndexList.contains(index)) {
   if (c != formatChar) {
    insertFormatChar(s, index)
    return
   }
  } else {
   if (c == formatChar) {
    deleteChar(s, index)
    return
   }
  }
 }
 ...
}

项目地址

format-edit,觉得用起来很爽的,请不要吝啬你的 Star !

加载全部内容

相关教程
猜你喜欢
用户评论