在HTML Canvas中正确应用自定义字体：实用教程_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

在HTML Canvas中正确应用自定义字体：实用教程

2025-12-02

浏览次数：次

返回列表

在HTML Canvas中正确应用自定义字体：实用教程

本教程详细介绍了在html canvas 2d绘图中应用自定义字体时遇到的常见问题及其解决方案。主要探讨了`context.font`属性的正确语法，特别是针对包含空格的字体名称，并强调了使用`document.fonts.ready`确保外部字体加载完成后再进行绘制的重要性，以避免字体渲染失败。通过具体代码示例，帮助开发者实现canvas文本的个性化样式。

理解Canvas文本与自定义字体

在HTML Canvas 2D上下文中绘制文本时，我们使用context.font属性来设置字体样式。这个属性接受一个CSS font属性值的字符串，例如 "42px Arial"。然而，当涉及到使用自定义字体（如Google Fonts）时，开发者常会遇到字体无法正确应用的问题，即使该字体已通过CSS导入并应用于Canvas的父元素。这通常是由两个主要原因造成的：context.font属性的语法细节以及Web字体加载的异步特性。

1. context.font属性的正确语法

当字体名称包含空格时，必须将其用单引号或双引号括起来。这与CSS中处理包含空格的字体名称的方式一致。如果缺少引号，Canvas的渲染上下文可能无法正确识别字体名称，从而回退到默认字体（通常是serif或sans-serif）。

错误示例：

context.font = "42px Press Start 2P"; // 字体名称 "Press Start 2P" 未加引号

在这种情况下，尽管 Press Start 2P 字体可能已经通过CSS加载，但由于语法错误，Canvas将无法识别它。

正确示例：

context.font = "42px 'Press Start 2P'"; // 字体名称 "Press Start 2P" 已用单引号括起来
// 或者
context.font = "42px \"Press Start 2P\""; // 字体名称 "Press Start 2P" 已用双引号括起来

2. 等待字体加载完成：document.fonts.ready

Web字体（尤其是通过@import或标签从外部源加载的字体）是异步加载的。这意味着当你的J*aScript代码尝试绘制Canvas文本时，字体文件可能尚未完全下载和解析。如果字体在绘制时还未准备好，Canvas会使用一个备用字体进行渲染，导致自定义字体不生效。

为了解决这个问题，我们可以利用 document.fonts.ready Promise。这个Promise会在所有字体加载完毕并可供使用时解析。通过等待这个Promise解析，我们可以确保在绘制Canvas文本之前，所需的自定义字体已经可用。

实现步骤：

导入字体： 在CSS文件中导入或在HTML头部链接自定义字体。

Musho

AI网页设计Figma插件

76 查看详情 Musho

@import url('https://fonts.googleapis.com/css2?family=Press+Start+2P&display=swap');

/* 也可以将字体应用于Canvas的父元素，但这不直接影响Canvas内部绘制的文本 */
.canvas-container {
    font-family: 'Press Start 2P', cursive;
}

等待字体就绪并绘制： 在J*aScript代码中，使用async/await结构等待document.fonts.ready。

(async () => {
  // 等待所有字体加载完毕
  await document.fonts.ready;

  // 获取Canvas元素及其2D渲染上下文
  const canvas = document.querySelector("canvas");
  if (!canvas) {
    console.error("Canvas element not found.");
    return;
  }
  const context = canvas.getContext("2d");

  // 设置Canvas尺寸（示例）
  canvas.width = 500;
  canvas.height = 150;

  // 设置文本样式
  context.fillStyle = 'rgba(194,213,219,0.8)';
  // 确保字体名称用引号括起来
  context.font = "42px 'Press Start 2P'";
  context.textAlign = 'center';
  context.textBaseline = 'middle'; // 垂直居中对齐

  // 绘制文本
  context.fillText('Hello Canvas!', canvas.width / 2, canvas.height / 2);

})().catch(console.error); // 捕获潜在的错误

完整示例代码

下面是一个完整的HTML、CSS和J*aScript示例，演示了如何在Canvas中正确应用自定义字体：

index.html:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Canvas自定义字体教程</title>
    <link rel="stylesheet" href="style.css">
</head>
<body>
    <div class="canvas-container">
        <h1>Canvas自定义字体示例</h1>
        <canvas id="myCanvas" width="500" height="150" style="border: 1px solid #ccc; background-color: #333;"></canvas>
        <p>此文本应显示为 'Press Start 2P' 字体。</p>
    </div>

    <script src="script.js"></script>
</body>
</html>

style.css:

@import url('https://fonts.googleapis.com/css2?family=Press+Start+2P&display=swap');

body {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    min-height: 100vh;
    margin: 0;
    background-color: #f0f0f0;
    font-family: sans-serif;
}

.canvas-container {
    text-align: center;
    padding: 20px;
    background-color: white;
    box-shadow: 0 4px 8px rgba(0,0,0,0.1);
    border-radius: 8px;
}

h1 {
    font-family: 'Press Start 2P', cursive; /* 应用于普通HTML文本 */
    color: #333;
    margin-bottom: 20px;
}

p {
    font-family: 'Press Start 2P', cursive; /* 应用于普通HTML文本 */
    color: #555;
    margin-top: 20px;
}

script.js:

document.addEventListener('DOMContentLoaded', () => {
    (async () => {
        // 等待所有字体加载完毕
        console.log("等待字体加载...");
        await document.fonts.ready;
        console.log("字体已加载！");

        // 获取Canvas元素
        const canvas = document.getElementById("myCanvas");
        if (!canvas) {
            console.error("无法找到ID为 'myCanvas' 的Canvas元素。");
            return;
        }
        const context = canvas.getContext("2d");

        // 清除Canvas（如果需要）
        context.clearRect(0, 0, canvas.width, canvas.height);

        // 设置文本样式
        context.fillStyle = 'rgba(194,213,219,0.8)'; // 淡蓝色
        context.strokeStyle = 'white'; // 描边颜色
        context.lineWidth = 2; // 描边宽度

        // 确保字体名称用引号括起来
        context.font = "42px 'Press Start 2P'";
        context.textAlign = 'center';
        context.textBaseline = 'middle';

        // 绘制填充文本
        context.fillText('Hello Canvas!', canvas.width / 2, canvas.height / 2);
        // 绘制描边文本
        context.strokeText('Hello Canvas!', canvas.width / 2, canvas.height / 2);

    })().catch(error => {
        console.error("Canvas字体渲染过程中发生错误:", error);
    });
});

注意事项与总结

字体名称引号： 始终记住，如果自定义字体名称包含空格（例如 "Press Start 2P"），在context.font属性中必须用单引号或双引号将其括起来。
异步加载： Web字体是异步加载的。在尝试使用它们绘制Canvas文本之前，务必使用document.fonts.ready来等待字体加载完成。
CSS与Canvas独立： Canvas内部的文本渲染与CSS应用于Canvas父元素的字体样式是独立的。即使父元素显示了正确的自定义字体，Canvas也需要通过context.font属性明确设置并确保字体已加载。
字体回退： 建议在context.font属性中提供一个备用字体，以防自定义字体加载失败或不可用，例如 "42px 'Press Start 2P', monospace"。
性能考虑： 如果在Canvas中频繁绘制大量文本，并且每次绘制都等待document.fonts.ready，可能会引入不必要的延迟。更好的做法是在应用程序初始化时等待一次，确保字体加载完毕后，再进行所有的Canvas绘制操作。