90 lines
2.3 KiB
Lua
90 lines
2.3 KiB
Lua
---------------------------------------------------------------------------
|
|
--- Keep track of the urgent clients.
|
|
--
|
|
-- @author Julien Danjou <julien@danjou.info>
|
|
-- @copyright 2008 Julien Danjou
|
|
-- @release @AWESOME_VERSION@
|
|
-- @submodule client
|
|
---------------------------------------------------------------------------
|
|
|
|
local urgent = {}
|
|
|
|
local capi =
|
|
{
|
|
client = client,
|
|
}
|
|
|
|
local client
|
|
do
|
|
client = setmetatable({}, {
|
|
__index = function(_, k)
|
|
client = require("awful.client")
|
|
return client[k]
|
|
end,
|
|
__newindex = error -- Just to be sure in case anything ever does this
|
|
})
|
|
end
|
|
|
|
local data = setmetatable({}, { __mode = 'k' })
|
|
|
|
--- Get the first client that got the urgent hint.
|
|
--
|
|
-- @function awful.urgent.get
|
|
-- @treturn client.object The first urgent client.
|
|
function urgent.get()
|
|
if #data > 0 then
|
|
return data[1]
|
|
else
|
|
-- fallback behaviour: iterate through clients and get the first urgent
|
|
local clients = capi.client.get()
|
|
for _, cl in pairs(clients) do
|
|
if cl.urgent then
|
|
return cl
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
--- Jump to the client that received the urgent hint first.
|
|
--
|
|
-- @function awful.urgent.jumpto
|
|
-- @tparam bool|function merge If true then merge tags (select the client's
|
|
-- first tag additionally) when the client is not visible.
|
|
-- If it is a function, it will be called with the client as argument.
|
|
function urgent.jumpto(merge)
|
|
local c = client.urgent.get()
|
|
if c then
|
|
client.jumpto(c, merge)
|
|
end
|
|
end
|
|
|
|
--- Adds client to urgent stack.
|
|
--
|
|
-- @function awful.urgent.add
|
|
-- @client c The client object.
|
|
-- @param prop The property which is updated.
|
|
function urgent.add(c, prop)
|
|
if type(c) == "client" and prop == "urgent" and c.urgent then
|
|
table.insert(data, c)
|
|
end
|
|
end
|
|
|
|
--- Remove client from urgent stack.
|
|
--
|
|
-- @function awful.urgent.delete
|
|
-- @client c The client object.
|
|
function urgent.delete(c)
|
|
for k, cl in ipairs(data) do
|
|
if c == cl then
|
|
table.remove(data, k)
|
|
break
|
|
end
|
|
end
|
|
end
|
|
|
|
capi.client.connect_signal("property::urgent", urgent.add)
|
|
capi.client.connect_signal("focus", urgent.delete)
|
|
capi.client.connect_signal("unmanage", urgent.delete)
|
|
|
|
return urgent
|