在Android的drawable资源定义中，通过shape标签的gradient子标签可以配置渐变效果，径向渐变是常用的渐变类型之一，centerX属性用于控制径向渐变中心点相对于图形X轴的偏移比例，能够灵活调整渐变的起始位置。
centerX属性的基本说明
centerX是gradient标签的一个可选属性，仅在渐变类型设置为径向渐变（android:type="radial"）时生效，它用来定义径向渐变中心点在X轴方向的坐标比例，默认值为0.5，代表中心点水平居中。
属性取值规则
- 取值为浮点数，范围是0到1之间
- 0代表中心点位于图形的最左侧
- 1代表中心点位于图形的最右侧
- 0.5代表中心点位于图形的水平正中间
- 取值可以大于1或者小于0，此时中心点会超出图形本身的边界，渐变效果会按照超出后的位置计算
配套必填属性
使用centerX属性时，必须同时配置以下属性，否则径向渐变无法正常生效：
- android:type：必须设置为radial，指定渐变类型为径向渐变
- android:gradientRadius：必须设置径向渐变的半径，单位可以是dp或者像素，也可以用百分比形式
完整XML配置示例
以下是一个完整的shape径向渐变配置示例，通过centerX调整中心X位置：
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<!-- 设置大小为100dp*100dp方便观察效果 -->
<size
android:width="100dp"
android:height="100dp" />
<gradient
android:type="radial"
android:startColor="#FF0000"
android:endColor="#0000FF"
android:gradientRadius="50dp"
android:centerX="0.3" />
</shape>
上述配置中，centerX设置为0.3，代表径向渐变的中心点位于图形水平方向30%的位置，渐变会从该点向四周扩散，半径是50dp。
不同centerX取值的效果对比
我们可以通过调整centerX的值观察渐变效果的变化，以下是不同取值的效果说明：
| centerX取值 | 效果描述 |
|---|---|
| 0 | 径向渐变中心点位于图形最左侧，红色起始点出现在最左边 |
| 0.5 | 径向渐变中心点水平居中，渐变从正中间向四周扩散 |
| 1 | 径向渐变中心点位于图形最右侧，红色起始点出现在最右边 |
| 1.5 | 径向渐变中心点超出图形右侧边界，渐变效果会按照超出后的位置计算，图形内只能看到渐变的一部分 |
常见使用场景
- 需要实现偏左或者偏右的径向高光效果时，可以调整centerX的值让高光点偏移
- 模拟光源从侧面照射的渐变效果时，配合centerY属性调整中心位置
- 实现不规则位置的渐变背景时，通过centerX和centerY组合调整中心点
注意事项
如果同时设置了android:centerX和android:centerY，两个属性会共同决定径向渐变的中心点位置，缺少任何一个都不会影响另一个属性的生效。另外gradientRadius的取值如果过小，可能会导致渐变还没扩散到图形边缘就已经结束，此时可以调大半径值让渐变覆盖整个图形。
当需要在代码中动态修改centerX的值时，可以通过获取GradientDrawable对象后调用对应的方法实现，不过XML配置是更常用的静态定义方式，适合大多数固定渐变需求的场景。
Android_shapegradient_centerXXML_radial_gradientAndroid_drawable修改时间：2026-06-16 17:30:32