bling/docs/widgets/tabbed_misc.md

🧱 Tabbed Miscellaneous

This comprises a few widgets to better represent tabbed groups (from the tabbed module) in your desktop. The widgets currently included are:

• Titlebar Indicator
• Tasklist

Titlebar Indicator

Usage

To use the task list indicator: NOTE: Options can be set as theme vars under the table theme.bling_tabbed_misc_titlebar_indicator

bling.widget.tabbed_misc.titlebar_indicator(client, {
    layout_spacing = dpi(5), -- Set spacing in between items
    icon_size = dpi(24),
    icon_margin = 0,
    bg_color_focus = "#282828", -- Color for the focused items
    bg_color = "#1d2021", -- Color for normal / unfocused items
    icon_shape = gears.shape.circle -- Set icon shape,
})

a widget_template option is also available:

bling.widget.tabbed_misc.titlebar_indicator(client, {
    widget_template = {
        {
            widget = awful.widget.clienticon,
            id = 'icon_role'
        },
        widget = wibox.container.margin,
        margins = 2,
        id = 'click_role'
    }
})

Example Implementation

You normally embed the widget in your titlebar...

awful.titlebar(c).widget = {
        { -- Left
            bling.widget.tabbed_misc.titlebar_indicator(c),
            layout  = wibox.layout.fixed.horizontal
        },
        { -- Middle
            { -- Title
                align  = "center",
                widget = awful.titlebar.widget.titlewidget(c)
            },
            buttons = buttons,
            layout  = wibox.layout.flex.horizontal
        },
        { -- Right
            awful.titlebar.widget.maximizedbutton(c),
            awful.titlebar.widget.closebutton    (c),
            layout = wibox.layout.fixed.horizontal
        },
        layout = wibox.layout.align.horizontal
    }

Tasklist

The module exports a function that can be added to your tasklist as a update_callback

Usage

awful.widget.tasklist({
            screen = s,
            filter = awful.widget.tasklist.filter.currenttags,
            layout = {
                spacing = dpi(10),
                layout = wibox.layout.fixed.vertical,
            },
            style = {
                bg_normal = "#00000000",
            },
            widget_template = {
                {
                    {
                        widget = wibox.widget.imagebox,
                        id = "icon_role",
                        align = "center",
                        valign = "center",
                    },
                    width = dpi(24),
                    height = dpi(24),
                    widget = wibox.container.constraint,
                },
                widget = wibox.container.background, -- IT MUST BE A CONTAINER WIDGET AS THAT IS WHAT THE FUNCTION EXPECTS
                update_callback = require("bling.widget.tabbed_misc").custom_tasklist,
                id = "background_role",
            },
        })

If you need to do something else, it can be used like so

update_callback = function(self, client, index, clients)
    require("bling.widget.tabbed_misc").custom_tasklist(self, client, index, clients)
    require("naughty").notify({ text = "Tasklist was updated" })
end