在移动端界面开发中，按钮背景常常需要根据品牌规范与交互状态进行深度定制。使用XML模板来定义按钮背景，不仅可以把样式与逻辑解耦，还能在不同分辨率与系统主题下保持一致性。通过编写drawable资源文件，我们可以用声明式的方式描述圆角、渐变、边框以及按下、选中等状态变化。
一、使用shape定义基础按钮背景
最基础的自定义背景是用<shape>标签描述一个纯色或渐变圆角矩形。shape支持rectangle、oval、line、ring四种类型，其中rectangle最常用于按钮。我们可以在res/drawable目录下新建一个XML文件，通过solid指定填充色，corners指定圆角半径，stroke指定边框。
下面的示例定义了一个蓝色圆角矩形背景，圆角半径为八dp，同时带一点浅色边框。这种写法比在代码里调用GradientDrawable更直观，也方便设计师直接修改数值。注意dp单位在drawable中必须显式声明，否则系统会按像素处理导致不同屏幕表现不一致。
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<solid android:color="#3F8CFF" />
<corners android:radius="8dp" />
<stroke
android:width="1dp"
android:color="#DDDDDD" />
</shape>
渐变背景的写法
如果希望按钮更有层次感，可以把solid替换为gradient。gradient支持线性、放射与扫描三种类型，通过angle控制线性渐变方向，startColor、centerColor、endColor控制色彩过渡。例如从顶部浅蓝到底部深蓝的纵向渐变，只需设置angle为90。
渐变在视觉上能提升按钮的立体感，但也要注意对比度，避免文字看不清。建议在渐变两端色彩明度差控制在二十 percent 以内，并保证与上方文字颜色形成足够反差。
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<gradient
android:angle="90"
android:startColor="#6FB1FF"
android:endColor="#3F8CFF" />
<corners android:radius="8dp" />
</shape>
二、用selector实现多状态背景切换
按钮并非静止元素，用户按下、获取焦点、禁用时都需要不同反馈。selector标签允许我们为不同状态指定不同drawable，系统会自动根据当前状态切换。常见状态有pressed、focused、enabled、selected等，顺序上应将更具体的状态写在前面。
实践中，我们常把普通状态与按下状态分别写成两个shape，再在selector中引用。这样既能复用形状定义，又便于单独调整按压色。下面例子展示了正常蓝色、按下深蓝、禁用灰的三态背景。
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:state_enabled="false">
<shape android:shape="rectangle">
<solid android:color="#CCCCCC" />
<corners android:radius="8dp" />
</shape>
</item>
<item android:state_pressed="true">
<shape android:shape="rectangle">
<solid android:color="#2A6FD6" />
<corners android:radius="8dp" />
</shape>
</item>
<item>
<shape android:shape="rectangle">
<solid android:color="#3F8CFF" />
<corners android:radius="8dp" />
</shape>
</item>
</selector>
状态顺序与默认项
selector的匹配规则和CSS类似，从上往下找到第一个满足条件的item就生效。因此如果把默认项放在最前，后面的pressed等状态永远无法触发。务必把带状态属性的item写在前面，最后留一个不带任何state的item作为兜底。
另外enabled为false的禁用态也应提前，否则某些控件在不可用时仍会响应pressed。合理排序能减少运行时样式异常的排查时间。
三、layer-list组合复杂背景
当按钮需要同时拥有阴影、底色与顶部高光时，单一shape难以表达。layer-list可以把多个drawable按层级堆叠，类似Photoshop的图层。每个item通过inset调整偏移，实现阴影或边框效果。
以下示例用layer-list模拟底部阴影：第一层是偏移后的灰色圆角矩形，第二层是正常蓝色圆角矩形。这种写法比引入图片资源更轻量，且能随按钮尺寸自适应。
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<item android:top="2dp" android:left="0dp" android:right="0dp" android:bottom="0dp">
<shape android:shape="rectangle">
<solid android:color="#20000000" />
<corners android:radius="8dp" />
</shape>
</item>
<item android:bottom="2dp">
<shape android:shape="rectangle">
<solid android:color="#3F8CFF" />
<corners android:radius="8dp" />
</shape>
</item>
</layer-list>
与selector嵌套使用
layer-list本身也可作为selector的某个状态项。比如按下时切换为带阴影的layer-list，正常时只用简单shape，这样按钮按压更有下沉感。嵌套时注意缩进与闭合标签，避免XML解析错误。
在复杂业务中，建议将基础形状抽取为单独文件，再用selector与layer-list组合引用，降低重复代码量，也方便全局替换主题色。
四、在布局中引用与代码动态切换
定义好的XML背景可直接在布局文件里通过background属性引用。如果需要在Java或Kotlin中动态更换，可调用setBackgroundResource方法传入资源ID。动态切换适用于夜间模式或用户自定义主题场景。
需要注意，直接设置背景会覆盖系统默认的水波纹效果。若想保留触摸反馈，可在selector中搭配ripple标签（API 21以上），或在外层包裹foreground实现兼容。
<Button
android:id="@+id/btn_submit"
android:layout_width="match_parent"
android:layout_height="48dp"
android:text="提交"
android:background="@drawable/bg_btn_normal" />
Button btn = findViewById(R.id.btn_submit); // 根据主题切换背景 btn.setBackgroundResource(R.drawable.bg_btn_dark);
常见误区与优化建议
不少开发者把背景XML写成固定像素尺寸，导致在大屏设备上按钮被拉伸模糊。应始终坚持使用dp与shape矢量描述，避免引入位图。另外，selector中若遗漏默认项，按钮在初始化可能无背景，需在测试阶段覆盖所有状态。
性能方面，XML drawable在编译期生成，运行期开销极低。但过度嵌套layer-list会增加绘制层数，建议控制在三层以内。对于极高频变化的按钮，可考虑用自定义View直接绘制以减少中间对象创建。
XML模板自定义按钮背景Android_drawable修改时间：2026-08-07 18:18:40