Android开发-文本输入

news2025/5/19 11:10:38

在Android应用开发中，文本输入是用户与应用交互的最常见方式之一。无论是登录界面、搜索框还是表单填写，都需要处理用户的文本输入。本文将介绍如何在Android应用中实现和管理文本输入，包括基本控件的使用、事件监听、输入验证以及一些高级功能。

一、基础文本输入控件

（一）EditText 控件

EditText 是Android中最常用的文本输入控件。它允许用户直接在界面上输入文本，并提供了丰富的属性用于自定义其外观和行为。

XML布局示例：

<EditText
    android:id="@+id/editText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:hint="请输入内容" />

android:hint: 提供一个提示信息，当用户未输入任何内容时显示。
android:inputType: 指定输入的内容类型（如文本、数字、电话号码等），以便系统提供相应的键盘布局。

常见的`inputType`值：

text: 默认文本输入。
number: 数字输入。
phone: 电话号码输入。
textPassword: 密码输入，字符会被隐藏。

（二）设置最大长度

有时你可能希望限制用户输入的最大长度。可以通过android:maxLength属性来实现。

<EditText
    android:id="@+id/editText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:maxLength="10"
    android:hint="最多输入10个字符" />

二、获取和设置文本

在Activity或Fragment中，可以通过以下方式获取和设置EditText中的文本内容。

（一）获取文本

EditText editText = findViewById(R.id.editText);
String inputText = editText.getText().toString();

（二）设置文本

editText.setText("默认文本");

三、监听文本变化

为了响应用户的输入操作，可以为EditText添加一个TextWatcher监听器。

editText.addTextChangedListener(new TextWatcher() {
    @Override
    public void beforeTextChanged(CharSequence s, int start, int count, int after) {
        // 在文本改变之前调用
    }

    @Override
    public void onTextChanged(CharSequence s, int start, int before, int count) {
        // 当文本正在改变时调用
    }

    @Override
    public void afterTextChanged(Editable s) {
        // 在文本改变之后调用
    }
});

四、输入验证

确保用户输入的有效性是非常重要的，尤其是在涉及到用户名、密码、邮箱地址等敏感信息的时候。

（一）简单的正则表达式验证

public boolean isValidEmail(String email) {
    String emailPattern = "[a-zA-Z0-9._-]+@[a-z]+\\.+[a-z]+";
    return email.matches(emailPattern);
}

（二）结合`setError()`方法给出错误提示

如果输入不符合要求，可以通过setError()方法向用户提供反馈。

if (!isValidEmail(inputText)) {
    editText.setError("请输入有效的电子邮件地址");
} else {
    // 处理有效输入
}

五、高级功能

（一）自动补全

对于某些类型的输入，比如城市名或者用户名，可以使用AutoCompleteTextView提供自动补全功能。

<AutoCompleteTextView
    android:id="@+id/autoCompleteTextView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:hint="请输入城市名称"/>

然后在代码中设置适配器以提供补全选项。

ArrayAdapter<String> adapter = new ArrayAdapter<>(this,
        android.R.layout.simple_dropdown_item_1line, COUNTRIES);
AutoCompleteTextView textView = findViewById(R.id.autoCompleteTextView);
textView.setAdapter(adapter);

（二）多行输入

如果你需要支持多行文本输入，可以使用EditText的android:inputType="textMultiLine"属性。

<EditText
    android:id="@+id/multiLineEditText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:inputType="textMultiLine"
    android:minLines="4"
    android:gravity="top"/>