CanvasRenderingContext2D: shadowOffsetY-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die CanvasRenderingContext2D.shadowOffsetY-Eigenschaft der Canvas 2D API gibt die Distanz an, um die Schatten vertikal versetzt werden.
Hinweis:
Schatten werden nur gezeichnet, wenn die shadowColor-Eigenschaft auf einen nicht-transparenten Wert gesetzt ist. Eine der Eigenschaften shadowBlur, shadowOffsetX oder shadowOffsetY muss ebenfalls ungleich null sein.
Wert
Ein float, der die Distanz angibt, um die Schatten vertikal versetzt werden. Positive Werte bedeuten nach unten, negative nach oben. Der Standardwert ist 0 (keine vertikale Verschiebung). Infinity- und NaN-Werte werden ignoriert.
Beispiele
Einen Schatten vertikal verschieben
Dieses Beispiel fügt einem Rechteck einen verschwommenen Schatten hinzu. Die shadowColor-Eigenschaft legt die Farbe fest, shadowOffsetY versetzt ihn um 25 Einheiten nach unten, und shadowBlur gibt ihm eine Unschärfe von 10.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// Shadow
ctx.shadowColor = "red";
ctx.shadowOffsetY = 25;
ctx.shadowBlur = 10;
// Rectangle
ctx.fillStyle = "blue";
ctx.fillRect(20, 20, 150, 80);
Ergebnis
Spezifikationen
| Specification |
|---|
| HTML # dom-context-2d-shadowoffsety-dev |
Browser-Kompatibilität
Loading…
Siehe auch
- Das Interface, das diese Eigenschaft definiert:
CanvasRenderingContext2D CanvasRenderingContext2D.shadowOffsetXCanvasRenderingContext2D.shadowColorCanvasRenderingContext2D.shadowBlur