Android shape gradient type radial XML径向渐变怎么配置

Android的shape drawable是开发中常用的背景定义方式，其中gradient标签支持三种渐变类型，radial类型的径向渐变可以实现从中心向外扩散的颜色过渡效果，适合制作圆形高光、聚焦背景等场景。配置径向渐变时需要明确各个属性的含义，避免参数设置错误导致效果不符合预期。

径向渐变核心属性说明

在shape标签内部添加<gradient>子标签，将type属性设置为radial即可开启径向渐变，以下是径向渐变特有的核心属性：

• android:type：渐变类型，设置为radial表示径向渐变
• android:centerX：渐变中心的X坐标，取值可以是具体尺寸（如10dp）或者百分比（如50%），默认是50%
• android:centerY：渐变中心的Y坐标，取值规则同centerX，默认是50%
• android:gradientRadius：渐变的半径，必须设置该属性，否则会报错，取值可以是具体尺寸或者百分比
• android:startColor：渐变起始颜色，即中心点的颜色
• android:endColor：渐变结束颜色，即半径边缘的颜色
• android:centerColor：可选属性，渐变中间过渡颜色

基础径向渐变配置示例

以下是一个简单的径向渐变配置，实现从中心白色向边缘蓝色的过渡效果，渐变中心位于控件正中心，半径为控件宽度的一半：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <!-- 设置渐变类型为径向渐变 -->
    <gradient
        android:type="radial"
        android:centerX="50%"
        android:centerY="50%"
        android:gradientRadius="50%"
        android:startColor="#FFFFFF"
        android:endColor="#3F51B5" />
</shape>

自定义中心位置的径向渐变

如果需要将渐变中心调整到左上角，只需要修改centerX和centerY的取值即可，以下示例将中心设置在左上角10dp位置，半径为100dp：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <gradient
        android:type="radial"
        android:centerX="10dp"
        android:centerY="10dp"
        android:gradientRadius="100dp"
        android:startColor="#FF4081"
        android:centerColor="#FFEB3B"
        android:endColor="#4CAF50" />
</shape>

常见问题说明

gradientRadius必须设置

配置radial类型渐变时，如果没有设置android:gradientRadius属性，运行时会抛出IllegalArgumentException，提示radius must be specified for radial gradient，因此该属性是必填项。

shape形状对渐变的影响

虽然径向渐变本身是从中心向外扩散的圆形过渡，但如果外层shape的android:shape设置为rectangle，渐变会铺满整个矩形区域，超出半径的部分会显示endColor的颜色。如果需要圆形渐变背景，可以将shape的shape设置为oval，这样渐变会适配圆形边界。

百分比取值的参考对象

centerX、centerY、gradientRadius使用百分比取值时，参考对象是当前应用该drawable的控件的对应维度，比如gradientRadius设置为50%，表示半径是控件宽度或者高度中较小值的50%。

完整圆形径向渐变示例

以下是一个圆形背景的径向渐变配置，适合作为圆形按钮的高光背景：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <gradient
        android:type="radial"
        android:centerX="30%"
        android:centerY="30%"
        android:gradientRadius="70%"
        android:startColor="#80FFFFFF"
        android:endColor="#2196F3" />
</shape>

使用上述drawable作为View的背景时，会呈现左上角偏亮、向右下角渐变的蓝色圆形效果，符合常见的高光按钮视觉需求。

Android_shapegradient_radialxml_drawable径向渐变配置修改时间：2026-06-20 01:27:28