Android shape中solid color如何设置背景填充颜色

shape资源文件的基本创建方法

在Android项目里，想要给按钮、文本框或者整个布局设置一个纯色背景，最常用的方式就是通过shape资源文件来实现。shape属于drawable资源的一种，它的存放位置是res/drawable目录。如果项目里没有drawable目录，手动创建一个即可。右键点击drawable目录，选择New，再选择Drawable Resource File，填写文件名，根元素选择shape，这样就生成了一个基本的shape文件。

shape文件的根标签是shape，通过android:shape属性可以指定形状类型，可选值有rectangle矩形、oval椭圆、line线和ring环形。绝大多数背景场景下我们用的都是矩形。下面是一个最简单的纯色矩形背景示例：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <solid android:color="#FF5722" />
</shape>

写好这个文件后，假设文件名叫bg_orange.xml，就可以在布局文件中通过android:background="@drawable/bg_orange"引用它，也可以在代码中通过setBackgroundResource方法动态设置。这种方式比直接写一个颜色值的好处在于，后续要加圆角、描边、渐变时，只需要在同一个文件里扩展，不需要改动引用处。

solid标签的属性与颜色格式详解

solid标签就是用来做填充的，它只有一个核心属性android:color。这个颜色值支持多种格式写法，理解这些格式对日常开发很有帮助。最常见的是#RRGGBB六位十六进制格式，比如#FF5722表示一个橙色。如果需要指定透明度，可以使用#AARRGGBB八位格式，其中前两位AA是alpha通道，00代表完全透明，FF代表完全不透明。

举个例子，#80FF5722表示一个半透明的橙色，这种写法在做遮罩、半透明浮层背景时特别实用。除了十六进制，还可以直接引用colors资源文件中的颜色，写成android:color="@color/primary_color"，这样做便于统一管理主题色。另外部分场景下也支持@android:color/white这样的系统内置颜色引用。

<!-- 半透明黑色背景，alpha为50% -->
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="#80000000" />
</shape>

<!-- 引用资源文件中定义的颜色 -->
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="@color/color_primary" />
</shape>

需要注意的一个细节是，如果solid标签省略了android:color属性，或者整个solid标签都不写，那么shape默认是不填充的，也就是透明效果。有些开发者发现背景设置后不显示颜色，排查半天，结果发现是颜色值前面少了#号，这种情况在编译时不会报错，但运行时会出现资源解析异常，务必留意。

solid与corners、stroke组合出更丰富的样式

纯色填充往往需要搭配圆角和描边才符合实际的设计需求。corners标签用于设置圆角，android:radius统一设置四个角的圆角半径，也可以用topLeftRadius、topRightRadius、bottomLeftRadius、bottomRightRadius分别控制某个角。很多设计稿要求上圆角下直角的效果，比如列表头部卡片，就需要用到单独设置某个角的方式。

stroke标签用于设置描边，android:width是描边宽度，android:color是描边颜色，android:dashWidth和android:dashGap配合可以画出虚线边框。下面这个例子演示了一个常见的按钮背景：白色填充、灰色圆角边框：

<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <!-- 纯色填充 -->
    <solid android:color="#FFFFFF" />
    <!-- 描边：1dp宽的浅灰色实线 -->
    <stroke
        android:width="1dp"
        android:color="#E0E0E0" />
    <!-- 四个角均为8dp圆角 -->
    <corners android:radius="8dp" />
</shape>

这里有个容易忽略的坑：当solid填充色和stroke描边色相同，而控件又设置了padding时，视觉效果可能会和预期不符，因为shape的描边是绘制在控件边界内侧的。另外，如果同时写了solid和gradient渐变标签，后绘制的渐变会覆盖纯色填充，实际上solid就不生效了，两者不建议同时使用。

在代码中动态修改shape填充颜色

有些业务场景需要根据状态切换背景色，比如选中高亮、开关状态等。如果为每种颜色都写一个xml文件，文件数量会膨胀得很快。更灵活的方式是在代码中修改已有的shape背景颜色。shape对应的类是GradientDrawable，通过setBackgroundResource拿到背景后强转成GradientDrawable，再调用setColor方法即可。

TextView tvTag = findViewById(R.id.tv_tag);
// 获取shape背景并动态修改填充颜色
GradientDrawable drawable = (GradientDrawable) tvTag.getBackground();
drawable.setColor(Color.parseColor("#4CAF50"));

// 也可以从资源中获取
GradientDrawable bg = (GradientDrawable)
        ContextCompat.getDrawable(this, R.drawable.bg_orange);
bg.setColor(0x80000000); // 半透明黑色
tvTag.setBackground(bg);

使用这种方式时要注意一个问题：同一个drawable资源如果被多个View共享，修改其中一个的颜色会影响到所有引用该资源的View，这是Android资源共享机制导致的。解决办法是调用mutate方法让当前drawable拥有独立的状态，例如drawable.mutate().setColor(color)，这样就不会互相干扰了。如果项目已经迁移到Jetpack Compose，则可以直接用Modifier.background(color, RoundedCornerShape(8.dp))达到同样效果，更加简洁。

Android shapesolid color背景填充颜色修改时间：2026-09-06 11:29:25