ironbar/docs/modules/Clipboard.md
2023-06-29 16:26:55 +01:00

4.5 KiB

Shows recent clipboard items, allowing you to switch between them to re-copy previous values. Clicking the icon button opens the popup containing all functionality.

Supports plain text and images.

Screenshot of clipboard popup open, with two textual values and an image copied. Several other unrelated widgets are visible on the bar.

Configuration

Type: clipboard

Name Type Default Description
icon string or image 󰨸 Icon to show on the widget button.
icon_size integer 32 Size to render icon at (image icons only).
max_items integer 10 Maximum number of items to show in the popup.
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": "clipboard",
    "max_items": 3,
    "truncate": {
      "mode": "end",
      "length": 50
    }
  }
}
TOML
[[end]]
type = "clipboard"
max_items = 3

[[end.truncate]]
mode = "end"
length = 50
YAML
end:
  - type: 'clipboard'
    max_items: 3
    truncate:
      mode: 'end'
      length: 50
Corn
{
    end = [ { 
        type = "clipboard" 
        max_items = 3 
        truncate.mode = "end" 
        truncate.length = 50 
    } ] 
}

Styling

Selector Description
.clipboard Clipboard widget.
.clipboard .btn Clipboard widget button.
.clipboard .btn .icon Clipboard widget button icon (any type).
.clipboard .btn .text-icon Clipboard widget button icon (textual only).
.clipboard .btn .image Clipboard widget button icon (image only).
.popup-clipboard Clipboard popup box.
.popup-clipboard .item Clipboard row item inside the popup.
.popup-clipboard .item .btn Clipboard row item radio button.
.popup-clipboard .item .btn.text Clipboard row item radio button (text values only).
.popup-clipboard .item .btn.image Clipboard row item radio button (image values only).
.popup-clipboard .item .btn-remove Clipboard row item remove button.

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