Class awful.widget.tasklist
Tasklist widget module for awful.
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 <julien@danjou.info>
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_tasklist_disable_icon | Disable the tasklist client icons. |
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 (updatefunction
and basewidget) serve to customize the layout of the tasklist (eg. to
make it vertical). For that, you will need to copy the
awful.widget.common.listupdate function, make your changes to it
and pass it as updatefunction 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)
- 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_tasklist_disable_icon
-
Disable the tasklist client icons.
Type:
- tasklist_disable_icon 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:
- font string (default nil)
- 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 tags. (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: