Skip to content

Interface: GradientFill ​

A gradient fill (a:gradFill), as read from a container: the stops plus the geometry that a bare stop list omits. linear gradients carry an GradientFill.angleDeg (the a:lin/@ang direction); radial/path gradients carry a GradientFill.path shape (a:path/@path, e.g. circle). The angle is in OOXML degrees (clockwise from 3 o'clock), the same convention the write-side GradientFillProps.angle expects, so it round-trips directly.

Properties ​

angleDeg ​

angleDeg: number | null

Linear direction in OOXML degrees (clockwise from 3 o'clock), or null for a path gradient / when unset.


focusRect ​

focusRect: FillRect | null

A path gradient's focus rectangle (a:path/a:fillToRect) as per-edge fractions inset from the fill box, or null when absent. Equal insets centre the focus; the write side's radial center: { x, y } writes left = x, top = y, right = 1 - x, bottom = 1 - y.


kind ​

kind: "linear" | "path" | null

linear (a:lin) or path (a:path, i.e. radial/rectangular). null when neither child is present.


path ​

path: string | null

Path-gradient shape (a:path/@path: circle/rect/shape), or null for a linear gradient.


rotateWithShape ​

rotateWithShape: boolean | null

Whether the fill rotates with the shape (a:gradFill/@rotWithShape), or null when the attribute is absent.


scaled ​

scaled: boolean | null

Whether a linear gradient's angle scales with the fill region (a:lin/@scaled), or null when unset.


stops ​

stops: GradientStop[]

The gradient stops in document order.