本文详解如何在 android 中使用 material design 组件正确实现带阴影、圆角背景及密码可见切换功能的自定义 edittext，解决 textinputlayout 内嵌 textinputedittext 时因背景覆盖导致阴影/边框失效的问题。
在 Android 开发中，许多开发者希望为密码输入框添加视觉增强效果——例如柔和阴影、大圆角背景以及可切换的密码明文显示功能。但直接在 TextInputLayout 中为 TextInputEditText 设置自定义背景（如 @drawable/edittext_background）会导致 Material 组件默认的轮廓边框（OutlinedBox）和阴影被遮盖，尤其当启用 app:endIconMode="password_toggle" 时，TextInputLayout 的内部绘制逻辑会与自定义背景冲突，最终呈现为“无阴影、无圆角、边框断裂”的错误效果（如问题中第二张图所示）。
根本原因：TextInputLayout 的 OutlinedBox 样式依赖其自身绘制的描边与内边距，若子 TextInputEditText 设置了非透明背景（尤其是带 padding 或 shape 的 drawable），将完全覆盖父容器的视觉层，导致阴影（elevation）、轮廓线、焦点动画等 Material 特性失效。
✅ 推荐解决方案：改用 CardView + 原生 EditText 实现高度可控的自定义外观
CardView 天然支持 cardElevation（阴影）、cardCornerRadius（圆角）和 cardBackgroundColor（背景色），且不干扰 EditText 的输入行为与密码切换逻辑。配合手动添加密码可见图标，即可完美替代 TextInputLayout 的受限方案：
YZTurboWebAndroid 高性能 Android WebView 容器 SDK 接入。用于在 Android 项目中集成 WebView 容器，实现： (1) WebView 预加载与复用，提升 H5 页面加载速度 (2) 离线包管理，拦截请求优先命中本地资源 (3) JS Bridge 双向通信，Na...
<androidx.cardview.widget.CardView
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:cardCornerRadius="25dp"
app:cardElevation="8dp"
app:cardBackgroundColor="#1E1E1E"
app:cardUseCompatPadding="true"
android:layout_marginStart="50dp"
android:layout_marginEnd="42dp"
android:layout_marginTop="10dp">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:gravity="center_vertical">
<EditText
android:id="@+id/editTextPassword"
android:layout_width="0dp"
android:layout_height="50dp"
android:layout_weight="1"
android:background="@null" <!-- 关键：禁用默认背景，避免遮挡 -->
android:paddingHorizontal="16dp"
android:paddingStart="24dp"
android:inputType="textPassword"
android:textColor="@android:color/white"
android:textColorHint="@color/textHint"
android:hint="@string/password"
android:fontFamily="sans-serif"
android:textSize="16sp" />
<ImageButton
android:id="@+id/btnTogglePassword"
android:layout_width="48dp"
android:layout_height="48dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:src="@drawable/ic_eye_off"
android:tint="@color/textHint"
android:contentDescription="@string/action_toggle_password_visibility"
android:layout_marginEnd="12dp" />
</LinearLayout>
</androidx.cardview.widget.CardView>? 关键要点说明：
- android:background="@null" 必须设置在 EditText 上，确保 CardView 的圆角与阴影完整透出；
- 使用 LinearLayout 包裹 EditText + ImageButton 可灵活控制图标位置与点击区域；
- 密码切换逻辑需在 Kotlin/Java 中手动实现（监听 btnTogglePassword 点击，切换 inputType 并更新图标）；
- app:cardUseCompatPadding="true" 可避免阴影被裁剪（尤其在 API < 21 时）；
- 若需保持 Material 主题一致性，可将 CardView 的 cardBackgroundColor 替换为 ?attr/colorSurface。
⚠️ 注意：TextInputLayout 仍是表单验证、浮动提示、错误信息展示的首选组件；本方案适用于纯视觉定制优先、无需内置验证/错误提示的场景。如需两者兼顾，建议通过自定义 TextInputLayout 子类或 MaterialTheme 覆盖 shapeAppearanceOverlay 属性实现深度定制，而非硬设 EditText 背景。
通过 CardView 方案，你将获得稳定、可复用、符合设计规范的密码输入体验——阴影清晰、圆角自然、图标响应灵敏，且完全兼容深色模式与动态主题切换。
