/* 
 * =============================================================================
 * 文件名稱：AutoIndentEditText.java
 * 項目名稱：AutoIndentDemo
 * 創(chuàng)建日期：2025-04-14
 * 作者：Katie
 * 描述：本自定義 EditText 實現(xiàn)了換行后自動縮進的功能。
 *       通過添加 TextWatcher，在檢測到換行符插入后自動在新行首部添加固定
 *       數(shù)量的空格（例如 4 個空格），提高文本輸入排版的友好性。
 * =============================================================================
 */
package com.example.autoinitdemo;
 
import android.content.Context;
import android.text.Editable;
import android.text.TextWatcher;
import android.util.AttributeSet;
import androidx.appcompat.widget.AppCompatEditText;
 
public class AutoIndentEditText extends AppCompatEditText {
    // 定義是否正在進行內部文本修改，避免重復遞歸觸發(fā)監(jiān)聽器
    private boolean isEditing = false;
    // 定義自動縮進的字符串（例如 4 個空格）
    private final String indent = "    ";
 
    public AutoIndentEditText(Context context) {
        super(context);
        init();
    }
 
    public AutoIndentEditText(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }
 
    public AutoIndentEditText(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }
 
    // 初始化方法，添加 TextWatcher 監(jiān)聽器
    private void init() {
        // 添加文本變化監(jiān)聽
        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) {
                // 防止由內部修改文本再次觸發(fā) afterTextChanged 導致死循環(huán)
                if (isEditing) {
                    return;
                }
                isEditing = true;
 
                int length = s.length();
                // 如果文本非空并且最后一個字符為換行符
                if (length > 0 && s.charAt(length - 1) == '\n') {
                    // 自動插入縮進字符到換行符后
                    s.insert(length, indent);
                    // 將光標定位到最終位置，確保用戶繼續(xù)輸入
                    setSelection(s.length());
                }
                isEditing = false;
            }
        });
    }
}

<!--
    =============================================================================
    文件名稱：activity_main.xml
    項目名稱：AutoIndentDemo
    創(chuàng)建日期：2025-04-14
    作者：Katie
    描述：本布局文件定義了一個簡單的界面，包含自定義 AutoIndentEditText 控件，
           用于展示換行后自動縮進的效果?？芍苯舆\行調試。
    =============================================================================
-->
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/root_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp"
    android:background="#FAFAFA">
 
    <!-- 使用自定義的 AutoIndentEditText 控件 -->
    <com.example.autoinitdemo.AutoIndentEditText
        android:id="@+id/auto_indent_edittext"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="top|start"
        android:textSize="16sp"
        android:background="@android:color/white"
        android:padding="12dp"
        android:scrollbars="vertical" />
 
</FrameLayout>