一、EditText 基础：不仅仅是输入框

EditText 是 TextView 的子类，允许用户输入和编辑文本。

1. 基本布局

<EditTextandroid:id="@+id/et_username"android:layout_width="match_parent"android:layout_height="wrap_content"android:hint="请输入用户名"android:textColorHint="#999999"android:textColor="#333333"android:textSize="16sp"android:padding="12dp"android:background="@drawable/edittext_bg" />

2. 获取输入内容

EditText etUsername = findViewById(R.id.et_username);
String username = etUsername.getText().toString().trim();

⚠️ 注意：始终使用 trim() 去除首尾空格。

二、inputType：精准控制输入类型

android:inputType 是控制 EditText 输入内容和软键盘类型的关键属性。

1. 常用 inputType 值

2. 组合使用

<!-- 邮箱输入 -->
<EditTextandroid:inputType="textEmailAddress"android:hint="邮箱地址" /><!-- 密码输入 -->
<EditTextandroid:inputType="textPassword"android:hint="密码" /><!-- 手机号码 -->
<EditTextandroid:inputType="phone"android:hint="手机号" /><!-- 多行评论 -->
<EditTextandroid:inputType="textMultiLine|textCapSentences"android:lines="3"android:gravity="top|start"android:hint="请输入评论..." />

✅ 最佳实践：始终为 EditText 设置合适的 inputType，提升输入效率和准确性。

三、软键盘（IME）控制

1. 控制软键盘行为

<!-- 回车键功能 -->
<EditTextandroid:imeOptions="actionDone"android:inputType="text"android:nextFocusDown="@+id/et_password" /><!-- 可选值: actionGo, actionSearch, actionSend, actionNext, actionDone -->

2. 监听回车键

etUsername.setOnEditorActionListener(new TextView.OnEditorActionListener() {@Overridepublic boolean onEditorAction(TextView v, int actionId, KeyEvent event) {if (actionId == EditorInfo.IME_ACTION_DONE) {// 处理“完成”按钮点击hideKeyboard(v);performLogin();return true;}return false;}
});

3. 显示/隐藏软键盘

// 显示软键盘
InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
imm.showSoftInput(etUsername, InputMethodManager.SHOW_IMPLICIT);// 隐藏软键盘
imm.hideSoftInputFromWindow(etUsername.getWindowToken(), 0);

四、输入过滤与格式化

1. 限制输入长度

<EditTextandroid:maxLength="11"android:hint="手机号（11位）" />

2. 自定义输入过滤器

// 只允许输入数字和字母
InputFilter filter = new InputFilter() {@Overridepublic CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {String blockChars = "!@#$%^&*()_+-=[]{}|;':\",./<>?";for (int i = start; i < end; i++) {if (blockChars.indexOf(source.charAt(i)) != -1) {return ""; // 过滤掉}}return null; // 允许输入}
};
etUsername.setFilters(new InputFilter[]{filter});

3. 实时格式化（如手机号 3-4-4）

etPhone.addTextChangedListener(new TextWatcher() {private String previous = "";@Overridepublic void beforeTextChanged(CharSequence s, int start, int count, int after) {previous = s.toString();}@Overridepublic void onTextChanged(CharSequence s, int start, int before, int count) {}@Overridepublic void afterTextChanged(Editable s) {String digits = s.toString().replaceAll("\\D", ""); // 只保留数字if (digits.length() > 11) {digits = digits.substring(0, 11);}// 格式化为 3-4-4String formatted = formatPhoneNumber(digits);if (!formatted.equals(s.toString())) {s.replace(0, s.length(), formatted);}}private String formatPhoneNumber(String digits) {if (digits.length() <= 3) return digits;else if (digits.length() <= 7) return digits.substring(0, 3) + "-" + digits.substring(3);else return digits.substring(0, 3) + "-" + digits.substring(3, 7) + "-" + digits.substring(7);}
});

五、安全性与隐私

1. 密码输入安全

• 使用 textPassword 或 textWebPassword。
• 避免在日志中打印密码。
• 考虑实现“显示/隐藏密码”功能：

<com.google.android.material.textfield.TextInputLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"app:passwordToggleEnabled="true"><com.google.android.material.textfield.TextInputEditTextandroid:layout_width="match_parent"android:layout_height="wrap_content"android:inputType="textPassword"android:hint="密码" /></com.google.android.material.textfield.TextInputLayout>

2. 防止敏感信息保存

<!-- 禁止输入历史和拼写检查 -->
<EditTextandroid:inputType="textNoSuggestions|textVisiblePassword"android:importantForAutofill="no" />

六、Material Design 最佳实践

推荐使用 Material Design 的 TextInputLayout + TextInputEditText 组合，提供更专业的表单体验。

1. 添加依赖

implementation 'com.google.android.material:material:1.11.0'

2. 使用 TextInputLayout

<com.google.android.material.textfield.TextInputLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:hint="用户名"app:errorEnabled="true"app:counterEnabled="true"app:counterMaxLength="20"><com.google.android.material.textfield.TextInputEditTextandroid:layout_width="match_parent"android:layout_height="wrap_content"android:inputType="text"android:maxLines="1" /></com.google.android.material.textfield.TextInputLayout>

3. 动态显示错误信息

TextInputLayout tilUsername = findViewById(R.id.til_username);
TextInputEditText etUsername = tilUsername.getEditText();// 验证输入
if (username.isEmpty()) {tilUsername.setError("用户名不能为空");
} else {tilUsername.setError(null); // 清除错误
}

✅ 优势：

• 浮动标签（Floating Label）
• 内置错误提示
• 字数统计
• 更好的无障碍支持

七、用户体验优化

1. 自动聚焦：页面打开时自动聚焦到第一个输入框。
2. 回车跳转：使用 nextFocusDown 实现输入框间的跳转。
3. 清除按钮：长按或聚焦时显示清除图标。
4. 输入提示：使用 AutoCompleteTextView 提供搜索建议。
5. 防抖提交：避免用户快速点击提交按钮。

八、总结：文本输入设计 checklist

九、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！