解决Android EditText多行文本与NestedScrollView滑动冲突_edittext和nestscrollview的滑动冲突-优快云博客

本文链接：https://blog.youkuaiyun.com/asd2278344/article/details/147068945

一、问题场景复现

在 Android 开发中，当使用NestedScrollView包裹多行EditText时，经常会遇到一些棘手的问题，这些问题严重影响了用户体验和应用的交互性。常见的现象主要有以下几种：

输入内容超出 EditText 显示范围时无法滑动查看：当用户在EditText中输入大量文本，内容超出了EditText本身的显示区域时，正常情况下应该可以通过滑动来查看隐藏的文本。然而，在NestedScrollView嵌套EditText的场景下，往往无法实现这一操作，用户只能看到部分文本，无法查看完整内容。

滑动 EditText 区域时触发父容器滚动：当用户尝试在EditText区域内滑动以查看更多文本时，结果却触发了NestedScrollView（父容器）的滚动，而不是EditText内部的滚动。这就导致用户无法按照预期在EditText中自由滚动查看内容，交互逻辑出现混乱。

软键盘弹出后布局异常跳动：在输入过程中，当软键盘弹出时，包含NestedScrollView和EditText的布局可能会出现异常跳动的情况。这不仅影响了界面的美观度，还可能导致用户输入时的焦点丢失或输入位置不准确等问题，极大地降低了用户体验。
下面通过一个简单的示例布局文件来直观地展示这种嵌套结构：

<NestedScrollView
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <!-- 其他组件 -->

        <EditText
            android:id="@+id/editText"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:inputType="textMultiLine" />

        <!-- 其他组件 -->

    </LinearLayout>

</NestedScrollView>

在这个布局中，NestedScrollView包裹着一个LinearLayout，而LinearLayout中包含了一个多行输入的EditText。在实际运行中，上述提到的问题就很容易出现。

二、冲突原因剖析

要解决EditText与NestedScrollView之间的滑动冲突，我们需要深入分析问题产生的根源。这涉及到 Android 的事件分发机制以及这两个控件自身的滚动控制逻辑。

2.1 事件分发机制

在 Android 中，事件分发遵循从父容器到子视图的顺序。当用户触摸屏幕时，触摸事件首先传递给最外层的父容器，然后父容器会根据自身的逻辑决定是否拦截该事件。如果父容器拦截了事件，那么子视图将无法接收到该事件；反之，子视图可以处理该事件。

在NestedScrollView和EditText的嵌套结构中，NestedScrollView作为父容器，默认会拦截触摸事件。当用户在EditText区域滑动时，NestedScrollView会首先接收到滑动事件，并认为这是对它自身的滚动操作，从而优先处理该事件，导致EditText无法获取到滑动事件，也就无法实现内部滚动。具体来说，NestedScrollView在onInterceptTouchEvent方法中会根据一定的条件判断是否拦截触摸事件。当它判断为需要滚动时，就会拦截事件，使得EditText无法处理滑动事件。这是因为NestedScrollView的设计初衷是为了处理嵌套滚动场景，它会优先保证自身的滚动逻辑，而忽略了子视图EditText的滚动需求。

2.2 滚动控制逻辑

EditText默认情况下并不启用滚动功能。虽然它支持多行文本输入，但当内容超出其显示区域时，并不会自动显示滚动条或提供滚动操作。这就导致在没有额外处理的情况下，用户无法直接在EditText中滚动查看超出部分的文本。

当EditText被嵌套在NestedScrollView中时，其触摸事件的处理与父容器NestedScrollView产生了冲突。由于EditText本身没有滚动功能，当用户滑动时，NestedScrollView会按照自己的逻辑来处理滑动事件，而不是将其传递给EditText进行内部滚动处理。此外，EditText在处理触摸事件时，没有正确地与NestedScrollView进行协调，导致无法告知NestedScrollView自己是否需要滚动，从而使得父容器错误地拦截了滑动事件。

三、解决方案实现

方案一：自定义 EditText 控件

自定义EditText控件是解决滑动冲突的一种有效方法。通过自定义EditText，我们可以重写其触摸事件处理逻辑，使其能够正确地与NestedScrollView进行交互。

import android.content.Context;
import android.text.method.ScrollingMovementMethod;
import android.util.AttributeSet;
import android.view.MotionEvent;
import android.widget.ScrollView;
import androidx.appcompat.widget.AppCompatEditText;

public class NonInterceptingEditText extends AppCompatEditText {
    public NonInterceptingEditText(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        // 启用滚动功能
        setMovementMethod(ScrollingMovementMethod.getInstance());
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        int action = event.getActionMasked();
        switch (action) {
            case MotionEvent.ACTION_DOWN:
                // 当触摸事件开始时，请求父视图不要拦截触摸事件
                getParent().requestDisallowInterceptTouchEvent(true);
                break;
            case MotionEvent.ACTION_MOVE:
                // 如果EditText可以竖直滚动，则请求父视图不要拦截触摸事件
                if (canVerticalScroll(this)) {
                    getParent().requestDisallowInterceptTouchEvent(true);
                } else {
                    // 如果不能滚动，则允许父视图拦截触摸事件
                    getParent().requestDisallowInterceptTouchEvent(false);
                }
                break;
            case MotionEvent.ACTION_UP:
            case MotionEvent.ACTION_CANCEL:
                // 当触摸事件结束或取消时，允许父视图再次拦截触摸事件
                getParent().requestDisallowInterceptTouchEvent(false);
                break;
        }
        return super.onTouchEvent(event);
    }

    /**
     * 判断EditText是否可以竖直滚动
     *
     * @return true 如果可以滚动，false 如果不能滚动
     */
    private boolean canVerticalScroll(NonInterceptingEditText editText) {
        // 滚动的距离
        int scrollY = editText.getScrollY();
        // 控件内容的总高度
        int scrollRange = editText.getLayout().getHeight();
        // 控件实际显示的高度
        int scrollExtent = editText.getHeight() - editText.getCompoundPaddingTop() - editText.getCompoundPaddingBottom();
        // 控件内容总高度与实际显示高度的差值
        int scrollDifference = scrollRange - scrollExtent;

        return scrollDifference != 0 && (scrollY > 0 || scrollY < scrollDifference - 1);
    }
}

在上述代码中，我们自定义了一个NonInterceptingEditText类，继承自AppCompatEditText 。在构造函数中，通过setMovementMethod(ScrollingMovementMethod.getInstance())启用了EditText的滚动功能。在onTouchEvent方法中，根据触摸事件的类型和EditText是否可以竖直滚动，来请求父视图是否拦截触摸事件。这样，当EditText可以滚动时，父视图NestedScrollView不会拦截触摸事件，从而实现了EditText的内部滚动；当EditText不能滚动时，父视图可以正常处理滚动事件。在布局文件中使用自定义的EditText：

<NestedScrollView
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <!-- 其他组件 -->

        <com.ui.cus.NonInterceptingEditText
            android:id="@+id/editText"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:inputType="textMultiLine" />

        <!-- 更多组件 -->

    </LinearLayout>

</NestedScrollView>

方案二：设置触摸监听器

除了自定义EditText控件，我们还可以通过为EditText设置触摸监听器来解决滑动冲突。这种方法相对简单，不需要创建新的类。在 Activity 或 Fragment 中，为EditText设置触摸监听器：

EditText editText = findViewById(R.id.editText);
editText.setOnTouchListener(new View.OnTouchListener() {
    @Override
    public boolean onTouch(View v, MotionEvent event) {
        int action = event.getActionMasked();
        switch (action) {
            case MotionEvent.ACTION_DOWN:
                // 当触摸事件开始时，请求父视图不要拦截触摸事件
                v.getParent().requestDisallowInterceptTouchEvent(true);
                break;
            case MotionEvent.ACTION_MOVE:
                // 如果EditText可以竖直滚动，则请求父视图不要拦截触摸事件
                if (canVerticalScroll((EditText) v)) {
                    v.getParent().requestDisallowInterceptTouchEvent(true);
                } else {
                    // 如果不能滚动，则允许父视图拦截触摸事件
                    v.getParent().requestDisallowInterceptTouchEvent(false);
                }
                break;
            case MotionEvent.ACTION_UP:
            case MotionEvent.ACTION_CANCEL:
                // 当触摸事件结束或取消时，允许父视图再次拦截触摸事件
                v.getParent().requestDisallowInterceptTouchEvent(false);
                break;
        }
        return false;
    }
});

其中，canVerticalScroll方法与自定义EditText控件中的实现相同，用于判断EditText是否可以竖直滚动。这种方式通过在代码中动态设置触摸监听器，同样实现了对触摸事件的控制，达到了解决滑动冲突的目的。

四、核心实现原理

4.1 事件拦截控制

在解决EditText与NestedScrollView滑动冲突的过程中，事件拦截控制起着关键作用。其核心思想是通过巧妙地请求父容器（即NestedScrollView）在不同的触摸事件阶段是否拦截触摸事件，来确保EditText和NestedScrollView的滚动逻辑互不干扰。具体实现如下：

ACTION_DOWN 阶段：当触摸事件开始，即接收到ACTION_DOWN事件时，EditText会向父容器发送请求，调用getParent().requestDisallowInterceptTouchEvent(true) 。这一操作的目的是明确告知父容器，后续的触摸事件应由EditText优先处理，父容器不应进行拦截。这样做的好处是，在用户刚刚开始触摸EditText区域时，就能够确保触摸事件能够顺利传递到EditText，为后续可能的文本输入或内部滚动操作做好准备。
ACTION_MOVE 阶段：在触摸事件的移动阶段，即ACTION_MOVE事件发生时，需要根据EditText的实际滚动状态来动态决定是否继续请求父容器不拦截触摸事件。通过调用canVerticalScroll方法来判断EditText是否可以竖直滚动。如果EditText可以滚动，说明用户的意图可能是在EditText内部进行滚动操作，此时继续调用getParent().requestDisallowInterceptTouchEvent(true)，以保证触摸事件持续由EditText处理，实现EditText内部的正常滚动。反之，如果EditText不能滚动，这意味着用户的操作可能是希望触发父容器NestedScrollView的滚动，此时调用getParent().requestDisallowInterceptTouchEvent(false)，允许父容器拦截触摸事件并进行相应的滚动处理。
ACTION_UP 阶段：当触摸事件结束，也就是接收到ACTION_UP事件时，调用getParent().requestDisallowInterceptTouchEvent(false) 。这一操作是将触摸事件的控制权交还给父容器NestedScrollView，使得父容器在后续的触摸事件中能够正常进行事件拦截和处理。这样，当用户完成在EditText上的操作（如输入文本或滚动查看文本）并抬起手指后，NestedScrollView可以恢复对触摸事件的正常处理逻辑，例如响应其他区域的滚动操作。
4.2 滚动状态判断

准确判断EditText的滚动状态是实现滑动冲突解决方案的另一个重要方面。通过一系列的计算和判断，我们能够确定EditText当前是否可以滚动，以及滚动的方向和范围。这为合理地分发触摸事件提供了重要依据。具体实现步骤如下：
通过 canScrollVertically 方法判断滚动方向：Android 提供了canScrollVertically方法来判断一个视图是否可以在竖直方向上滚动。在我们的场景中，通过调用editText.canScrollVertically(1)来判断EditText是否可以向下滚动，调用editText.canScrollVertically(-1)来判断是否可以向上滚动。这里的参数1和-1分别表示向下和向上的滚动方向。通过这种方式，我们能够准确地获取EditText在不同方向上的滚动能力。
计算内容总高度与可见区域的差值：为了更精确地判断EditText的滚动状态，需要计算其内容总高度与可见区域的差值。通过editText.getLayout().getHeight()获取EditText内容的总高度，通过editText.getHeight() - editText.getCompoundPaddingTop() - editText.getCompoundPaddingBottom()计算出EditText实际显示的高度。然后，用内容总高度减去实际显示高度，得到两者的差值scrollDifference 。这个差值能够反映出EditText中超出可见区域的文本高度，对于判断是否可以滚动以及滚动的范围具有重要意义。
动态调整事件分发策略：根据上述计算和判断的结果，动态调整触摸事件的分发策略。如果EditText可以滚动（即scrollDifference != 0且当前滚动位置满足scrollY > 0 || scrollY < scrollDifference - 1），则请求父容器不拦截触摸事件，确保EditText能够处理滚动事件。如果EditText不能滚动（即scrollDifference == 0或当前滚动位置不满足上述条件），则允许父容器拦截触摸事件，让NestedScrollView来处理滚动操作。这样，通过动态地调整事件分发策略，能够根据EditText的实际滚动状态，合理地分配触摸事件的处理权，从而有效地解决滑动冲突问题。
五、优化与扩展

5.1 处理横向滚动

在某些场景下，可能需要EditText支持横向滚动，特别是当输入的文本包含较长的单词或代码段时。要实现横向滚动，可以在自定义EditText中添加对横向滚动的支持。
```
public class NonInterceptingEditText extends AppCompatEditText {
    // 省略其他代码...

    public NonInterceptingEditText(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        // 启用滚动功能
        setMovementMethod(ScrollingMovementMethod.getInstance());
        // 启用横向滚动
        setHorizontallyScrolling(true);
        // 设置文本不换行
        setSingleLine(true);
    }

    // 省略其他代码...
}
```
通过在构造函数中添加setHorizontallyScrolling(true)和setSingleLine(true)，可以确保EditText在内容超出宽度时进行横向滚动，而不是换行显示。这样，用户在输入长文本时，可以通过横向滑动来查看全部内容。

5.2 限制滑动范围

有时候，我们可能希望对EditText或NestedScrollView的滑动范围进行限制，以满足特定的业务需求。例如，在一个包含固定头部和底部的布局中，我们可能希望NestedScrollView只能在中间部分进行滚动。为了实现这一功能，可以通过重写NestedScrollView的onOverScrolled方法来实现对滑动范围的限制。

public class LimitedScrollView extends NestedScrollView {
    private int maxScrollY;

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

    @Override
    protected void onOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY) {
        // 确保scrollY不超过最大滚动范围
        if (scrollY > maxScrollY) {
            scrollY = maxScrollY;
        } else if (scrollY < 0) {
            scrollY = 0;
        }
        super.onOverScrolled(scrollX, scrollY, clampedX, clampedY);
    }

    public void setMaxScrollY(int maxScrollY) {
        this.maxScrollY = maxScrollY;
    }
}

在布局文件中使用LimitedScrollView，并在代码中设置最大滚动范围：

<com.example.LimitedScrollView
    android:id="@+id/limitedScrollView"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 布局内容 -->

</com.example.LimitedScrollView>

LimitedScrollView limitedScrollView = findViewById(R.id.limitedScrollView);
// 根据布局计算最大滚动范围
int maxScrollY = calculateMaxScrollY(); 
limitedScrollView.setMaxScrollY(maxScrollY);

通过这种方式，可以有效地限制NestedScrollView的滑动范围，使其在指定的区域内进行滚动。

5.3 兼容不同设备

在不同的设备上，由于屏幕尺寸、分辨率和屏幕密度的差异，触摸事件的处理可能会有所不同。为了确保在各种设备上都能获得一致的滑动体验，我们可以使用ViewConfiguration.getScaledTouchSlop()方法来获取系统触摸阈值，并根据该阈值来处理触摸事件

private int touchSlop;

public NonInterceptingEditText(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
    // 启用滚动功能
    setMovementMethod(ScrollingMovementMethod.getInstance());
    // 获取系统触摸阈值
    touchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
}

@Override
public boolean onTouchEvent(MotionEvent event) {
    int action = event.getActionMasked();
    switch (action) {
        case MotionEvent.ACTION_DOWN:
            // 当触摸事件开始时，记录触摸点位置
            downX = event.getX();
            downY = event.getY();
            getParent().requestDisallowInterceptTouchEvent(true);
            break;
        case MotionEvent.ACTION_MOVE:
            float moveX = event.getX();
            float moveY = event.getY();
            // 计算滑动距离
            float dx = moveX - downX;
            float dy = moveY - downY;
            // 根据滑动距离和触摸阈值判断是否开始滑动
            if (Math.abs(dy) > touchSlop) {
                if (canVerticalScroll(this)) {
                    getParent().requestDisallowInterceptTouchEvent(true);
                } else {
                    getParent().requestDisallowInterceptTouchEvent(false);
                }
            }
            break;
        case MotionEvent.ACTION_UP:
        case MotionEvent.ACTION_CANCEL:
            getParent().requestDisallowInterceptTouchEvent(false);
            break;
    }
    return super.onTouchEvent(event);
}

通过获取系统触摸阈值，并在触摸事件处理中根据该阈值判断是否开始滑动，可以更好地兼容不同设备，提高应用的稳定性和用户体验。此外，在处理不同屏幕密度下的适配问题时，除了使用dp和sp作为单位来定义布局和字体大小外，还可以根据屏幕密度加载不同尺寸的图片资源。在res目录下创建drawable-ldpi、drawable-mdpi、drawable-hdpi、drawable-xhdpi、drawable-xxhdpi等文件夹，并将不同分辨率的图片放置在相应的文件夹中。系统会根据设备的屏幕密度自动加载合适的图片，从而确保在不同屏幕密度的设备上都能获得清晰、合适的图片显示效果。

六、注意事项

在处理EditText与NestedScrollView滑动冲突问题时，除了实现有效的解决方案，还需要注意一些细节，以确保应用的稳定性和用户体验。

6.1 EditText 属性设置

必须设置 android:maxLines 或 android:minLines：为了确保EditText在显示多行文本时能够正确处理内容显示和滚动，必须设置android:maxLines或android:minLines属性。如果不设置这些属性，当EditText的内容超出其初始高度时，可能会出现显示异常或滚动行为不稳定的情况。例如，在一个聊天应用的消息输入框中，如果不设置maxLines，当用户输入较长的消息时，输入框可能会无限制地扩展，导致布局混乱。通过设置android:maxLines=\"5\"，可以限制输入框最多显示 5 行文本，超出部分可以通过滚动查看。
避免同时使用 singleLine 和 multiLine 属性：singleLine和multiLine属性是互斥的，同时使用会导致输入行为异常。singleLine属性用于将EditText设置为单行输入模式，而multiLine属性用于设置多行输入模式。如果同时设置这两个属性，系统可能无法正确处理输入逻辑，导致用户无法正常输入或查看多行文本。因此，在设计布局时，应根据实际需求明确选择其中一个属性。
合理设置 android:inputType：根据输入内容的类型，合理设置android:inputType属性，以调用合适的软键盘。例如，对于电话号码输入，应设置android:inputType=\"phone\"，这样系统会弹出适合输入电话号码的数字键盘，方便用户输入。如果输入类型设置不当，可能会给用户带来不便，影响输入效率。例如，将密码输入框的inputType设置为普通文本类型，会导致软键盘无法提供密码隐藏和特殊符号输入等功能，降低了密码输入的安全性和便捷性。
6.2 软键盘适配
设置 windowSoftInputMode：在 AndroidManifest.xml 中，通过设置windowSoftInputMode属性，可以控制软键盘弹出时的行为。例如，android:windowSoftInputMode=\"adjustResize\"可以使布局在软键盘弹出时自动调整大小，避免遮挡EditText 。在一个包含登录表单的页面中，当用户点击用户名或密码输入框时，软键盘弹出，如果不设置adjustResize，软键盘可能会遮挡住部分表单内容，用户无法正常操作。而设置了该属性后，布局会自动向上调整，确保输入框始终可见。
监听软键盘状态：在某些情况下，需要监听软键盘的弹出和隐藏状态，以便进行相应的操作。可以通过ViewTreeObserver.OnGlobalLayoutListener来监听布局变化，从而判断软键盘的状态。当软键盘弹出时，布局的高度会发生变化，通过比较布局变化前后的高度，可以确定软键盘是否弹出。在一个聊天界面中，当软键盘弹出时，需要将聊天输入框自动调整到合适的位置，通过监听软键盘状态，可以实现这一功能。
6.3 内存泄漏防范
避免在匿名内部类中持有 Activity 引用：在处理触摸事件或其他操作时，避免在匿名内部类中持有Activity的引用，以免导致内存泄漏。匿名内部类会隐式地持有外部类（通常是Activity）的引用，如果在Activity销毁后，匿名内部类仍然存活，就会导致Activity无法被垃圾回收，从而造成内存泄漏。例如，在为EditText设置触摸监听器时，应避免在匿名内部类中直接访问Activity的成员变量或方法。可以使用静态内部类或弱引用（WeakReference）来解决这个问题。
及时注销触摸监听器：在Activity销毁时，及时注销EditText的触摸监听器，以防止内存泄漏。如果触摸监听器没有被正确注销，它可能会继续持有EditText和Activity的引用，导致内存泄漏。在Activity的onDestroy方法中，将触摸监听器设置为null，可以确保在Activity销毁后，相关资源能够被正确释放。
七、总结

通过自定义控件或触摸监听两种方式，我们可以有效解决 EditText 与 NestedScrollView 的滑动冲突问题。核心在于通过事件分发机制实现滚动优先级控制，根据内容状态动态调整父容器的拦截行为。在实际开发中，应根据具体场景选择合适的实现方式，并注意兼容性和性能优化。