gradientTransform

The gradientTransform attribute contains the definition of an optional additional transformation from the gradient coordinate system onto the target coordinate system (i.e., userSpaceOnUse or objectBoundingBox). This allows for things such as skewing the gradient. This additional transformation matrix is post-multiplied to (i.e., inserted to the right of) any previously defined transformations, including the implicit transformation necessary to convert from object bounding box units to user space.

You can use this attribute with the following SVG elements:

Example

<svg viewBox="0 0 420 200" xmlns="http://www.w3.org/2000/svg">
  <radialGradient id="gradient1" gradientUnits="userSpaceOnUse"
      cx="100" cy="100" r="100" fx="100" fy="100">
    <stop offset="0%" stop-color="darkblue" />
    <stop offset="50%" stop-color="skyblue" />
    <stop offset="100%" stop-color="darkblue" />
  </radialGradient>
  <radialGradient id="gradient2" gradientUnits="userSpaceOnUse"
      cx="100" cy="100" r="100" fx="100" fy="100"
      gradientTransform="skewX(20) translate(-35, 0)">
    <stop offset="0%" stop-color="darkblue" />
    <stop offset="50%" stop-color="skyblue" />
    <stop offset="100%" stop-color="darkblue" />
  </radialGradient>

  <rect x="0" y="0" width="200" height="200" fill="url(#gradient1)" />
  <rect x="0" y="0" width="200" height="200" fill="url(#gradient2)" style="transform: translateX(220px);" />
</svg>

Usage notes

Default value Identity transform
Value <transform-list>
Animatable Yes
<transform-list>

A list of transformation functions specifying some additional transformation from the gradient coordinate system onto the target coordinate system.

Specifications

Specification Status Comment
CSS Transforms Level 1
The definition of 'surfaceScale for <feSpecularLighting>' in that specification.
Working Draft Defines the <transformation-list> value.
Scalable Vector Graphics (SVG) 2
The definition of 'gradientTransformation for <linearGradient>' in that specification.
Candidate Recommendation No change
Scalable Vector Graphics (SVG) 2
The definition of 'gradientTransformation for <radialGradient>' in that specification.
Candidate Recommendation No change
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'gradientTransformation for <linearGradient>' in that specification.
Recommendation Initial definition for <linearGradient>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'gradientTransformation for <radialGradient>' in that specification.
Recommendation Initial definition for <radialGradient>

Browser compatibility

BCD tables only load in the browser

See also