CanvasRenderingContext2D: fillRect() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Canvas 2D API 的 CanvasRenderingContext2D.fillRect() 方法會繪製一個根據當前 fillStyle 填充的矩形。

此方法直接繪製到畫布上,而不會修改當前路徑,因此任何後續的 fill()stroke() 呼叫都不會對其產生影響。

語法

js
fillRect(x, y, width, height)

fillRect() 方法會繪製一個填充矩形,其起始點為 (x, y),尺寸由 widthheight 指定。填充樣式由當前的 fillStyle 屬性決定。

引數

x

矩形起始點的 x 軸座標。

y

矩形起始點的 y 軸座標。

width

矩形的寬度。正值表示向右,負值表示向左。

height

矩形的高度。正值表示向下,負值表示向上。

返回值

無(undefined)。

示例

一個簡單的填充矩形

本示例使用 fillRect() 方法繪製了一個綠色的填充矩形。

HTML

html
<canvas id="canvas"></canvas>

JavaScript

矩形的左上角位於 (20, 10)。它的寬度為 150,高度為 100。

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.fillStyle = "green";
ctx.fillRect(20, 10, 150, 100);

結果

填充整個畫布

此程式碼片段用一個矩形填充了整個畫布。這對於建立背景非常有用,然後可以在其上繪製其他內容。要實現這一點,矩形的尺寸應等於 <canvas> 元素的 widthheight 屬性。

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.fillRect(0, 0, canvas.width, canvas.height);

規範

規範
HTML
# dom-context-2d-fillrect-dev

瀏覽器相容性

另見