CanvasRenderingContext2D: shadowOffsetY property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
TheCanvasRenderingContext2D.shadowOffsetYproperty of the Canvas 2D API specifies the distance that shadows will be offsetvertically.
Note:Shadows are only drawn if theshadowColor property is set toa non-transparent value. One of theshadowBlur,shadowOffsetX, orshadowOffsetY properties must be non-zero, aswell.
Value
A float specifying the distance that shadows will be offset vertically. Positive values are down, and negative are up. The default value is0 (no vertical offset).Infinity andNaN values are ignored.
Examples
Moving a shadow vertically
This example adds a blurred shadow to a rectangle. TheshadowColor property sets itscolor,shadowOffsetY sets its offset 25 units towards the bottom, andshadowBlur gives it a blur levelof 10.
HTML
<canvas></canvas>JavaScript
const canvas = document.getElementById("canvas");const ctx = canvas.getContext("2d");// Shadowctx.shadowColor = "red";ctx.shadowOffsetY = 25;ctx.shadowBlur = 10;// Rectanglectx.fillStyle = "blue";ctx.fillRect(20, 20, 150, 80);Result
Specifications
| Specification |
|---|
| HTML # dom-context-2d-shadowoffsety-dev |
Browser compatibility
See also
- The interface defining this property:
CanvasRenderingContext2D CanvasRenderingContext2D.shadowOffsetXCanvasRenderingContext2D.shadowColorCanvasRenderingContext2D.shadowBlur