Class awful.widget.tasklist

Tasklist widget module for awful.

Status icons:

By default, the tasklist prepends some symbols in front of the client name. This is used to notify that the client has some specific properties that are currently enabled. This can be disabled using beautiful.tasklist_plain_task_name=true in the theme.

Icon Client property
sticky
ontop
above
below
floating
+maximized
maximized_horizontal
maximized_vertical

Info:

  • Copyright: 2008-2009 Julien Danjou
  • Author: Julien Danjou <[email protected]>

Functions

awful.tasklist (screen, filter, buttons[, style={}[, update_function=nil[, base_widget=nil]]]) Create a new tasklist widget.
tasklist.filter.allscreen () Filtering function to include all clients.
tasklist.filter.alltags (c, screen) Filtering function to include the clients from all tags on the screen.
tasklist.filter.currenttags (c, screen) Filtering function to include only the clients from currently selected tags.
tasklist.filter.minimizedcurrenttags (c, screen) Filtering function to include only the minimized clients from currently selected tags.
tasklist.filter.focused (c, screen) Filtering function to include only the currently focused client.

Theme variables

beautiful.tasklist_fg_normal The default foreground (text) color.
beautiful.tasklist_bg_normal The default background color.
beautiful.tasklist_fg_focus The focused client foreground (text) color.
beautiful.tasklist_bg_focus The focused client background color.
beautiful.tasklist_fg_urgent The urgent clients foreground (text) color.
beautiful.tasklist_bg_urgent The urgent clients background color.
beautiful.tasklist_fg_minimize The minimized clients foreground (text) color.
beautiful.tasklist_bg_minimize The minimized clients background color.
beautiful.tasklist_bg_image_normal The elements default background image.
beautiful.tasklist_bg_image_focus The focused client background image.
beautiful.tasklist_bg_image_urgent The urgent clients background image.
beautiful.tasklist_bg_image_minimize The minimized clients background image.
beautiful.tasklist_disable_icon Disable the tasklist client icons.
beautiful.tasklist_disable_task_name Disable the tasklist client titles.
beautiful.tasklist_plain_task_name Disable the extra tasklist client property notification icons.
beautiful.tasklist_font The tasklist font.
beautiful.tasklist_align The focused client alignment.
beautiful.tasklist_font_focus The focused client title alignment.
beautiful.tasklist_font_minimized The minimized clients font.
beautiful.tasklist_font_urgent The urgent clients font.
beautiful.tasklist_spacing The space between the tasklist elements.
beautiful.tasklist_shape The default tasklist elements shape.
beautiful.tasklist_shape_border_width The default tasklist elements border width.
beautiful.tasklist_shape_border_color The default tasklist elements border color.
beautiful.tasklist_shape_focus The focused client shape.
beautiful.tasklist_shape_border_width_focus The focused client border width.
beautiful.tasklist_shape_border_color_focus The focused client border color.
beautiful.tasklist_shape_minimized The minimized clients shape.
beautiful.tasklist_shape_border_width_minimized The minimized clients border width.
beautiful.tasklist_shape_border_color_minimized The minimized clients border color.
beautiful.tasklist_shape_urgent The urgent clients shape.
beautiful.tasklist_shape_border_width_urgent The urgent clients border width.
beautiful.tasklist_shape_border_color_urgent The urgent clients border color.


Functions

Methods
awful.tasklist (screen, filter, buttons[, style={}[, update_function=nil[, base_widget=nil]]])
Create a new tasklist widget. The last two arguments (update_function and base_widget) serve to customize the layout of the tasklist (eg. to make it vertical). For that, you will need to copy the awful.widget.common.list_update function, make your changes to it and pass it as update_function here. Also change the base_widget if the default is not what you want.
  • screen The screen to draw tasklist for.
  • filter Filter function to define what clients will be listed.
  • buttons A table with buttons binding to set.
  • style The style overrides default theme.
    • fg_normal string or pattern (default nil)
    • bg_normal string or pattern (default nil)
    • fg_focus string or pattern (default nil)
    • bg_focus string or pattern (default nil)
    • fg_urgent string or pattern (default nil)
    • bg_urgent string or pattern (default nil)
    • fg_minimize string or pattern (default nil)
    • bg_minimize string or pattern (default nil)
    • bg_image_normal string (default nil)
    • bg_image_focus string (default nil)
    • bg_image_urgent string (default nil)
    • bg_image_minimize string (default nil)
    • tasklist_disable_icon boolean (default nil)
    • disable_task_name boolean (default false)
    • font string (default nil)
    • align string left, right or center (default left)
    • font_focus string (default nil)
    • font_minimized string (default nil)
    • font_urgent string (default nil)
    • spacing number The spacing between tags. (default nil)
    • shape gears.shape (default nil)
    • shape_border_width number (default nil)
    • shape_border_color string or color (default nil)
    • shape_focus gears.shape (default nil)
    • shape_border_width_focus number (default nil)
    • shape_border_color_focus string or color (default nil)
    • shape_minimized gears.shape (default nil)
    • shape_border_width_minimized number (default nil)
    • shape_border_color_minimized string or color (default nil)
    • shape_urgent gears.shape (default nil)
    • shape_border_width_urgent number (default nil)
    • shape_border_color_urgent string or color (default nil)
  • update_function Function to create a tag widget on each update. See awful.widget.common.list_update. (optional)
  • base_widget table Container widget for tag widgets. Default is wibox.layout.flex.horizontal. (optional)
tasklist.filter.allscreen ()
Filtering function to include all clients.

Returns:

    true
tasklist.filter.alltags (c, screen)
Filtering function to include the clients from all tags on the screen.
  • c The client.
  • screen The screen we are drawing on.

Returns:

    true if c is on screen, false otherwise
tasklist.filter.currenttags (c, screen)
Filtering function to include only the clients from currently selected tags.
  • c The client.
  • screen The screen we are drawing on.

Returns:

    true if c is in a selected tag on screen, false otherwise
tasklist.filter.minimizedcurrenttags (c, screen)
Filtering function to include only the minimized clients from currently selected tags.
  • c The client.
  • screen The screen we are drawing on.

Returns:

    true if c is in a selected tag on screen and is minimized, false otherwise
tasklist.filter.focused (c, screen)
Filtering function to include only the currently focused client.
  • c The client.
  • screen The screen we are drawing on.

Returns:

    true if c is focused on screen, false otherwise

Theme variables

beautiful.tasklist_fg_normal
The default foreground (text) color.

Type:

  • fg_normal string or pattern (default nil)

See also:

beautiful.tasklist_bg_normal
The default background color.

Type:

  • bg_normal string or pattern (default nil)

See also:

beautiful.tasklist_fg_focus
The focused client foreground (text) color.

Type:

  • fg_focus string or pattern (default nil)

See also:

beautiful.tasklist_bg_focus
The focused client background color.

Type:

  • bg_focus string or pattern (default nil)

See also:

beautiful.tasklist_fg_urgent
The urgent clients foreground (text) color.

Type:

  • fg_urgent string or pattern (default nil)

See also:

beautiful.tasklist_bg_urgent
The urgent clients background color.

Type:

  • bg_urgent string or pattern (default nil)

See also:

beautiful.tasklist_fg_minimize
The minimized clients foreground (text) color.

Type:

  • fg_minimize string or pattern (default nil)

See also:

beautiful.tasklist_bg_minimize
The minimized clients background color.

Type:

  • bg_minimize string or pattern (default nil)

See also:

beautiful.tasklist_bg_image_normal
The elements default background image.

Type:

  • bg_image_normal string (default nil)
beautiful.tasklist_bg_image_focus
The focused client background image.

Type:

  • bg_image_focus string (default nil)
beautiful.tasklist_bg_image_urgent
The urgent clients background image.

Type:

  • bg_image_urgent string (default nil)
beautiful.tasklist_bg_image_minimize
The minimized clients background image.

Type:

  • bg_image_minimize string (default nil)
beautiful.tasklist_disable_icon
Disable the tasklist client icons.

Type:

  • tasklist_disable_icon boolean (default false)
beautiful.tasklist_disable_task_name
Disable the tasklist client titles.

Type:

  • tasklist_disable_task_name boolean (default false)
beautiful.tasklist_plain_task_name
Disable the extra tasklist client property notification icons.

See the Status icons section for more details.

Type:

  • tasklist_plain_task_name boolean (default false)
beautiful.tasklist_font
The tasklist font.

Type:

beautiful.tasklist_align
The focused client alignment.

Type:

  • align string left, right or center (default left)
beautiful.tasklist_font_focus
The focused client title alignment.

Type:

  • font_focus string (default nil)
beautiful.tasklist_font_minimized
The minimized clients font.

Type:

  • font_minimized string (default nil)
beautiful.tasklist_font_urgent
The urgent clients font.

Type:

  • font_urgent string (default nil)
beautiful.tasklist_spacing
The space between the tasklist elements.

Type:

  • spacing number The spacing between tasks. (default 0)
beautiful.tasklist_shape
The default tasklist elements shape.

Type:

  • shape gears.shape (default nil)
beautiful.tasklist_shape_border_width
The default tasklist elements border width.

Type:

  • shape_border_width number (default 0)
beautiful.tasklist_shape_border_color
The default tasklist elements border color.

Type:

  • shape_border_color string or color (default nil)

See also:

beautiful.tasklist_shape_focus
The focused client shape.

Type:

  • shape_focus gears.shape (default nil)
beautiful.tasklist_shape_border_width_focus
The focused client border width.

Type:

  • shape_border_width_focus number (default 0)
beautiful.tasklist_shape_border_color_focus
The focused client border color.

Type:

  • shape_border_color_focus string or color (default nil)

See also:

beautiful.tasklist_shape_minimized
The minimized clients shape.

Type:

  • shape_minimized gears.shape (default nil)
beautiful.tasklist_shape_border_width_minimized
The minimized clients border width.

Type:

  • shape_border_width_minimized number (default 0)
beautiful.tasklist_shape_border_color_minimized
The minimized clients border color.

Type:

  • shape_border_color_minimized string or color (default nil)

See also:

beautiful.tasklist_shape_urgent
The urgent clients shape.

Type:

  • shape_urgent gears.shape (default nil)
beautiful.tasklist_shape_border_width_urgent
The urgent clients border width.

Type:

  • shape_border_width_urgent number (default 0)
beautiful.tasklist_shape_border_color_urgent
The urgent clients border color.

Type:

  • shape_border_color_urgent string or color (default nil)

See also:

generated by LDoc 1.4.6 Last updated 2017-04-24 08:13:02