Android EditText 文本编辑控件源码解析

本文还有配套的精品资源，点击获取

简介：EditText 是 Android 开发中用于用户文本输入的组件。本源码解析项目包含了理解和自定义 EditText 的示例代码，涵盖了基本使用、输入类型、文本变化监听、用户输入验证、限制输入长度、输入过滤、光标控制、提示文本、自定义样式、交互事件、IME 选项和自定义 EditText 等知识点。通过研究源码，开发者可以深入了解 EditText 的实际应用，提升对文本编辑控件的掌控力。

1. EditText 基本概念与使用

EditText 是 Android 中用于获取用户文本输入的控件。它是一个单行文本输入框，允许用户输入文本数据。

要使用 EditText，需要在布局文件中声明它，并为其指定一个 id：

<EditText
    android:id="@+id/myEditText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

然后，可以在代码中通过 findViewById() 方法获取 EditText 的引用，并对其进行操作：

EditText editText = findViewById(R.id.myEditText);
editText.setText("Hello, world!");

2. EditText 输入类型与监听

2.1 输入类型

EditText 提供了多种输入类型，以适应不同的数据输入场景。这些类型可以通过 setInputType() 方法设置。

2.1.1 文本类型

文本类型是最基本的输入类型，允许用户输入任意文本。它可以通过以下常量指定：

InputType.TYPE_CLASS_TEXT

2.1.2 数字类型

数字类型限制用户只能输入数字，包括小数点。它可以通过以下常量指定：

InputType.TYPE_CLASS_NUMBER | InputType.TYPE_NUMBER_FLAG_DECIMAL

2.1.3 日期类型

日期类型允许用户输入日期，包括年、月、日。它可以通过以下常量指定：

InputType.TYPE_CLASS_DATETIME | InputType.TYPE_DATETIME_VARIATION_DATE

2.2 监听文本变化

2.2.1 addTextChangedListener() 方法

addTextChangedListener() 方法可以为 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) {
        // 在文本改变之后调用
    }
});

2.2.2 TextWatcher 接口

TextWatcher 接口提供了三个回调方法：

• beforeTextChanged() ：在文本改变之前调用。
• onTextChanged() ：在文本改变时调用。
• afterTextChanged() ：在文本改变之后调用。

2.3 监听光标位置变化

2.3.1 addTextChangedListener() 方法

addTextChangedListener() 方法也可以用来监听光标位置的变化。

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) {
        // 在光标位置改变之后调用
    }
});

2.3.2 TextWatcher 接口

TextWatcher 接口提供了三个回调方法：

• beforeTextChanged() ：在光标位置改变之前调用。
• onTextChanged() ：在光标位置改变时调用。
• afterTextChanged() ：在光标位置改变之后调用。

3. EditText 用户输入验证与限制

3.1 用户输入验证

用户输入验证是确保 EditText 中输入的数据符合特定要求的关键。Android 提供了多种方法来验证用户输入，包括：

3.1.1 正则表达式验证

正则表达式是一种强大的模式匹配语言，可用于验证字符串是否符合特定模式。要使用正则表达式验证 EditText 输入，可以使用 Pattern 类：

Pattern pattern = Pattern.compile("^[a-zA-Z0-9]*$");
Matcher matcher = pattern.matcher(input);
if (matcher.matches()) {
    // 输入有效
} else {
    // 输入无效
}

3.1.2 范围验证

范围验证用于确保输入值在指定范围内。可以使用 Double.parseDouble() 或 Integer.parseInt() 方法将输入转换为数字，然后与范围边界进行比较：

double input = Double.parseDouble(editText.getText().toString());
if (input >= min && input <= max) {
    // 输入有效
} else {
    // 输入无效
}

3.2 限制输入长度

有时需要限制 EditText 中可以输入的字符数。Android 提供了两种方法来实现此目的：

3.2.1 setMaxLines() 方法

setMaxLines() 方法限制 EditText 中可以显示的行数。如果输入的文本超过指定行数，它将被截断：

editText.setMaxLines(5);

3.2.2 setMaxEms() 方法

setMaxEms() 方法限制 EditText 中可以显示的字符数。一个 em 是一个字符的宽度，具体取决于设备的字体设置：

editText.setMaxEms(10);

3.3 输入过滤

输入过滤是用于限制 EditText 中输入内容的强大机制。Android 提供了多种预定义的输入过滤器，包括：

3.3.1 InputFilter 接口

InputFilter 接口定义了用于过滤输入字符的方法。可以通过实现此接口创建自定义输入过滤器：

class MyInputFilter implements InputFilter {
    @Override
    public CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {
        // 过滤输入字符
        return null;
    }
}

3.3.2 常用输入过滤器

Android 提供了多种预定义的输入过滤器，包括：

• InputFilter.LengthFilter ：限制输入字符数
• InputFilter.DigitsOnlyFilter ：仅允许输入数字
• InputFilter.AllCapsFilter ：将所有输入转换为大写
• InputFilter.EmailAddressFilter ：验证电子邮件地址

4. EditText 光标控制与提示文本

4.1 光标控制

光标控制允许开发者对 EditText 中光标的位置进行操作。EditText 提供了多种方法来设置和获取光标的位置，包括：

4.1.1 setSelection() 方法

setSelection() 方法用于将光标移动到指定的文本位置。该方法接受一个整数参数，表示要移动光标到的文本位置的索引。

editText.setSelection(index);

参数说明：

• index ：要移动光标到的文本位置的索引。

代码逻辑分析：

该方法将光标移动到指定索引位置。如果索引超出文本长度，光标将移动到文本末尾。

4.1.2 setSelectionStart() 和 setSelectionEnd() 方法

setSelectionStart() 和 setSelectionEnd() 方法允许开发者分别设置光标的起始和结束位置。这两个方法都接受一个整数参数，表示要设置的光标位置的索引。

editText.setSelectionStart(startIndex);
editText.setSelectionEnd(endIndex);

参数说明：

• startIndex ：要设置光标起始位置的索引。
• endIndex ：要设置光标结束位置的索引。

代码逻辑分析：

这两个方法将光标的起始和结束位置分别移动到指定索引位置。如果索引超出文本长度，光标将移动到文本末尾。

4.2 提示文本

提示文本是在 EditText 为空时显示的文本，它可以指导用户输入内容。EditText 提供了以下方法来设置和获取提示文本：

4.2.1 setHint() 方法

setHint() 方法用于设置 EditText 的提示文本。该方法接受一个字符串参数，表示要设置的提示文本。

editText.setHint("请输入您的姓名");

参数说明：

• hint ：要设置的提示文本。

代码逻辑分析：

该方法将 EditText 的提示文本设置为指定的字符串。

4.2.2 setHintTextColor() 方法

setHintTextColor() 方法用于设置 EditText 提示文本的颜色。该方法接受一个颜色值参数，表示要设置的提示文本颜色。

editText.setHintTextColor(Color.GRAY);

参数说明：

• color ：要设置的提示文本颜色。

代码逻辑分析：

该方法将 EditText 的提示文本颜色设置为指定的颜色。

5. EditText 样式与外观自定义

5.1 样式自定义

5.1.1 setBackground() 方法

setBackground() 方法用于设置 EditText 的背景。背景可以是颜色、图片或 Drawable 对象。

代码块：

EditText editText = (EditText) findViewById(R.id.edit_text);
editText.setBackgroundColor(Color.parseColor("#FF0000"));

逻辑分析：

此代码将 EditText 的背景颜色设置为红色。

参数说明：

• color ：要设置的背景颜色。

5.1.2 setPadding() 方法

setPadding() 方法用于设置 EditText 内部的填充。填充是指 EditText 与其边界之间的空白区域。

代码块：

EditText editText = (EditText) findViewById(R.id.edit_text);
editText.setPadding(10, 10, 10, 10);

逻辑分析：

此代码将 EditText 的填充设置为 10dp，即在 EditText 的顶部、底部、左侧和右侧都留出 10dp 的空白区域。

参数说明：

• left ：左填充。
• top ：上填充。
• right ：右填充。
• bottom ：下填充。

5.2 外观自定义

5.2.1 setTextColor() 方法

setTextColor() 方法用于设置 EditText 中文本的颜色。

代码块：

EditText editText = (EditText) findViewById(R.id.edit_text);
editText.setTextColor(Color.parseColor("#00FF00"));

逻辑分析：

此代码将 EditText 中文本的颜色设置为绿色。

参数说明：

• color ：要设置的文本颜色。

5.2.2 setTextSize() 方法

setTextSize() 方法用于设置 EditText 中文本的大小。

代码块：

EditText editText = (EditText) findViewById(R.id.edit_text);
editText.setTextSize(TypedValue.COMPLEX_UNIT_SP, 20);

逻辑分析：

此代码将 EditText 中文本的大小设置为 20sp。

参数说明：

• unit ：文本大小的单位。可以是 TypedValue.COMPLEX_UNIT_SP （像素）或 TypedValue.COMPLEX_UNIT_DIP （设备独立像素）。
• size ：文本的大小。

6. EditText 交互事件与 IME 选项

6.1 交互事件

6.1.1 onClick() 方法

onClick() 方法用于监听 EditText 的点击事件。当用户点击 EditText 时，该方法会被调用。

代码示例：

editText.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // 点击 EditText 时执行的操作
    }
});

6.1.2 onFocusChange() 方法

onFocusChange() 方法用于监听 EditText 的焦点变化事件。当 EditText 获得或失去焦点时，该方法会被调用。

代码示例：

editText.setOnFocusChangeListener(new View.OnFocusChangeListener() {
    @Override
    public void onFocusChange(View v, boolean hasFocus) {
        // EditText 获得或失去焦点时执行的操作
    }
});

6.2 IME 选项

6.2.1 setImeOptions() 方法

setImeOptions() 方法用于设置 EditText 的 IME（输入法编辑器）选项。这些选项可以控制 IME 的行为，例如是否显示完成按钮或下一个按钮。

代码示例：

editText.setImeOptions(EditorInfo.IME_ACTION_DONE);

6.2.2 常用 IME 选项

| 选项 | 描述 | |---|---| | IME_ACTION_DONE | 显示完成按钮 | | IME_ACTION_NEXT | 显示下一个按钮 | | IME_ACTION_SEARCH | 显示搜索按钮 | | IME_FLAG_NO_EXTRACT_UI | 隐藏 IME 提取 UI | | IME_FLAG_NO_FULLSCREEN | IME 不占据全屏 |

本文还有配套的精品资源，点击获取

简介：EditText 是 Android 开发中用于用户文本输入的组件。本源码解析项目包含了理解和自定义 EditText 的示例代码，涵盖了基本使用、输入类型、文本变化监听、用户输入验证、限制输入长度、输入过滤、光标控制、提示文本、自定义样式、交互事件、IME 选项和自定义 EditText 等知识点。通过研究源码，开发者可以深入了解 EditText 的实际应用，提升对文本编辑控件的掌控力。

本文还有配套的精品资源，点击获取