From ced24685ee88b46d3ce4aca671e8cd2b8f2d8885 Mon Sep 17 00:00:00 2001 From: YANG JIANKUAN Date: Tue, 16 Dec 2025 15:27:06 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20opt=20=E7=BC=96=E7=A0=81=E8=BE=93?= =?UTF-8?q?=E5=85=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .docs/大写字母数字输入过滤器使用指南.md | 246 ++++++++++++++++++ .../lukouguoji/module_base/ktx/EditTextKtx.kt | 44 ++++ .../gjc/activity/GjcBoxWeighingAddActivity.kt | 6 + .../layout/activity_gjc_box_weighing_add.xml | 1 + 4 files changed, 297 insertions(+) create mode 100644 .docs/大写字母数字输入过滤器使用指南.md diff --git a/.docs/大写字母数字输入过滤器使用指南.md b/.docs/大写字母数字输入过滤器使用指南.md new file mode 100644 index 0000000..581d54f --- /dev/null +++ b/.docs/大写字母数字输入过滤器使用指南.md @@ -0,0 +1,246 @@ +# 大写字母数字输入过滤器使用指南 + +## 功能说明 + +为 EditText 提供输入过滤功能： +- ✅ 只允许输入大写字母(A-Z)和数字(0-9) +- ✅ 小写字母自动转为大写 +- ✅ 自动过滤中文、特殊符号、空格等所有非法字符 + +## 核心实现 + +**位置**: `module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt` + +```kotlin +/** + * 大写字母和数字输入过滤器 + */ +class UpperCaseAlphanumericInputFilter : InputFilter { + // 实现细节... +} + +/** + * 为 EditText 设置大写字母和数字输入过滤器 + */ +fun EditText.setUpperCaseAlphanumericFilter() { + this.filters = arrayOf(UpperCaseAlphanumericInputFilter()) +} +``` + +## 使用方式 + +### 方式一：直接为 EditText 设置（最简单） + +```kotlin +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter + +// Activity 中 +override fun initOnCreate(savedInstanceState: Bundle?) { + // 为普通 EditText 设置 + binding.editText.setUpperCaseAlphanumericFilter() +} +``` + +### 方式二：为 PadDataLayoutNew 内部的 EditText 设置 + +```kotlin +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter + +// Activity 中 +override fun initOnCreate(savedInstanceState: Bundle?) { + // PadDataLayoutNew 内部有一个 et 属性，是 EditText + binding.carIdInput.et.setUpperCaseAlphanumericFilter() + binding.uldNoInput.et.setUpperCaseAlphanumericFilter() + binding.impCodeInput.et.setUpperCaseAlphanumericFilter() +} +``` + +### 方式三：在自定义 View 中设置 + +```kotlin +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter + +class CustomView : FrameLayout { + private val editText: EditText + + init { + // 初始化后设置 + editText.setUpperCaseAlphanumericFilter() + } +} +``` + +## 实际应用案例 + +### 案例1：板箱过磅页面（GjcBoxWeighingAddActivity） + +**需求**: 架子车号、ULD编码、IMP代码只允许输入大写字母和数字 + +**实现**: + +```kotlin +// GjcBoxWeighingAddActivity.kt +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter + +override fun initOnCreate(savedInstanceState: Bundle?) { + setBackArrow("板箱过磅") + binding.viewModel = viewModel + viewModel.initOnCreated(this) + + // 为架子车号、ULD编码、IMP代码添加大写字母和数字的输入限制 + binding.carIdInput.et.setUpperCaseAlphanumericFilter() + binding.uldNoInput.et.setUpperCaseAlphanumericFilter() + binding.impCodeInput.et.setUpperCaseAlphanumericFilter() +} +``` + +**效果**: +- 输入 `abc123` → 自动变成 `ABC123` +- 输入 `板箱_88` → 自动变成 `88` +- 输入 `test@#456` → 自动变成 `TEST456` + +### 案例2：其他可能需要的场景 + +**航班号输入框**: +```kotlin +binding.flightNoInput.et.setUpperCaseAlphanumericFilter() +``` + +**运单号输入框**: +```kotlin +binding.waybillNoInput.et.setUpperCaseAlphanumericFilter() +``` + +**任何需要大写字母+数字的输入框**: +```kotlin +binding.anyInput.et.setUpperCaseAlphanumericFilter() +``` + +## 注意事项 + +### 1. Import 路径 + +```kotlin +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter +``` + +### 2. 调用时机 + +必须在 View 初始化完成后调用，通常在 Activity 的 `initOnCreate` 或 Fragment 的 `onViewCreated` 中。 + +### 3. 与其他 Filter 组合使用 + +如果需要同时使用多个 Filter： + +```kotlin +val filters = arrayOf( + UpperCaseAlphanumericInputFilter(), + InputFilter.LengthFilter(20) // 同时限制长度 +) +editText.filters = filters +``` + +### 4. 覆盖已有 Filter + +调用 `setUpperCaseAlphanumericFilter()` 会覆盖已有的 Filter。如果需要保留原有 Filter，请手动组合： + +```kotlin +val existingFilters = editText.filters +val newFilters = existingFilters + UpperCaseAlphanumericInputFilter() +editText.filters = newFilters +``` + +## 扩展建议 + +如果需要其他类型的输入过滤器，可以参考 `UpperCaseAlphanumericInputFilter` 的实现： + +### 示例1：只允许数字 + +```kotlin +class DigitsOnlyInputFilter : InputFilter { + override fun filter( + source: CharSequence?, + start: Int, + end: Int, + dest: Spanned?, + dstart: Int, + dend: Int + ): CharSequence? { + if (source.isNullOrEmpty()) return null + + val filtered = StringBuilder() + for (i in start until end) { + val char = source[i] + if (char in '0'..'9') { + filtered.append(char) + } + } + + return if (filtered.toString() == source.subSequence(start, end).toString()) { + null + } else { + filtered.toString() + } + } +} + +fun EditText.setDigitsOnlyFilter() { + this.filters = arrayOf(DigitsOnlyInputFilter()) +} +``` + +### 示例2：只允许小写字母和数字 + +```kotlin +class LowerCaseAlphanumericInputFilter : InputFilter { + override fun filter( + source: CharSequence?, + start: Int, + end: Int, + dest: Spanned?, + dstart: Int, + dend: Int + ): CharSequence? { + if (source.isNullOrEmpty()) return null + + val filtered = StringBuilder() + for (i in start until end) { + val char = source[i] + if (char in 'A'..'Z' || char in 'a'..'z' || char in '0'..'9') { + filtered.append(char.lowercaseChar()) + } + } + + return if (filtered.toString() == source.subSequence(start, end).toString()) { + null + } else { + filtered.toString() + } + } +} + +fun EditText.setLowerCaseAlphanumericFilter() { + this.filters = arrayOf(LowerCaseAlphanumericInputFilter()) +} +``` + +## 测试建议 + +在使用前建议测试以下场景： + +1. 输入小写字母是否自动转大写 +2. 输入中文是否被过滤 +3. 输入特殊符号是否被过滤 +4. 输入空格是否被过滤 +5. 粘贴文本是否正确处理 +6. 与软键盘的兼容性 + +## 相关文件 + +- **核心实现**: `module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt` +- **使用示例**: `module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcBoxWeighingAddActivity.kt` + +--- + +**最后更新**: 2025-12-16 +**维护人员**: 开发团队 diff --git a/module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt b/module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt index 597150e..bbb0173 100644 --- a/module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt +++ b/module_base/src/main/java/com/lukouguoji/module_base/ktx/EditTextKtx.kt @@ -1,6 +1,7 @@ package com.lukouguoji.module_base.ktx import android.text.InputFilter +import android.text.Spanned import android.widget.EditText import androidx.databinding.BindingAdapter @@ -12,4 +13,47 @@ fun setTextAllCaps(et: EditText, allCaps: Boolean) { } else { et.filters = emptyArray() } +} + +/** + * 大写字母和数字输入过滤器 + * 只允许输入大写字母(A-Z)和数字(0-9),小写字母自动转为大写 + */ +class UpperCaseAlphanumericInputFilter : InputFilter { + override fun filter( + source: CharSequence?, + start: Int, + end: Int, + dest: Spanned?, + dstart: Int, + dend: Int + ): CharSequence? { + if (source.isNullOrEmpty()) return null + + val filtered = StringBuilder() + for (i in start until end) { + val char = source[i] + // 只允许ASCII字母(A-Z, a-z)和数字(0-9) + if (char in 'A'..'Z' || char in 'a'..'z' || char in '0'..'9') { + // 自动转为大写 + filtered.append(char.uppercaseChar()) + } + } + + // 如果过滤后的内容与原内容相同,返回null表示不修改 + // 否则返回过滤后的内容 + return if (filtered.toString() == source.subSequence(start, end).toString()) { + null + } else { + filtered.toString() + } + } +} + +/** + * 为 EditText 设置大写字母和数字输入过滤器 + * 使用方式: editText.setUpperCaseAlphanumericFilter() + */ +fun EditText.setUpperCaseAlphanumericFilter() { + this.filters = arrayOf(UpperCaseAlphanumericInputFilter()) } \ No newline at end of file diff --git a/module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcBoxWeighingAddActivity.kt b/module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcBoxWeighingAddActivity.kt index ece16df..1cfc65d 100644 --- a/module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcBoxWeighingAddActivity.kt +++ b/module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcBoxWeighingAddActivity.kt @@ -7,6 +7,7 @@ import com.lukouguoji.gjc.R import com.lukouguoji.gjc.databinding.ActivityGjcBoxWeighingAddBinding import com.lukouguoji.gjc.viewModel.GjcBoxWeighingAddViewModel import com.lukouguoji.module_base.base.BaseBindingActivity +import com.lukouguoji.module_base.ktx.setUpperCaseAlphanumericFilter /** * 国际出港板箱过磅添加页面 @@ -22,6 +23,11 @@ class GjcBoxWeighingAddActivity : setBackArrow("板箱过磅") binding.viewModel = viewModel viewModel.initOnCreated(this) + + // 为架子车号、ULD编码、IMP代码添加大写字母和数字的输入限制 + binding.carIdInput.et.setUpperCaseAlphanumericFilter() + binding.uldNoInput.et.setUpperCaseAlphanumericFilter() + binding.impCodeInput.et.setUpperCaseAlphanumericFilter() } companion object { diff --git a/module_gjc/src/main/res/layout/activity_gjc_box_weighing_add.xml b/module_gjc/src/main/res/layout/activity_gjc_box_weighing_add.xml index a4629a3..0d51b05 100644 --- a/module_gjc/src/main/res/layout/activity_gjc_box_weighing_add.xml +++ b/module_gjc/src/main/res/layout/activity_gjc_box_weighing_add.xml @@ -102,6 +102,7 @@ android:layout_weight="1" />