浏览器支持
Internet Explorer 9、Firefox、Opera、Chrome 以及 Safari 支持 <canvas> 及其属性和方法。
注释:Internet Explorer 8 以及更早的版本不支持 <canvas> 元素。
width/height 属性
画布的宽高。和一幅图像一样,这个属性可以指定为一个整数像素值或者是窗口宽度的百分比。当这个值改变的时候,在该画布上已经完成的任何绘图都会擦除掉。默认值是 300
Canvas 对象的方法
var canvas = document.getElementById('canvas);
var ctx = canvas.getContext('2d'); //返回一个用于在画布上绘图的环境。
颜色、样式和阴影
属性 |
描述 |
fillStyle |
设置或返回用于填充绘画的颜色、渐变或模式 |
strokeStyle |
设置或返回用于笔触的颜色、渐变或模式 |
shadowColor |
设置或返回用于阴影的颜色 |
shadowBlur |
设置或返回用于阴影的模糊级别 |
shadowOffsetX |
设置或返回阴影距形状的水平距离 |
shadowOffsetY |
设置或返回阴影距形状的垂直距离 |
方法 |
描述 |
createLinearGradient(x开始,y开始,x结束,y结束) |
创建线性渐变(用在画布内容上) |
createPattern(image,"repeat或repeat-x或repeat-y或no-repeat") |
在指定的方向上重复指定的元素 |
createRadialGradient(x开始,y开始,r开始半径,x1结束,y1结束,r1结束半径) |
创建放射状/环形的渐变(用在画布内容上) |
addColorStop(stop,color) |
规定渐变对象中的颜色和停止位置 |
线条样式
属性 |
描述 |
lineCap |
设置或返回线条的结束端点样式 |
lineJoin |
设置或返回两条线相交时,所创建的拐角类型 |
lineWidth |
设置或返回当前的线条宽度 |
miterLimit |
设置或返回最大斜接长度 |
矩形
方法 |
描述 |
rect(矩形左上角x坐标,矩形左上角y坐标,width,height) |
创建矩形 |
fillRect(x,y,width,height) |
绘制“被填充”的矩形 |
strokeRect(x,y,width,height) |
绘制矩形(无填充) |
clearRect(x,y,width,height) |
在给定的矩形内清除指定的像素 |
路径
方法 |
描述 |
fill() |
填充当前绘图(路径) |
stroke() |
绘制已定义的路径 |
beginPath() |
起始一条路径,或重置当前路径 |
moveTo(x,y) |
把路径移动到画布中的指定点,不创建线条 |
closePath() |
创建从当前点回到起始点的路径 |
lineTo(x,y) |
添加一个新点,然后在画布中创建从该点到最后指定点的线条 |
clip() |
从原始画布剪切任意形状和尺寸的区域 |
quadraticCurveTo(cpx,cpy,x,y) |
创建二次贝塞尔曲线 |
bezierCurveTo(cp1x,cp1y,cp2x,cp2y,x,y) |
创建三次方贝塞尔曲线 |
arc(x,y,r,sAngle,eAngle,counterclockwise) |
创建弧/曲线(用于创建圆形或部分圆) |
arcTo(x1,y1,x2,y2,r) |
创建两切线之间的弧/曲线 |
isPointInPath(x,y) |
如果指定的点位于当前路径中,则返回 true,否则返回 false |
转换
方法 |
描述 |
scale(scalewidth,scaleheight) |
缩放当前绘图至更大或更小 |
rotate(angle) |
旋转当前绘图 |
translate(x,y) |
重新映射画布上的 (0,0) 位置 |
transform(水平缩放绘图,水平倾斜绘图,垂直倾斜绘图,垂直缩放绘图,水平移动绘图,垂直移动绘图) |
替换绘图的当前转换矩阵 |
setTransform(参数同上) |
将当前转换重置为单位矩阵。然后运行 transform() |
文本
属性 |
描述 |
font |
设置或返回文本内容的当前字体属性 |
textAlign |
设置或返回文本内容的当前对齐方式 |
textBaseline |
设置或返回在绘制文本时使用的当前文本基线 |
方法 |
描述 |
fillText(text,x,y,maxWidth) |
在画布上绘制“被填充的”文本 |
strokeText(text,x,y,maxWidth) |
在画布上绘制文本(无填充) |
measureText(text) |
返回包含指定文本宽度的对象 |
图像绘制
方法 |
描述 |
drawImage(img,sx,sy,swidth,sheight,x,y,width,height) |
向画布上绘制图像、画布或视频 |
像素操作
属性 |
描述 |
width |
返回 ImageData 对象的宽度 |
height |
返回 ImageData 对象的高度 |
data |
返回一个对象,其包含指定的 ImageData 对象的图像数据 |
方法 |
描述 |
createImageData() |
创建新的、空白的 ImageData 对象 |
getImageData(x,y,width,height) |
返回 ImageData 对象,该对象为画布上指定的矩形复制像素数据 |
putImageData(imgData,x,y,dirtyX,dirtyY,dirtyWidth,dirtyHeight) |
把图像数据(从指定的 ImageData 对象)放回画布上 |
合成
属性 |
描述 |
globalAlpha |
设置或返回绘图的当前 alpha 或透明值 |
globalCompositeOperation |
设置或返回新图像如何绘制到已有的图像上 |
其他
方法 |
描述 |
save() |
保存当前环境的状态 |
restore() |
返回之前保存过的路径状态和属性 |