大网数据广告活动
Web 标准与前端开发

CanvasRenderingContext2D:translate() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.translate()`** 方法用于对当前网格添加平移变换。

Canvas 2D API 的 CanvasRenderingContext2D.translate() 方法用于对当前网格添加平移变换。

语法

translate(x, y)

translate() 方法通过在网格上将画布和原点水平移动 x 单位和垂直移动 y 单位,向当前矩阵添加一个平移变换。

基于 translate 方法的值将画布的原点在 x 和 y 轴上移动。

参数

  • x
    • : 在水平方向上移动的距离。正值向右移动,负值向左移动。
  • y
    • : 在垂直方向上移动的距离。正值向下移动,负值向上移动。

返回值

无(undefined)。

示例

移动形状

这个例子使用 translate() 方法将一个正方形从其默认位置移动。然后绘制了一个大小相同但未移动的正方形以进行比较。

HTML

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

JavaScript

translate() 方法将上下文在水平方向上移动 110 个单位,在垂直方向上移动 30 个单位。第一个正方形根据这些量从其默认位置移动。

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 移动的正方形
ctx.translate(110, 30);
ctx.fillStyle = "red";
ctx.fillRect(0, 0, 80, 80);

// 重置当前的变换矩阵为单位矩阵
ctx.setTransform(1, 0, 0, 1, 0, 0);

// 未移动的正方形
ctx.fillStyle = "gray";
ctx.fillRect(0, 0, 80, 80);

结果

移动后的正方形为红色,未移动的正方形为灰色。

移动形状

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。