layer-list 是 Android 中用于 XML 图层叠加的 drawable 容器,按声明顺序从下到上堆叠,支持 shape、color、bitmap 等类型,可通过 android:top/bottom/left/right 偏移和 gravity 精确定位各层,常用于圆角边框、角标、轻量阴影等场景。

Android 的 layer-list 是一种在 XML 中实现图层叠加的简单而强大的方式,常用于组合多个 drawable(如颜色、形状、图片)来构建复杂 UI 元素,比如带边框的圆角背景、带阴影的按钮、状态指示器等。
layer-list 基本结构和原理
layer-list 本质是一个“从下到上”的堆叠容器:XML 中靠前的 item 在底层,靠后的 item 在顶层(类似 PS 的图层顺序)。每个 可以是 shape、color、bitmap、selector 等任意 drawable 类型。
所有 item 默认铺满整个容器尺寸;可通过 android:top、android:bottom、android:left、android:right 设置偏移,实现错位或留白效果。
常见用法示例
1. 圆角背景 + 边框(最常用)
用两个 shape:底层是填充色(带圆角),上层是描边(同圆角,但 stroke 宽度 + 小尺寸偏移模拟“内边框”):
2. 图标 + 角标(Badge)
把一张图标(bitmap)和一个红色圆形(shape)叠加,用 android:gravity 和 android:top/right 定位角标:
3. 模拟阴影(轻量级)
用深色矩形偏移后置于底层,再叠加主内容,适合静态控件(注意:不如 elevation 或 MaterialCardView 灵活):
- 底层:黑色半透明矩形,向右下偏移
- 中层:稍浅的灰色矩形(进一步模糊感,可选)
- 顶层:实际内容(如白色圆角背景)
关键细节和注意事项
尺寸控制要统一:如果 layer-list 用作 View 背景,最终尺寸由最外层 item 决定(或由 View 自身宽高约束)。建议显式设置 或用 android:width/height 配合 android:gravity 精确布局。
gravity 影响定位逻辑:当 item 内部 drawable 尺寸小于容器时,android:gravity 控制其对齐方式(如 center、bottom|end),配合 top/bottom/left/right 可微调位置。
支持状态切换:可以把整个 layer-list 放进 selector 的不同 state 中,实现按压/禁用等视觉反馈(例如按压时改变某一层的颜色)。
调试小技巧
开发时可临时给每层加不同纯色(如 #FF0000、#00FF00、#0000FF),快速验证图层顺序和偏移是否符合预期。上线前再换回真实样式。
基本上就这些 —— 不复杂但容易忽略偏移和 gravity 的组合效果。多试几次,就能熟练做出各种实用复合背景。










