InputType — 是什么、输入属性及其在 Android 中的配置

Android 中的 InputType 是什么

InputType — 是一个整数常量（Int），对文本字段的输入模式进行编码。在 Android 中，它在 android.text.InputType 类中定义。InputType 值由两部分组成：输入类（位 0–4）和修饰符（位 5–31）。输入类确定基本数据类型——文本、数字、电话、日期。修饰符在所选类中详细说明行为——例如，对于文本类，可以启用自动更正、大写字母或多行输入。

InputType 机制在三个层面工作：在 Android 框架层面，它确定创建哪个 InputConnection（EditText 与 IME 之间的连接）；在 IME（键盘）层面，它指示显示哪些字符以及如何处理输入；在应用层面，它通过 EditText 内置的 InputFilter 过滤字符。根据 Android Source Code (AOSP, 2026)，位掩码在 TextView.getInputType() 方法（返回当前值）和 setInputType() 方法（重新配置内部过滤器和与 IME 的连接）中处理。

InputType 的一个重要特性——出于安全原因，无法从其他进程读取它。这可以防止通过访问输入类型（例如，确定字段是否为密码）来窃取数据。当尝试从其他应用程序读取 InputType 时，默认返回 TYPE_CLASS_TEXT。

// InputType 基本常量
InputType.TYPE_CLASS_TEXT       // 0x0001 = 1
InputType.TYPE_CLASS_NUMBER     // 0x0002 = 2
InputType.TYPE_CLASS_PHONE      // 0x0003 = 3
InputType.TYPE_CLASS_DATETIME   // 0x0004 = 4

// 用于提取类的掩码
InputType.TYPE_MASK_CLASS       // 0x0000000F

InputType 类：TEXT、NUMBER、PHONE、DATETIME

在 Android 中定义了四个基本的 InputType 类。每个类对应特定的数据类别并激活相应的键盘类型。类在位掩码的位 0–4 中指示，并可通过 TYPE_MASK_CLASS (0x0F) 掩码提取。

TYPE_CLASS_DATETIME 很少直接使用——通常输入日期使用 DatePicker 或 DatePickerDialog，而不是文本字段。但在某些场景中（快速手动输入日期），此类可能很有用。它没有专门的键盘，通常显示数字键盘。

每个输入类都可以与变体（variation）——位 5–7 中指示的子类型——组合。例如，TYPE_TEXT_VARIATION_PASSWORD（位 5）向 TEXT 类添加隐藏输入。变体位：0x000000E0（掩码 TYPE_MASK_VARIATION）。

InputType 标志修饰符

InputType 标志修饰符（位 8–31）为基础类添加额外功能。它们不会改变键盘类型，但会修改输入行为。标志是每个类特有的——TEXT 的标志不适用于 NUMBER，反之亦然。以下列出了每个类的主要修饰符。

TEXT 的标志

• TYPE_TEXT_FLAG_CAP_CHARACTERS — 所有字母大写。
• TYPE_TEXT_FLAG_CAP_WORDS — 每个单词首字母大写。
• TYPE_TEXT_FLAG_CAP_SENTENCES — 句子首字母大写（默认）。
• TYPE_TEXT_FLAG_AUTO_CORRECT — 自动更正拼写错误。
• TYPE_TEXT_FLAG_AUTO_COMPLETE — 自动完成（用于 AutoCompleteTextView）。
• TYPE_TEXT_FLAG_MULTI_LINE — 多行输入。
• TYPE_TEXT_FLAG_NO_SUGGESTIONS — 禁用建议。

NUMBER 的标志

• TYPE_NUMBER_FLAG_SIGNED — 允许负数（减号）。
• TYPE_NUMBER_FLAG_DECIMAL — 允许小数点。

根据 Android Developers Documentation (2026)，不同类的标志不重叠——尝试将 TEXT 标志与 NUMBER 一起使用将被忽略。要检查设置的标志，使用按位 AND：(inputType and FLAG) != 0。

InputType 组合：不同场景示例

InputType 与类和标志的正确组合是创建便捷表单的关键。让我们来看典型的场景和相应的 InputType 配置。每个场景针对特定数据类型优化输入，使表单直观并加快填写速度。

// 价格字段组合
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// 评论字段组合
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_MULTI_LINE

以编程方式使用 InputType

通过 setInputType() 以编程方式设置 InputType 会覆盖先前的值。如果只需要更改掩码的一部分（例如添加标志），则需要保存当前值、修改并重新应用。每次调用 setInputType() 都会重新配置 EditText 的内部过滤器。

setRawInputType() 方法与 setInputType 的不同之处在于它不会导致过滤器和建议的重新配置。它用于临时更改 InputType，而无需完全重新加载 EditText 状态。调用 setInputType() 后，建议重新启动 IME 以更新键盘。

切换模式

// 在密码和可见文本之间切换
fun togglePasswordVisibility(editText: EditText) {
    val currentType = editText.inputType
    val isPassword = (currentType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0

    editText.inputType = if (isPassword) {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
    } else {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_PASSWORD
    }

    // 保持光标位置
    val cursorPos = editText.selectionStart
    editText.setSelection(cursorPos)
}

提取类和变体

// 获取输入类
fun getInputClass(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_CLASS
}

// 获取输入变体
fun getInputVariation(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_VARIATION
}

// 检查是否为密码字段
fun isPasswordField(editText: EditText): Boolean {
    return (editText.inputType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0
}

选择 InputType 的最佳实践

正确选择 InputType 不仅仅是用户体验，还涉及安全性和数据准确性。主要建议包括：始终为每个 EditText 指定显式 InputType；使用最具体的输入类；不要组合来自不同类的标志；对于敏感数据字段使用 PASSWORD 变体；对于搜索字段使用 imeOptions=”actionSearch”。

InputType 也会影响辅助功能服务的运行。textPassword 类型的字段能获得屏幕阅读器的额外保护——它们不会朗读输入的字符。对于 textEmailAddress 字段，屏幕阅读器会通知用户该字段用于电子邮件，并提供相应的建议。

• 明确性 — 始终显式设置 InputType，不要依赖默认值（textMultiLine）。
• 具体性 — 使用最具体的类型：textEmailAddress，而不是 text 用于电子邮件。
• 安全性 — 对于密码、PIN 和卡片数据使用 PASSWORD 变体。
• 自动填充 — 将 InputType 与 autofillHints 结合使用以支持密码管理器。
• 测试 — 在不同键盘（Gboard、SwiftKey、Samsung Keyboard）上检查行为。

根据 Material Design Guidelines (2025)，InputType 应与用户输入的数据类型匹配。错误的 InputType 不仅会减慢输入速度，还可能导致错误：例如，如果输入电话号码时保留 textMultiLine，键盘将不会显示数字块，用户将被迫每次都手动切换布局。