1
0
Fork 0
mirror of https://github.com/Zedfrigg/ironbar.git synced 2025-04-19 11:24:24 +02:00
ironbar/docs/modules/Clock.md
Jake Stanger dea66415c2
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

2.1 KiB

Displays the current date and time. Clicking on the widget opens a popup with the time and a calendar.

Screenshot of clock widget with popup open

Configuration

Type: clock

Name Type Default Description
format string %d/%m/%Y %H:%M Date/time format string. Detail on available tokens can be found here: https://docs.rs/chrono/latest/chrono/format/strftime/index.html
JSON
{
  "end": [
    {
      "type": "clock",
      "format": "%d/%m/%Y %H:%M"
    }
  ]
}

TOML
[[end]]
type = "clock"
format = "%d/%m/%Y %H:%M"
YAML
end:
  - type: "clock"
    format: "%d/%m/%Y %H:%M"
Corn
{
  end = [
    {
      type = "clock"
      format = "%d/%m/%Y %H:%M"
    }
  ]
}

Styling

Selector Description
.clock Clock widget button
.popup-clock Clock popup box
.popup-clock .calendar-clock Clock inside the popup
.popup-clock .calendar Calendar widget inside the popup. GTK provides some OOTB styling options for this.

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