概述Elevation Overlay高度叠加层是 Material Design 3M3中用于表现界面元素空间层级的核心视觉机制。它通过动态改变表面颜色而非仅依赖阴影来体现不同高度的视觉差异解决了在不同背景下阴影辨识度不高的问题。产生背景在 Material Design 2M2中视觉层级主要通过阴影来表现。但存在以下局限深色模式下阴影不明显深色背景中的阴影对比度低难以清晰感知高度差异纯静态阴影无法体现场景差异在浅色或深色背景下相同高度的视觉感受应当不同缺乏颜色语义无法通过颜色快速感知元素的突出程度Material Design 3 引入动态表面着色机制通过主色叠加的方式强化高度感知。核心原理1. 绝对高度Absolute Elevation计算高度叠加层的触发基于绝对高度而非单个视图的elevation属性。绝对高度 视图自身 elevation 所有父级容器的 elevation 累加实际案例分析本项目中的现象本项目中出现的#F3E8FF现象正是由于这一点Activity 中卡片正常MaterialCardView直接在普通 Activity 根视图中父级 elevation 为 0绝对高度 0dp → 无叠加BottomSheet 中卡片偏紫BottomSheetDialog自身带有约 8dp 的基础高度虽然卡片自身设置了app:cardElevation0dp但绝对高度 0 8 8dp → 触发叠加2. 混合公式当绝对高度 0 时系统会自动将主题主色colorPrimary叠加到表面色colorSurface上最终颜色 主色 × 不透明度 表面色 × (1 - 不透明度)不透明度与绝对高度正相关绝对高度主色叠加 Alpha1dp~5%3dp~7%8dp~9%16dp~11%24dp~12%3. 颜色推演本项目中颜色变换的数学计算主色colorPrimary#4F46E5深紫色表面色colorSurface#FFFFFF纯白叠加 Alpha约 8%R: 255 × (1-0.08) 79 × 0.08 ≈ 243 G: 255 × (1-0.08) 70 × 0.08 ≈ 232 B: 255 × (1-0.08) 229 × 0.08 ≈ 255最终得到#F3E8FF即本项目中 BottomSheet 里卡片出现的浅紫色。控制机制全局开关在主题中全局关闭高度叠加不推荐会破坏 M3 整体视觉语言stylenameBase.Theme.MyPotatoparentTheme.Material3.Light.NoActionBar!-- ... 其他配置 ... -- item nameelevationOverlayEnabledfalse/item/style局部 Theme Overlay推荐方案针对特定组件局部关闭保留全局设计规范!-- res/values/themes.xml --stylenameThemeOverlay.MyPotato.CardNoTintparentitem nameelevationOverlayEnabledfalse/item/style在布局中应用com.google.android.material.card.MaterialCardViewandroid:themestyle/ThemeOverlay.MyPotato.CardNoTintapp:cardBackgroundColor?attr/colorSurface.../直接设置固定颜色直接通过cardBackgroundColor设置具体色值而非主题属性也可绕过叠加但会影响深色模式适配!-- 不推荐硬编码颜色会破坏主题一致性 --app:cardBackgroundColorcolor/card_bg_white技术架构1. MaterialShapeDrawable核心渲染类负责处理形状裁剪边框绘制高度叠加色计算与混合阴影生成2. ElevationOverlayProvider负责根据绝对高度计算叠加色的接口。默认实现MaterialElevationOverlayProvider中// 核心逻辑伪代码funcompositeOverlayIfNeeded(backgroundColor:Color,absoluteElevation:Float):Color{if(!elevationOverlayEnabled){returnbackgroundColor}valoverlayAlphacalculateOverlayAlpha(absoluteElevation)valoverlayColoroverlayColor.withAlpha(overlayAlpha)returnblendColors(overlayColor,backgroundColor)}3. 父级高度累加链MaterialCardView在绘制时会向上遍历父视图树累加所有祖先的elevationMaterialCardView (0dp) ↓ FrameLayout (BottomSheet 内部容器2dp) ↓ BottomSheetDialog 根容器 (6dp) ↓ 总体0 2 6 8dp常见问题与解决方案Q1: BottomSheet 中的卡片背景为什么会变色A: BottomSheet 容器自身带有 elevation导致卡片绝对高度 0。解决: 为卡片应用elevationOverlayEnabledfalse的 Theme Overlay。Q2: 为什么不同设备上叠加程度看起来不一样A: 叠加系数受以下因素影响主题的elevationOverlayColor默认是colorPrimary当前系统是否开启强制深色或其他辅助功能Material Components 库版本Q3: 如何自定义叠加色而不是用 colorPrimaryA: 在主题中覆盖elevationOverlayColoritemnameelevationOverlayColorcolor/my_custom_overlay/item项目中的应用在MyPotato项目中我们采用局部 Theme Overlay 的方案文件变更res/values/themes.xml新增ThemeOverlay.MyPotato.CardNoTintres/layout/bottom_sheet_add_task_placeholder.xml应用主题覆盖res/layout/activity_task_detail.xml应用主题覆盖保持一致性效果BottomSheet 中的长任务步骤卡片现在保持纯白背景不影响其他组件的 Material Design 3 标准视觉效果代码符合 Android 资源隔离规范参考资料Material Design 3 官方文档 - ElevationMaterial Components Android - Elevation OverlayMaterialShapeDrawable 源码