Niri窗口管理器中光标隐藏功能对工具提示的影响分析

在Niri窗口管理器最新版本中，引入了一项实用的光标隐藏功能，通过hide-after-inactive-ms和hide-when-typing参数可以实现在用户不活动或输入时自动隐藏鼠标光标。这项功能虽然提升了用户体验，但也带来了一个值得注意的技术问题：当光标被隐藏时，Waybar等应用的工具提示(tooltip)会意外消失。

问题本质

这个问题的核心在于光标隐藏时窗口管理器如何处理指针焦点事件。目前Niri的实现方式是立即发送指针离开(pointer leave)事件，这导致依赖指针悬停检测的应用（如工具提示）误判为光标已经离开，从而提前关闭提示内容。

技术背景

在Wayland协议中，指针焦点管理是一个关键交互机制。当光标移动到一个窗口上方时，窗口管理器会通知该客户端获得指针焦点。传统桌面环境中，即使光标被隐藏，焦点状态通常会被保留，直到光标实际移动到其他位置。

影响范围

这个问题不仅限于Waybar工具提示，还影响到了多种常见应用：

• 浏览器（Chrome/Firefox）中的链接悬停效果
• VSCode/VSCodium等编辑器的工具提示
• 其他依赖悬停检测的UI元素

值得注意的是，使用独立GUI工具包（如Zed使用的gpui）的应用不受此影响，这表明问题与特定GUI框架的事件处理机制有关。

解决方案

正确的实现方式应该是在隐藏光标时保持当前的指针焦点状态，而不是立即发送指针离开事件。这与Sway窗口管理器的处理方式一致，后者仅将光标替换为空图像而不改变焦点状态。

Niri开发团队已经确认将在后续版本中修复这个问题，方案包括：

1. 保持指针焦点不变直到实际改变
2. 仅修改光标可见性而不干扰焦点状态
3. 处理各种边缘情况确保兼容性

技术启示

这个案例展示了窗口管理器与客户端应用交互时的一个微妙但重要的细节。在实现类似功能时，开发者需要考虑：

• 焦点状态与视觉反馈的分离
• 不同客户端应用对协议事件的处理差异
• 向后兼容性和用户体验的一致性

随着Wayland生态系统的成熟，这类交互细节的标准化将变得越来越重要，以确保不同组件间的无缝协作。