Reference

# Module `awful.widget.tasklist`

Tasklist widget module for awful

Author:

Julien Danjou <julien@danjou.info>

Copyright© 2008-2009 Julien Danjou

Release: v3.4.13

## Functions

label.allscreen (c, screen, args) | Return labels for a tasklist widget with clients from all tags and screen.
label.alltags (c, screen, args) | Return labels for a tasklist widget with clients from all tags.
label.currenttags (c, screen, args) | Return labels for a tasklist widget with clients from currently selected tags.
label.focused (c, screen, args) | Return label for only the currently focused client.
new (label, buttons) | Create a new tasklist widget.

## Functions

label.allscreen (c, screen, args)
  Return labels for a tasklist widget with clients from all tags and screen. It returns the client name and set a special foreground and background color for focused client. It also puts a special icon for floating windows.

  ### Parameters

  - c: The client.
  - screen: The screen we are drawing on.
  - args: The arguments table. bg_focus The background color for focused client. fg_focus The foreground color for focused client. bg_urgent The background color for urgent clients. fg_urgent The foreground color for urgent clients.

  ### Return value:

  A string to print, a background color and a status image.
label.alltags (c, screen, args)
  Return labels for a tasklist widget with clients from all tags. It returns the client name and set a special foreground and background color for focused client. It also puts a special icon for floating windows.

  ### Parameters

  - c: The client.
  - screen: The screen we are drawing on.
  - args: The arguments table. bg_focus The background color for focused client. fg_focus The foreground color for focused client. bg_urgent The background color for urgent clients. fg_urgent The foreground color for urgent clients.

  ### Return value:

  A string to print, a background color and a status image.
label.currenttags (c, screen, args)
  Return labels for a tasklist widget with clients from currently selected tags. It returns the client name and set a special foreground and background color for focused client. It also puts a special icon for floating windows.

  ### Parameters

  - c: The client.
  - screen: The screen we are drawing on.
  - args: The arguments table. bg_focus The background color for focused client. fg_focus The foreground color for focused client. bg_urgent The background color for urgent clients. fg_urgent The foreground color for urgent clients.

  ### Return value:

  A string to print, a background color and a status image.
label.focused (c, screen, args)
  Return label for only the currently focused client. It returns the client name and set a special foreground and background color for focused client. It also puts a special icon for floating windows.

  ### Parameters

  - c: The client.
  - screen: The screen we are drawing on.
  - args: The arguments table. bg_focus The background color for focused client. fg_focus The foreground color for focused client. bg_urgent The background color for urgent clients. fg_urgent The foreground color for urgent clients.

  ### Return value:

  A string to print, a background color and a status image.
new (label, buttons)
  Create a new tasklist widget.

  ### Parameters

  - label: Label function to use.
  - buttons: A table with buttons binding to set.