Canvas 的 API 可以分成幾個清楚的家族:狀態管理、線條樣式、顏色與陰影、路徑、矩形、文字、轉換。搞懂這個分類,查文件的速度會快很多。
save():把當前環境狀態存進堆疊restore():取出先前保存的路徑狀態與屬性getContext():取得繪圖所需的 API 物件,通常傳入 "2d"toDataURL():把畫布內容轉成圖片的 URL,可直接當 img 的 src 或下載連結lineCap:線條端點樣式(butt/round/square)lineJoin:兩線相交處的轉角樣式(miter/round/bevel)lineWidth:目前線條的寬度miterLimit:最大斜接長度,用來限制尖角延伸的極限屬性:
fillStyle:填充用的顏色、漸層或模式strokeStyle:筆觸(描邊)用的顏色、漸層或模式shadowColor:陰影顏色shadowBlur:陰影模糊程度shadowOffsetX:陰影距形狀的水平距離shadowOffsetY:陰影距形狀的垂直距離方法:
createLinearGradient():建立線性漸層,用於畫布內容createRadialGradient():建立放射狀/環形漸層createPattern():在指定方向上重複填滿某個元素(圖片或另一個 canvas)addColorStop():為漸層物件指定顏色與停止位置beginPath():起始一段新路徑,或重置目前路徑closePath():從當前點連回起點,形成閉合路徑moveTo():把路徑移到畫布上的指定點,不建立線條lineTo():新增一個點,並從上一點連一條線過來fill():填滿目前的封閉路徑stroke():沿著已定義的路徑描邊clip():從原始畫布裁切出任意形狀與尺寸的區域,後續繪圖只在該區域內可見quadraticCurveTo():建立二次貝茲曲線bezierCurveTo():建立三次貝茲曲線arc():建立圓弧/曲線,用於畫圓形或圓的一部分arcTo():建立兩條切線之間的弧線isPointInPath():判斷指定點是否落在目前路徑內,回傳布林值(常用於自訂 hit test)rect():建立矩形路徑(可後續填滿或描邊)fillRect():直接繪製填滿的矩形strokeRect():繪製無填充的矩形clearRect():清除指定矩形區域內的像素,使其變透明差別在於:rect() 產生的是「路徑」,能參與後續的 fill/stroke/clip;fillRect() 與 strokeRect() 則是立刻成像的一次性操作。
屬性:
font:目前使用的字型屬性,寫法同 CSStextAlign:水平對齊方式(left/right/center/start/end)textBaseline:垂直基線(top/hanging/middle/alphabetic/ideographic/bottom)方法:
fillText():繪製填滿顏色的文字strokeText():繪製只有輪廓的文字measureText():回傳包含指定文字寬度資訊的物件,常用於置中排版與文字截斷scale():縮放當前繪圖,可放大或縮小rotate():旋轉當前繪圖,參數為弧度translate():重新映射畫布的 (0, 0) 位置transform():以矩陣相乘的方式套用新的轉換矩陣setTransform():把轉換矩陣重置為單位矩陣後,再套用指定的變換這兩者的差異值得記住:transform() 是「疊加」在目前狀態上,setTransform() 是「覆蓋」成指定狀態。在寫需要反覆重置座標系統的動畫時,setTransform() 往往比連續 save/restore 更乾淨。