# HTML 5 Canvas 参考手册 ## 描述 HTML5 <canvas> 标签用于绘制图像(通过脚本,通常是 JavaScript)。 不过,<canvas> 元素本身并没有绘制能力(它仅仅是图形的容器) - 您必须使用脚本来完成实际的绘图任务。 getContext() 方法可返回一个对象,该对象提供了用于在画布上绘图的方法和属性。 本手册提供完整的 getContext("2d") 对象属性和方法,可用于在画布上绘制文本、线条、矩形、圆形等等。 ## 浏览器支持 Internet Explorer 9、Firefox、Opera、Chrome 以及 Safari 支持 <canvas> 及其属性和方法。 注释:Internet Explorer 8 以及更早的版本不支持 <canvas> 元素。 ## 颜色、样式和阴影 | 属性 | 描述 | | --- | --- | | [fillStyle](/tags/canvas_fillstyle.asp "HTML5 canvas fillStyle 属性") | 设置或返回用于填充绘画的颜色、渐变或模式 | | [strokeStyle](/tags/canvas_strokestyle.asp "HTML5 canvas strokeStyle 属性") | 设置或返回用于笔触的颜色、渐变或模式 | | [shadowColor](/tags/canvas_shadowcolor.asp "HTML5 canvas shadowColor 属性") | 设置或返回用于阴影的颜色 | | [shadowBlur](/tags/canvas_shadowblur.asp "HTML5 canvas shadowBlur 属性") | 设置或返回用于阴影的模糊级别 | | [shadowOffsetX](/tags/canvas_shadowoffsetx.asp "HTML5 canvas shadowOffsetX 属性") | 设置或返回阴影距形状的水平距离 | | [shadowOffsetY](/tags/canvas_shadowoffsety.asp "HTML5 canvas shadowOffsetY 属性") | 设置或返回阴影距形状的垂直距离 | | 方法 | 描述 | | --- | --- | | [createLinearGradient()](/tags/canvas_createlineargradient.asp "HTML5 canvas createLinearGradient() 方法") | 创建线性渐变(用在画布内容上) | | [createPattern()](/tags/canvas_createpattern.asp "HTML5 canvas createPattern() 方法") | 在指定的方向上重复指定的元素 | | [createRadialGradient()](/tags/canvas_createradialgradient.asp "HTML5 canvas createRadialGradient() 方法") | 创建放射状/环形的渐变(用在画布内容上) | | [addColorStop()](/tags/canvas_addcolorstop.asp "HTML5 canvas addColorStop() 方法") | 规定渐变对象中的颜色和停止位置 | ## 线条样式 | 属性 | 描述 | | --- | --- | | [lineCap](/tags/canvas_linecap.asp "HTML5 canvas lineCap 属性") | 设置或返回线条的结束端点样式 | | [lineJoin](/tags/canvas_linejoin.asp "HTML5 canvas lineJoin 属性") | 设置或返回两条线相交时,所创建的拐角类型 | | [lineWidth](/tags/canvas_linewidth.asp "HTML5 canvas lineWidth 属性") | 设置或返回当前的线条宽度 | | [miterLimit](/tags/canvas_miterlimit.asp "HTML5 canvas miterLimit 属性") | 设置或返回最大斜接长度 | ## 矩形 | 方法 | 描述 | | --- | --- | | [rect()](/tags/canvas_rect.asp "HTML5 canvas rect() 方法") | 创建矩形 | | [fillRect()](/tags/canvas_fillrect.asp "HTML5 canvas fillRect() 方法") | 绘制“被填充”的矩形 | | [strokeRect()](/tags/canvas_strokerect.asp "HTML5 canvas strokeRect() 方法") | 绘制矩形(无填充) | | [clearRect()](/tags/canvas_clearrect.asp "HTML5 canvas clearRect() 方法") | 在给定的矩形内清除指定的像素 | ## 路径 | 方法 | 描述 | | --- | --- | | [fill()](/tags/canvas_fill.asp "HTML5 canvas fill() 方法") | 填充当前绘图(路径) | | [stroke()](/tags/canvas_stroke.asp "HTML5 canvas stroke() 方法") | 绘制已定义的路径 | | [beginPath()](/tags/canvas_beginpath.asp "HTML5 canvas beginPath() 方法") | 起始一条路径,或重置当前路径 | | [moveTo()](/tags/canvas_moveto.asp "HTML5 canvas moveTo() 方法") | 把路径移动到画布中的指定点,不创建线条 | | [closePath()](/tags/canvas_closepath.asp "HTML5 canvas closePath() 方法") | 创建从当前点回到起始点的路径 | | [lineTo()](/tags/canvas_lineto.asp "HTML5 canvas lineTo() 方法") | 添加一个新点,然后在画布中创建从该点到最后指定点的线条 | | [clip()](/tags/canvas_clip.asp "HTML5 canvas clip() 方法") | 从原始画布剪切任意形状和尺寸的区域 | | [quadraticCurveTo()](/tags/canvas_quadraticcurveto.asp "HTML5 canvas quadraticCurveTo() 方法") | 创建二次贝塞尔曲线 | | [bezierCurveTo()](/tags/canvas_beziercurveto.asp "HTML5 canvas bezierCurveTo() 方法") | 创建三次方贝塞尔曲线 | | [arc()](/tags/canvas_arc.asp "HTML5 canvas arc() 方法") | 创建弧/曲线(用于创建圆形或部分圆) | | [arcTo()](/tags/canvas_arcto.asp "HTML5 canvas arcTo() 方法") | 创建两切线之间的弧/曲线 | | [isPointInPath()](/tags/canvas_ispointinpath.asp "HTML5 canvas isPointInPath() 方法") | 如果指定的点位于当前路径中,则返回 true,否则返回 false | ## 转换 | 方法 | 描述 | | --- | --- | | [scale()](/tags/canvas_scale.asp "HTML5 canvas scale() 方法") | 缩放当前绘图至更大或更小 | | [rotate()](/tags/canvas_rotate.asp "HTML5 canvas rotate() 方法") | 旋转当前绘图 | | [translate()](/tags/canvas_translate.asp "HTML5 canvas translate() 方法") | 重新映射画布上的 (0,0) 位置 | | [transform()](/tags/canvas_transform.asp "HTML5 canvas transform() 方法") | 替换绘图的当前转换矩阵 | | [setTransform()](/tags/canvas_settransform.asp "HTML5 canvas setTransform() 方法") | 将当前转换重置为单位矩阵。然后运行 transform() | ## 文本 | 属性 | 描述 | | --- | --- | | [font](/tags/canvas_font.asp "HTML5 canvas font 属性") | 设置或返回文本内容的当前字体属性 | | [textAlign](/tags/canvas_textalign.asp "HTML5 canvas textAlign 属性") | 设置或返回文本内容的当前对齐方式 | | [textBaseline](/tags/canvas_textbaseline.asp "HTML5 canvas textBaseline 属性") | 设置或返回在绘制文本时使用的当前文本基线 | | 方法 | 描述 | | --- | --- | | [fillText()](/tags/canvas_filltext.asp "HTML5 canvas fillText() 方法") | 在画布上绘制“被填充的”文本 | | [strokeText()](/tags/canvas_stroketext.asp "HTML5 canvas strokeText() 方法") | 在画布上绘制文本(无填充) | | [measureText()](/tags/canvas_measuretext.asp "HTML5 canvas measureText() 方法") | 返回包含指定文本宽度的对象 | ## 图像绘制 | 方法 | 描述 | | --- | --- | | [drawImage()](/tags/canvas_drawimage.asp "HTML5 canvas drawImage() 方法") | 向画布上绘制图像、画布或视频 | ## 像素操作 | 属性 | 描述 | | --- | --- | | [width](/tags/canvas_imagedata_width.asp "HTML5 canvas width 属性") | 返回 ImageData 对象的宽度 | | [height](/tags/canvas_imagedata_height.asp "HTML5 canvas height 属性") | 返回 ImageData 对象的高度 | | [data](/tags/canvas_imagedata_data.asp "HTML5 canvas data 属性") | 返回一个对象,其包含指定的 ImageData 对象的图像数据 | | 方法 | 描述 | | --- | --- | | [createImageData()](/tags/canvas_createimagedata.asp "HTML5 canvas createImageData() 方法") | 创建新的、空白的 ImageData 对象 | | [getImageData()](/tags/canvas_getimagedata.asp "HTML5 canvas getImageData() 方法") | 返回 ImageData 对象,该对象为画布上指定的矩形复制像素数据 | | [putImageData()](/tags/canvas_putimagedata.asp "HTML5 canvas putImageData() 方法") | 把图像数据(从指定的 ImageData 对象)放回画布上 | ## 合成 | 属性 | 描述 | | --- | --- | | [globalAlpha](/tags/canvas_globalalpha.asp "HTML5 canvas globalAlpha 属性") | 设置或返回绘图的当前 alpha 或透明值 | | [globalCompositeOperation](/tags/canvas_globalcompositeoperation.asp "HTML5 canvas globalCompositeOperation 属性") | 设置或返回新图像如何绘制到已有的图像上 | ## 其他 | 方法 | 描述 | | --- | --- | | save() | 保存当前环境的状态 | | restore() | 返回之前保存过的路径状态和属性 | | createEvent() | | getContext() | | toDataURL() |