CanvasRenderingContext2D: shadowOffsetY-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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
| Spezifikation |
|---|
| HTML # dom-context-2d-shadowoffsety-dev |
Browser-Kompatibilität
Siehe auch
- Das Interface, das diese Eigenschaft definiert:
CanvasRenderingContext2D CanvasRenderingContext2D.shadowOffsetXCanvasRenderingContext2D.shadowColorCanvasRenderingContext2D.shadowBlur