ironbar/docs/modules/Focused.md
Jake Stanger ca4fe422f2
feat(truncate): ability to set fixed length
BREAKING CHANGE: This changes the behaviour of `truncate.length`. A new property, `truncate.max_length`, has been introduced that uses the old behaviour.
2023-02-25 14:26:02 +00:00

3.2 KiB

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