<radialGradient>

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

<radialGradient> SVG 元素允许作者定义可以应用于图形元素的填充或描边的径向渐变。

注意:不要与 CSS 的 radial-gradient() 混淆,因为 CSS 渐变只能应用于 HTML 元素,而 SVG 渐变只能应用于 SVG 元素。

使用语境

分类渐变元素
允许内容可包含任意数量、任意顺序的下列元素
描述性元素
<animate>, <animateTransform>, <discard>, <script>, <set>, <stop>, <style>

属性

cx

此属性定义了径向渐变结束圆的 x 坐标。值类型<length>默认值50%可动画

cy

此属性定义了径向渐变结束圆的 y 坐标。值类型<length>默认值50%可动画

fr

此属性定义了径向渐变开始圆的半径。渐变将绘制,使得 0% 的 <stop> 映射到开始圆的周长。值类型<length>默认值0%可动画

fx

此属性定义了径向渐变开始圆的 x 坐标。值类型<length>默认值:与 cx 相同;可动画

fy

此属性定义了径向渐变开始圆的 y 坐标。值类型<length>默认值:与 cy 相同;可动画

渐变单位

此属性定义了 cxcyrfxfyfr 属性的坐标系统。值类型userSpaceOnUse | objectBoundingBox默认值objectBoundingBox可动画

渐变变换

此属性为渐变坐标系统提供了附加的 变换值类型<transform-list>默认值恒等变换可动画

href

此属性定义了一个对另一个 <radialGradient> 元素的引用,该元素将被用作模板。值类型<URL>默认值:无;可动画

r

此属性定义了径向渐变结束圆的半径。渐变将绘制,使得 100% 的 <stop> 映射到结束圆的周长。值类型<length>默认值50%可动画

扩展方法

此属性指示当渐变开始或结束在包含渐变的形状边界内时,渐变的行为方式。值类型pad | reflect | repeat默认值pad可动画

xlink:href 已弃用

一个对另一个 <radialGradient> 元素的 <IRI> 引用,该元素将被用作模板。值类型<IRI>默认值:无;可动画

DOM 接口

此元素实现了 SVGRadialGradientElement 接口。

示例

html
<svg
  viewBox="0 0 10 10"
  xmlns="http://www.w3.org/2000/svg"
  xmlns:xlink="http://www.w3.org/1999/xlink">
  <defs>
    <radialGradient id="myGradient">
      <stop offset="10%" stop-color="gold" />
      <stop offset="95%" stop-color="red" />
    </radialGradient>
  </defs>

  <!-- using my radial gradient -->
  <circle cx="5" cy="5" r="4" fill="url('#myGradient')" />
</svg>

规范

规范
Scalable Vector Graphics (SVG) 2
# 径向渐变元素 (RadialGradientElement)

浏览器兼容性