Module awful.widget.taglist

Taglist widget module for awful

Author:

Julien Danjou <julien@danjou.info>

Copyright© 2008-2009 Julien Danjou

Release: v3.3.4

Functions

gettag (widget) Get the tag object the given widget appears on.
label.all (t, args) Return labels for a taglist widget with all tag from screen.
label.noempty (t, args) Return labels for a taglist widget with all *non empty* tags from screen.
new (screen, label, buttons) Create a new taglist widget.


Functions

gettag (widget)
Get the tag object the given widget appears on.

Parameters

  • widget: The widget the look for.

Return value:

The tag object.
label.all (t, args)
Return labels for a taglist widget with all tag from screen. It returns the tag name and set a special foreground and background color for selected tags.

Parameters

  • t: The tag.
  • args: The arguments table. bg_focus The background color for selected tag. fg_focus The foreground color for selected tag. bg_urgent The background color for urgent tags. fg_urgent The foreground color for urgent tags. squares_sel Optional: a user provided image for selected squares. squares_unsel Optional: a user provided image for unselected squares. squares_resize Optional: true or false to resize squares.

Return value:

A string to print, a background color, a background image and a background resize value.
label.noempty (t, args)
Return labels for a taglist widget with all *non empty* tags from screen. It returns the tag name and set a special foreground and background color for selected tags.

Parameters

  • t: The tag.
  • args: The arguments table. bg_focus The background color for selected tag. fg_focus The foreground color for selected tag. bg_urgent The background color for urgent tags. fg_urgent The foreground color for urgent tags.

Return value:

A string to print, a background color, a background image and a background resize value.
new (screen, label, buttons)
Create a new taglist widget.

Parameters

  • screen: The screen to draw tag list for.
  • label: Label function to use.
  • buttons: A table with buttons binding to set.

Valid XHTML 1.0!