ironbar/docs/modules/Focused.md at dea66415c2e11e34ba44d016aaa6cfb4ef7b9f9b

mirror of https://github.com/Zedfrigg/ironbar.git synced 2025-04-19 11:24:24 +02:00

feat: module-level name and class options

BREAKING CHANGE: To allow for the `name` property, any widgets that were previously targeted by name should be targeted by class instead. This affects **all modules and all popups**, as well as several widgets inside modules. **This will break a lot of rules in your stylesheet**. To attempt to mitigate the damage, a migration script can be found [here](https://raw.githubusercontent.com/JakeStanger/ironbar/master/scripts/migrate-styles.sh) that should get you most of the way.

Resolves #75.

2023-05-06 13:22:35 +01:00

3.3 KiB

Raw Blame History

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

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.

3.3 KiB Raw Blame History

Configuration

Styling

3.3 KiB

Raw Blame History