Canvas 的使用可以拆成兩步:先在 HTML 裡放一個 <canvas> 元素,再用 JavaScript 取得它的參照。兩步都很短,但各有該注意的地方。
<canvas id="canvasOne" width="500" height="300">
Your browser does not support HTML5 Canvas.
</canvas>
要注意的是,不能寫成自閉合的形式:
<!-- 錯誤寫法 -->
<canvas id="canvasOne" width="500" height="300" />
因為 <canvas> 必須有成對的結束標籤,標籤之間的內容才能在我不支援的瀏覽器上派上用場。
canvasOne。這裡的 width 與 height 決定的是繪圖緩衝區的解析度,不是顯示尺寸。顯示尺寸應該交給 CSS,兩者不要混用,否則圖形會被拉伸變形。
<canvas> 與 </canvas> 之間可以放任意內容。當使用者使用不支援 Canvas 的瀏覽器開啟頁面時,這段內容會顯示在該位置;支援的瀏覽器則會直接忽略它。上例寫的是「Your browser does not support HTML5 Canvas.」,實務上建議改寫成更友善的提示,或放一張替代圖片。
頁面載入完成後,document 物件代表整個頁面上的所有元素,因此可以透過 DOM 取得剛才定義的 canvas:
var theCanvas = document.getElementById("canvasOne");
我們需要這個參照,才能知道 Canvas 的繪圖結果該呈現在哪裡。拿到元素之後,下一步就是呼叫 theCanvas.getContext("2d") 取得繪圖上下文,之後所有畫線、填色、畫圖的操作都透過它進行。
小提醒:若這段 JavaScript 放在 <head> 裡直接執行,getElementById 會找不到元素而回傳 null。解法是把程式碼移到頁面底部,或包在 window.onload(更推薦 DOMContentLoaded)裡。