给桌面便签修圆角灰边:从 CSS 查到 Windows 合成层

7D0513EC416DC203EC01459790542725

最近给自己的便签软件 MyNotes 修了一个挺磨人的小问题:便签钉到桌面后,四个圆角外面会露出灰色的小块。

image

便签本身有半透明、亚克力模糊和自定义颜色。正常看起来应该像一块磨砂玻璃,灰边一出来,就很像圆角后面还垫着一个没裁干净的矩形。面积不大,但每天都能看到,很影响观感。

最后采用的方案是:桌面窗口交给 Windows 处理系统圆角,内部内容保持完整矩形,保留原来的 Acrylic 和透明度。 应用内的便签卡片仍然可以自定义圆角。

这次排查是在 AI 协助下完成的。比最后几行代码更值得记录的,是中间怎样判断问题、怎样发现“已经修好”的结论其实站不住。

内容圆了,系统材质未必跟着圆

MyNotes 用 Electron 做桌面窗口,内容由 HTML 和 CSS 渲染,玻璃效果里又有 Windows 提供的原生 Acrylic。

这意味着,页面内容的圆角和系统背景材质并不完全由同一个东西决定。给内容设置 border-radius,能改变页面里看到的形状,却不能直接据此判断系统合成出来的窗口也被同样裁好了。

Electron 上游有一个相近的讨论:维护者指出,用 CSS 圆角留下的透明区域,仍可能被应用背景材质。这个解释与我这里的现象相符,也让排查方向从样式转向了窗口和系统合成层。Electron #47510

这里需要区分一下:这是结合上游讨论和本地实验对现象做出的判断,并不是拿到了 DWM 内部渲染过程的完整追踪。

第一轮验证走了弯路

排查中尝试过通过 Windows 窗口区域来裁切圆角,也就是 CreateRoundRectRgn 和 SetWindowRgn 这条路线。

当时检查区域参数,确实能得到“角落不在有效区域里”的结果。单看这些数据,很容易觉得裁切已经生效,问题应该解决了。

但实际打开便签,灰角还在。

这一步最大的教训是:窗口区域检查通过,只能说明这个接口返回了符合预期的数据,不能替代最终画面的验收。

尤其是透明窗口叠加原生材质时,页面截图、窗口区域和用户桌面上实际看到的合成结果,需要分开判断。后来真正有用的证据,来自实际桌面合成画面。

最后把圆角交回系统

继续试验时,有些处理能让灰块不明显,却会改变模糊或者材质表现。我的便签本来就强调透明和亚克力效果,这种交换不符合目标。

最终选择了 Windows 的原生圆角偏好。实现思路分成三步:

  1. 清除先前设置的自定义窗口区域。
  2. 通过 DwmSetWindowAttribute 设置系统圆角偏好。
  3. 关闭额外的系统边框线,保留便签自己的玻璃边框。

Electron 主进程里通过 Koffi 调用这些 Windows API。下面用原生 API 写出核心调用关系,省略句柄获取、错误处理和重复更新缓存:

SetWindowRgn(hwnd, nullptr, TRUE);

DWM_WINDOW_CORNER_PREFERENCE corners = userRadius == 0
    ? DWMWCP_DONOTROUND
    : DWMWCP_ROUND;

DwmSetWindowAttribute(
    hwnd, DWMWA_WINDOW_CORNER_PREFERENCE,
    &corners, sizeof(corners)
);

COLORREF border = DWMWA_COLOR_NONE;
DwmSetWindowAttribute(
    hwnd, DWMWA_BORDER_COLOR,
    &border, sizeof(border)
);

其中,DWMWA_WINDOW_CORNER_PREFERENCE 对应属性 33;DWMWA_BORDER_COLOR 对应属性 34。DWMWA_COLOR_NONE 的值是 0xFFFFFFFE,用于取消系统边框的绘制。它处理的是额外边框线,消除灰角还需要前面的窗口区域与圆角处理一起配合。微软 DWM 属性文档

页面内部则恢复完整矩形,不再用另一套 CSS 圆角额外挖掉透明角。这样在本项目当前的窗口配置下,系统圆角与材质的最终显示终于协调了。

image

原有的 setBackgroundMaterial('acrylic') 和透明度逻辑继续保留,没有靠关掉磨砂效果来让问题“消失”。

有一个明确的取舍

系统圆角不提供任意像素半径。因此,这次也调整了桌面窗口的定制规则:

  • 圆角设为 0,桌面便签保持直角。
  • 圆角大于 0,桌面便签采用系统圆角。
  • 应用内的卡片继续支持原有自定义圆角。

这个取舍经过了确认。对桌面窗口来说,先把灰角修好、保留玻璃效果,比强行让任意半径在所有绘制层里同步更重要。

也不能把这套调用当成万能开关。微软说明,圆角偏好是给系统的提示,并不保证任何自定义窗口都能变圆;窗口区域、逐像素透明等配置也会影响适用性。这里记录的是本项目在实际测试配置下有效的方案,换 Electron 版本或窗口样式后仍需要重新验证。Windows 11 圆角说明

这次怎样确认真的修好了

第二轮不再只看接口参数,而是用虚构内容的独立测试便签,检查实际桌面合成后的画面。

覆盖了聚焦、失焦、置顶定时器执行后、35% 和 100% 透明度,以及调整窗口大小等情况。测试中灰块没有再出现,原生 Acrylic 的开启状态也保持正常。

在固定深色背景的一组前后对照里,旧方案角落的 RGB 约为 (58, 64, 76),新方案角落露出背景,数值约为 (20, 26, 37);便签中心的颜色前后相同。这些数值只用于这组固定场景的比较,不是所有壁纸下都该满足的标准。

此外,主进程的窗口创建与原生属性改动,需要完整退出旧进程再运行 npm start。如果旧窗口还活着,看见的可能仍是旧实现。

这次修复让我更在意验收证据对应的是哪一层:样式算对了、窗口区域返回正确、原生属性设置成功,都各有价值。最终要交付的,仍然是用户桌面上那块没有灰角、保留了磨砂效果的便签。

最后发张大肥鱼图片

HTmXAbHbkAAl1FQ