Android: gradient 使用

在 Android 中使用 gradient（渐变） 通常是通过 drawable 文件来设置背景。下面是可以直接用的几种用法汇总，包括线性渐变、径向渐变、扫描渐变（sweep）等：

---

✅ 1. Linear Gradient（线性渐变）

<!-- res/drawable/bg_gradient_linear.xml -->
<gradient xmlns:android="http://schemas.android.com/apk/res/android"android:type="linear"android:startColor="#FF512F"android:endColor="#DD2476"android:angle="45" />

🔹 angle 取值范围：0~360，表示渐变方向（0 为从上往下，90 为从左往右）。

---

✅ 2. Radial Gradient（径向渐变）

<!-- res/drawable/bg_gradient_radial.xml -->
<gradient xmlns:android="http://schemas.android.com/apk/res/android"android:type="radial"android:centerX="0.5"android:centerY="0.5"android:gradientRadius="200"android:startColor="#FF512F"android:endColor="#DD2476" />

🔹 centerX/Y: 百分比（0.5 表示中心）
🔹 gradientRadius: 渐变半径，单位为 px

---

✅ 3. Sweep Gradient（扫描渐变）

<!-- res/drawable/bg_gradient_sweep.xml -->
<gradient xmlns:android="http://schemas.android.com/apk/res/android"android:type="sweep"android:centerX="0.5"android:centerY="0.5"android:startColor="#FF512F"android:endColor="#DD2476" />

---

✅ 4. 多色渐变

<gradient xmlns:android="http://schemas.android.com/apk/res/android"android:type="linear"android:startColor="#FF512F"android:centerColor="#F09819"android:endColor="#DD2476"android:angle="90" />

---

✅ 5. 设置背景到 View

android:background="@drawable/bg_gradient_linear"

---

✅ 6. 代码中创建 GradientDrawable

val gradient = GradientDrawable(GradientDrawable.Orientation.LEFT_RIGHT,intArrayOf(Color.RED, Color.BLUE)
)
gradient.cornerRadius = 20f
yourView.background = gradient

---

✅ 7. 圆角 + 渐变（常用）

<shape xmlns:android="http://schemas.android.com/apk/res/android"android:shape="rectangle"><corners android:radius="16dp"/><gradientandroid:type="linear"android:startColor="#FF512F"android:endColor="#DD2476"android:angle="90"/>
</shape>

---

android:angle 方向图解

在 Android 的 gradient 中使用 android:angle 属性时，它控制渐变的方向。它的单位是角度，**以“从左到右顺时针旋转”**为标准。

---

✅ android:angle 方向图解（基于 type="linear"）

angle	渐变方向	说明（startColor ➜ endColor）
0	从左 ➜ 右	左边是 startColor，右边是 endColor
45	从左下 ➜ 右上	斜向上渐变
90	从下 ➜ 上	下边是 startColor，上边是 endColor
135	从右下 ➜ 左上	斜向上渐变
180	从右 ➜ 左	右边是 startColor，左边是 endColor
225	从右上 ➜ 左下	斜向下渐变
270	从上 ➜ 下	上边是 startColor，下边是 endColor
315	从左上 ➜ 右下	斜向下渐变

---

✅ 举例说明：

<gradientandroid:startColor="#FF0000"android:endColor="#0000FF"android:angle="90"/>

上面是 从下往上 渐变（即底部是红色，顶部是蓝色），不是从左到右！这也是 Android 和 CSS 的一个差异点，容易混淆。

---

❗注意：

• angle 必须是 45 的整数倍，否则会被忽略或默认处理。
• angle 的值是 顺时针旋转角度，从 0 度（从左 ➜ 右）开始。

---

0：从左到右
45：从左下到右上
90：从下到上
135：从右下到左上
180：从右到左
225：从右上到左下
270：从上到下
315：从左上到右下

✅

图示参考：

          ↑270°  ↑  90°
← 180° ←     → 0° →↓

🌟 注意：这个角度是 Android 中 定义渐变方向用的逻辑值，不是数学角度的坐标方向。

---

✅ 示例一：从左到右渐变

<gradientandroid:type="linear"android:startColor="#FF0000"android:endColor="#0000FF"android:angle="90"/>

🔸 颜色从左（红） → 右（蓝） 渐变。

---

✅ 示例二：从上到下渐变

<gradientandroid:type="linear"android:startColor="#00FF00"android:endColor="#000000"android:angle="0"/>

🔸 颜色从上（绿） → 下（黑） 渐变。

---

⚠️ 注意事项：

1. angle 只能是 45 的倍数（如 0、45、90、135…），否则 Android 会忽略。
2. 默认 angle 是 0，也就是 从上到下。
3. android:type="linear" 时，angle 才生效。
4. 对于 radial 和 sweep 类型，angle 不起作用。

---

三 radial 和 sweep的区别

---

🔵 radial（放射状渐变）

✅ 特点：

• 从中心向外发散。
• 渐变是圆形扩散的效果。
• 类似水波或聚光灯、光晕。

✅ 用法示例：

<gradientandroid:type="radial"android:startColor="#FF0000"android:endColor="#0000FF"android:centerX="0.5"android:centerY="0.5"android:gradientRadius="200"/>

✅ 参数说明：

• centerX / centerY：中心点位置（0~1，表示百分比）。
• gradientRadius：渐变的半径（必须设置）。
• angle 无效！

✅ 视觉示意：

  渐变像个圆圈扩散出去：R G B↓↓↓●●●●●●●●●●◎◎◎●●●●◎◎◎●●●●◎◎◎●●●●●●●●●●

---

🟣 sweep（扫描/扫描状渐变）

✅ 特点：

• 从中心点绕一圈旋转（360°）改变颜色。
• 类似时钟的指针旋转、雷达扫描。

✅ 用法示例：

<gradientandroid:type="sweep"android:startColor="#FF0000"android:endColor="#0000FF"android:centerX="0.5"android:centerY="0.5"/>

✅ 参数说明：

• centerX / centerY：设置渐变中心。
• 不支持 angle，方向是固定的：从 0° 顺时针到 360°。

✅ 视觉示意：

   色彩从中间绕一圈：红 → 橙 → 黄↑       ↓紫 ← 蓝 ← 绿

---

🔄 总结对比表：

类型	视觉效果	可设置角度	中心点	常用场景
linear	直线方向渐变	✅ 支持	❌	按钮、背景、边框线
radial	中心向外扩散	❌ 不支持	✅	光晕、聚光灯、圆形按钮
sweep	中心旋转渐变	❌ 不支持	✅	表盘、雷达、加载动画

---