Android View背景属性失效，默认波纹效果无法实现求助

嘿，我帮你梳理下Android默认波纹效果失效的常见问题和解决办法，你可以对照排查下：

1. 目标View未设置可点击属性 #

默认波纹效果只有在View可点击时才会触发，像TextView这类控件默认是不可点击的，必须手动添加：

android:clickable="true"

如果是Button这类默认可点击的控件，这一步可以跳过，但如果你覆盖了它的背景，还是需要额外处理。

2. 自定义背景覆盖了系统波纹 #

如果你给View设置了普通的android:background（比如纯色、图片或者自定义selector），会直接覆盖掉系统自带的波纹背景。这时候应该用系统提供的波纹属性作为背景：

• ?attr/selectableItemBackground：带边界的波纹，波纹范围严格限制在View内部，适合大多数常规控件
• ?attr/selectableItemBackgroundBorderless：无边界波纹，会超出View范围扩散，适合圆形按钮、小图标这类控件

示例用法：

android:background="?attr/selectableItemBackground"

3. 主题或属性冲突 #

波纹效果依赖Material设计主题，如果你的App主题没有继承自Material相关主题（比如Theme.MaterialComponents.DayNight、Theme.AppCompat.Light），可能会导致波纹无法正常显示。另外，要确保View的focusable属性没有被错误设置为false（如果需要通过键盘触发波纹，还需设置android:focusableInTouchMode="true"）。

完整可运行的布局示例 #

给你一个包含两种波纹效果的完整布局，你可以直接参考：

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

    <!-- 带边界的波纹TextView -->
    <TextView
        android:id="@+id/tv_ripple_normal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="点击查看带边界波纹"
        android:padding="12dp"
        android:clickable="true"
        android:background="?attr/selectableItemBackground"/>

    <!-- 无边界的波纹容器 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="80dp"
        android:layout_marginTop="16dp"
        android:clickable="true"
        android:background="?attr/selectableItemBackgroundBorderless"
        android:gravity="center">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="点击查看无边界波纹"/>
    </LinearLayout>
</LinearLayout>

低版本兼容提示 #

如果你的App需要兼容Android 5.0（API 21）以下版本，需要在res/drawable-v21目录下创建自定义波纹drawable，低版本则用普通的颜色selector替代，避免在低版本上出现异常。

内容的提问来源于stack exchange，提问作者user8965395