ironbar/docs/modules/Focused.md

3.5 KiB

Note

This module requires a wlroots-based compositor. It will not work without the wlr-foreign-toplevel-management protocol.

Displays the title and/or icon of the currently focused window.

Screenshot of focused widget, showing this page open on firefox

Configuration

Type: focused

Name Type Default Description
show_icon boolean true Whether to show the app's icon.
show_title boolean true Whether to show the app's title.
icon_size integer 32 Size of icon in pixels.
truncate 'start' or 'middle' or 'end' or Map null The location of the ellipses and where to truncate text from. Leave null to avoid truncating. Use the long-hand Map version if specifying a length.
truncate.mode 'start' or 'middle' or 'end' null The location of the ellipses and where to truncate text from. Leave null to avoid truncating.
truncate.length integer null The fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.
truncate.max_length integer null The maximum number of characters before truncating. Leave blank to let GTK automatically handle.
JSON
{
  "end": [
    {
      "type": "focused",
      "show_icon": true,
      "show_title": true,
      "icon_size": 32,
      "truncate": "end"
    }
  ]
}

TOML
[[end]]
type = "focused"
show_icon = true
show_title = true
icon_size = 32
truncate = "end"
YAML
end:
  - type: "focused"
    show_icon: true
    show_title: true
    icon_size: 32
    truncate: "end"
Corn
{
  end = [
    {
      type = "focused"
      show_icon = true
      show_title = true
      icon_size = 32
      truncate = "end"
    }
  ]
}

Styling

Selector Description
.focused Focused widget box
.focused .icon App icon
.focused .label App name

For more information on styling, please see the styling guide.