Android实现EditText换行自动缩进（附带源码）-CSDN博客

本文链接：https://blog.csdn.net/m0_61840987/article/details/151321443

Android 实现 EditText 换行自动缩进

一、项目背景详细介绍

在 Android 应用的文本输入场景中，EditText 是最常用的输入控件。通常它只提供基本的文本输入功能，但在一些特定的应用中，我们希望能够增加 换行自动缩进 的体验。例如：

笔记类应用：用户在编写多层级笔记时，按下回车后新行自动继承上行的缩进，提升排版一致性。
代码编辑器：当开发者在编写代码时，回车后光标应自动缩进到合适位置，以保持代码结构美观。
文章写作应用：用户编写段落时希望每行开头自动缩进两个字符，从而保持规范的文章格式。

传统的 EditText 并不具备这种功能，我们需要通过 监听输入事件 + 文本处理 来实现。

因此，本项目目标是：实现一个支持换行自动缩进的 EditText 控件，让用户在回车后自动缩进到指定位置。

二、项目需求详细介绍

核心需求
- 用户在 EditText 输入文字时，按下 回车键（Enter） 后，新行开头会自动添加缩进。
- 缩进方式支持 固定空格缩进（如两个空格或制表符）。
扩展需求
- 缩进可配置，例如：
  - 两个空格；
  - 一个制表符 \t；
  - 根据上一行的缩进自动继承。
- 提供一个接口 setIndentation(String indent)，支持自定义缩进规则。
兼容性要求
- 适配不同输入法；
- 不影响普通输入功能。

三、相关技术详细介绍

EditText 基础
- EditText 是 TextView 的子类，支持文本输入、换行等功能；
- 通过 addTextChangedListener 监听输入变化。
TextWatcher
- beforeTextChanged：文本变化前回调；
- onTextChanged：文本变化时回调；
- afterTextChanged：文本变化后回调，可在这里修改文本内容。
Selection 类
- Selection.setSelection(Editable text, int index)：设置光标位置，保证缩进后光标跳转到正确位置。
Editable 接口
- Editable 是 EditText.getText() 的返回值，支持对文本进行增删改。

四、实现思路详细介绍

继承 EditText
- 新建一个自定义控件 IndentEditText，继承 AppCompatEditText；
- 提供缩进配置字段，例如默认两个空格 " "。
监听输入
- 使用 addTextChangedListener 监听文本变化；
- 检测是否输入了换行符 \n。
自动添加缩进
- 当检测到输入换行时，在新行位置插入缩进字符串；
- 使用 Selection.setSelection 将光标移动到缩进后的位置。
可扩展性
- 提供 setIndentation(String indent) 方法，允许外部设置缩进规则。

五、完整实现代码

// ======================= 自定义 IndentEditText.java =======================
// 文件：IndentEditText.java
package com.example.indentedittext;

import android.content.Context;
import android.text.Editable;
import android.text.Selection;
import android.text.TextWatcher;
import android.util.AttributeSet;

import androidx.appcompat.widget.AppCompatEditText;

public class IndentEditText extends AppCompatEditText {

    // 默认缩进：两个空格
    private String indentation = "  ";

    // 标记：是否正在处理缩进，避免递归调用
    private boolean isProcessing = false;

    public IndentEditText(Context context) {
        super(context);
        init();
    }

    public IndentEditText(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    public IndentEditText(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init() {
        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 editable) {
                if (isProcessing) return;

                int selectionStart = getSelectionStart();
                if (selectionStart > 0 && selectionStart <= editable.length()) {
                    char lastChar = editable.charAt(selectionStart - 1);

                    // 如果输入的是换行符
                    if (lastChar == '\n') {
                        isProcessing = true;

                        // 在当前位置插入缩进
                        editable.insert(selectionStart, indentation);

                        // 将光标移动到缩进后面
                        Selection.setSelection(editable, selectionStart + indentation.length());

                        isProcessing = false;
                    }
                }
            }
        });
    }

    // 设置缩进字符串
    public void setIndentation(String indent) {
        this.indentation = indent;
    }
}


// ======================= MainActivity.java =======================
// 文件：MainActivity.java
package com.example.indentedittext;

import android.os.Bundle;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}


// ======================= activity_main.xml =======================
// 文件：res/layout/activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp">

    <com.example.indentedittext.IndentEditText
        android:id="@+id/editText"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:hint="请输入文本，换行后自动缩进"
        android:gravity="top|start"
        android:inputType="textMultiLine"
        android:background="@android:drawable/edit_text"
        android:padding="8dp"/>
</LinearLayout>

六、代码详细解读

IndentEditText
- 继承自 AppCompatEditText；
- 在 afterTextChanged 方法中监听输入内容；
- 如果用户输入了 \n，则在其后插入缩进字符串（默认两个空格）；
- 使用 Selection.setSelection 保证光标跳转到缩进后的位置；
- 通过 setIndentation(String indent) 方法允许自定义缩进。
MainActivity
- 直接加载 activity_main.xml，不需要额外逻辑。
布局文件
- 使用自定义控件 IndentEditText 替代普通 EditText；
- 设置 inputType="textMultiLine"，支持多行输入；
- 设置 gravity="top|start" 让输入内容从左上角开始。