AwesomeWM中wibox的input_passthrough设置异常问题咨询

问题背景 #

你想要实现一个侧边栏：鼠标触达屏幕左边缘时显示，离开侧边栏扩展区域后隐藏。为此你创建了三个wibox：

• 1像素宽的触发栏（监听mouse::enter显示侧边栏）
• 实际侧边栏组件
• 比侧边栏宽100px的透明区域（sidebar_visible_limit），意图监听mouse::leave来隐藏侧边栏，同时设置input_passthrough=true让输入穿透到下方窗口

但遇到了两难的异常：

• 若构造后单独设置bar.sidebar_visible_limit.input_passthrough=true：穿透功能正常，但该组件无法检测mouse::leave信号，无法触发隐藏
• 若将参数放入构造函数：mouse::leave正常响应，但input_passthrough失效，无法穿透输入到下方内容

原因解析 #

这个矛盾的核心是AwesomeWM中input_passthrough属性的设计逻辑：

• input_passthrough=true的本质是让wibox完全放弃所有输入事件的处理权，所有鼠标/键盘事件都会直接传递给下方的窗口。这意味着设置该属性后，wibox无法再监听任何mouse::*或key::*信号——这是预期行为，不是bug。
• 构造时设置该属性却能触发mouse::leave，是因为AwesomeWM初始化wibox时，ontop和input_passthrough的处理顺序存在冲突：输入事件监听没有被正确禁用，但同时穿透功能也失效了，属于初始化阶段的异常情况。
• 构造后设置该属性，wibox已经完成输入事件系统的初始化，此时设置input_passthrough=true会正确禁用所有输入处理，所以mouse::leave无法触发，但穿透功能正常。

修复方案：换一种方式检测鼠标离开范围 #

既然input_passthrough和输入事件监听无法同时生效，我们可以抛弃用额外wibox监听mouse::leave的思路，改用全局鼠标位置监控来实现需求：

步骤1：移除sidebar_visible_limit的事件监听和input_passthrough设置

步骤2：添加全局鼠标位置监控逻辑

我们可以用gears.timer结合侧边栏的mouse::enter/mouse::leave信号，实现延迟检查鼠标位置的逻辑，避免误触发的同时精准判断是否需要隐藏侧边栏。

修改后的完整代码示例

awful = require("awful")
local wibox = require("wibox")
local naughty = require("naughty")
local gears = require("gears")
local beautiful = require("beautiful")
xresources = require("beautiful.xresources")
dpi = xresources.apply_dpi

bar = {}

-- 实际侧边栏组件
bar.sidebar = wibox({ 
    x = 0, 
    y = 0, 
    ontop = false, 
    visible = false, 
    width = beautiful.sidebar_width or dpi(450), 
    bg = beautiful.sidebar_bg or "#2f2e3a", 
    type = "dock", 
    height = beautiful.sidebar_height or awful.screen.focused().geometry.height, 
})

-- 左侧边缘触发栏（用于显示侧边栏）
local sidebar_displayer = wibox({ 
    x = 0, 
    y = 0, 
    height = bar.sidebar.height, 
    ontop = true, 
    width = 1, 
    visible = true, 
    opacity = 0, 
    input_passthrough = true 
})

-- 用于延迟隐藏的定时器（避免鼠标快速移动误触发）
local hide_timer = gears.timer({
    timeout = 0.1,
    autostart = false,
    single_shot = true,
    callback = function()
        local mouse_x = mouse.coords().x
        -- 当鼠标超出侧边栏+100px的范围时隐藏
        if mouse_x > bar.sidebar.width + dpi(100) then
            bar.sidebar.visible = false
            bar.sidebar.ontop = false
        end
    end
})

function toggle_bar()
    bar.sidebar.visible = not bar.sidebar.visible
    bar.sidebar.ontop = not bar.sidebar.ontop

    -- 如果显示侧边栏，绑定鼠标监控信号；如果隐藏，解绑信号避免内存泄漏
    if bar.sidebar.visible then
        -- 鼠标离开侧边栏时启动延迟检查
        bar.sidebar:connect_signal("mouse::leave", function()
            hide_timer:start()
        end)
        -- 鼠标回到侧边栏时取消延迟隐藏
        bar.sidebar:connect_signal("mouse::enter", function()
            hide_timer:stop()
        end)
    else
        bar.sidebar:disconnect_signal("mouse::leave", nil)
        bar.sidebar:disconnect_signal("mouse::enter", nil)
        hide_timer:stop()
    end
end

-- 触发栏的显示信号
sidebar_displayer:connect_signal("mouse::enter", toggle_bar)

方案优势

1. 不需要额外的sidebar_visible_limit组件，减少资源占用
2. 完全避免了input_passthrough的矛盾问题，输入可以正常穿透到侧边栏和下方窗口
3. 延迟定时器可以避免鼠标快速移动时的误隐藏

内容的提问来源于stack exchange，提问作者LawsDontApplyToPigs