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

CanvasRenderingContext2D:globalAlpha 属性

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.globalAlpha`** 属性指定将被绘制到 canvas 上的形状或图像的 alpha(透明度)值。

Canvas 2D API 的 CanvasRenderingContext2D.globalAlpha 属性指定将被绘制到 canvas 上的形状或图像的 alpha(透明度)值。

[!NOTE] 参见 Canvas 教程中应用样式和色彩这一章节。

值

一个在 0.0(完全透明)到 1.0(完全不透明)之间的数字,包括两者在内。默认值是 1.0。超出该范围的值,包括 Infinity 和 NaN,将不会被设置,并且 globalAlpha 将保留其先前的值。

示例

绘制半透明形状

此示例用 globalAlpha 属性绘制了 2 个半透明的矩形。

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

JavaScript

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

ctx.globalAlpha = 0.5;

ctx.fillStyle = "blue";
ctx.fillRect(10, 10, 100, 100);

ctx.fillStyle = "red";
ctx.fillRect(50, 50, 100, 100);

结果

绘制半透明形状

叠加透明形状

此示例演示了在彼此叠加多个透明形状的效果。我们首先绘制一个由四个不同颜色的方块组成的实心背景。接下来,将 globalAlpha 属性设置为 0.2(20% 不透明);这个 alpha 级别将应用于所有透明形状。然后,我们使用一个 for 循环绘制一系列半径逐渐增大的圆。

随着每个新圆的绘制,下面圆的透明度实际上增加了。如果我们增加循环的次数(从而绘制更多的圆),背景最终会完全从图像的中心消失。

<canvas id="canvas" width="150" height="150"></canvas>
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 绘制背景
ctx.fillStyle = "#FD0";
ctx.fillRect(0, 0, 75, 75);
ctx.fillStyle = "#6C0";
ctx.fillRect(75, 0, 75, 75);
ctx.fillStyle = "#09F";
ctx.fillRect(0, 75, 75, 75);
ctx.fillStyle = "#F30";
ctx.fillRect(75, 75, 75, 75);
ctx.fillStyle = "#FFF";

// 设置透明度值
ctx.globalAlpha = 0.2;

// 绘制透明圆
for (let i = 0; i < 7; i++) {
  ctx.beginPath();
  ctx.arc(75, 75, 10 + 10 * i, 0, Math.PI * 2, true);
  ctx.fill();
}

叠加透明形状

规范

浏览器兼容性

Gecko 特定注意事项

  • 从 Gecko 5.0 开始,为 globalAlpha 指定无效值将不再抛出 SYNTAX_ERR 异常;这些值将被正确地静默忽略。

WebKit/Blink 特定注意事项

  • 在基于 WebKit 和 Blink 的浏览器中,除了此属性之外,还实现了一个非标准且已弃用的方法 ctx.setAlpha()。

参见

  • 定义此属性的接口:CanvasRenderingContext2D
  • CanvasRenderingContext2D.globalCompositeOperation

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

资料来源与适用范围

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

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

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