Reference

# Module `awful.widget.taglist`

Taglist widget module for awful

Author:

Julien Danjou <julien@danjou.info>

Copyright© 2008-2009 Julien Danjou

Release: v3.4.9

## 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.