CSSHoudiniPaintAPI自定义背景教程

CSS Houdini 的 Paint API 为前端开发者打开了一扇新大门：无需依赖图片或 SVG，就能用 JavaScript 在 CSS 中动态、高性能地绘制任意背景图案——从可配置的圆点阵列到复杂渐变纹理，只需注册一个 Worklet 模块、定义带响应式属性的 Painter 类，并在 CSS 中调用 `paint()` 函数即可实现；更令人惊喜的是，修改自定义 CSS 属性（如 `--circle-color`）会自动触发重绘，真正做到了声明式语法与脚本能力的无缝融合，虽目前主要支持 Chromium 系浏览器，却已展现出下一代样式定制的强大潜力。

可以直接在 CSS 中使用 JavaScript 动态绘制背景图像，这正是 CSS Houdini 的 Paint API 提供的能力。它允许开发者定义自定义的绘图逻辑，并像普通 background-image 一样使用。

注册一个 Paint Worklet

Paint API 运行在独立的 Worklet 线程中，需要先注册一个 worklet 模块：

在 HTML 或 JS 中加载 worklet：

navigator.credentials.get("paint").then(() => {
  // 注册 paint worklet
});

实际写法是：

CSS.paintWorklet.addModule('my-painter.js');

确保服务器支持 MIME 类型，且文件路径正确。

编写自定义 Painter 类

创建 my-painter.js 文件，导出一个类实现 paint 方法：

class MyBackgroundPainter {
  // 定义可配置的属性（可选）
  static get inputProperties() {
    return ['--circle-color', '--circle-size'];
  }
paint(ctx, geometry, properties) {
const { width, height } = geometry;
const color = properties.get('--circle-color').toString() || 'blue';
const size = parseFloat(properties.get('--circle-size').value) || 20;
// 绘制多个圆形作为背景
ctx.fillStyle = color;
for (let x = 0; x < width; x += size * 2) {
  for (let y = 0; y < height; y += size * 2) {
    ctx.beginPath();
    ctx.arc(x, y, size, 0, Math.PI * 2);
    ctx.fill();
  }
}
}
}
// 注册这个 painter
registerPaint('myBackground', MyBackgroundPainter);

在 CSS 中使用自定义背景

一旦注册成功，就可以在 CSS 中使用 paint() 函数：

.custom-bg {
  background: paint(myBackground);
  --circle-color: #ff6b6b;
  --circle-size: 15;
  width: 300px;
  height: 300px;
}

页面元素应用该 class 后，就会显示用 JavaScript 绘制的圆点背景。

支持响应式与动态更新

Paint API 会自动监听依赖的 CSS 属性变化。只要修改自定义属性，背景就会重绘：

document.querySelector('.custom-bg').style.setProperty('--circle-color', 'green');

浏览器会触发重绘，无需手动刷新。

基本上就这些。只要注意兼容性（目前主要在 Chromium 内核中支持），Paint API 是实现高性能、可配置图形背景的强大方式。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《CSSHoudiniPaintAPI自定义背景教程》文章吧，也可关注golang学习网公众号了解相关技术文章。