ButtonBlock

This block is used provide a clickable button that performs some action (more actions coming soon -- submit an issue if you have an idea).

Required Properties

Name	Type	Description	Example
`padding`	`Padding`	Padding around the block, which is applied before hooking.	`padding: Padding(left: 7.0, right: 7.0, top: 7.0, bottom: 7.0`
`action`	`Action`	The type of action that this button should trigger. `DefaultAction` will trigger the primary notification action (same as the `notification_action1` mouse shortcut). ^{Note: OtherAction(int) counts from 0, and excludes the default action. So OtherAction(0) would be the first action not including the default one (if it exists).}	`action: DefaultAction` `action: OtherAction(0)`
`text`	`string`	Text to display in this text block. `%a` will be substituted with the action text, `%s` with the summary text, `%b` with the body text, and a few more. See the Text Markup wiki page for full details.	`text: "%a"`
`font`	`string`	Font description string for the desired font, in the format of `"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE] [VARIATIONS]"`. ^{For more information on font descriptions, see pango documentation. > To find a font family's name, try fc-list in a terminal.}	`font: "Arial Bold 10"`
`border_width`	`float`	The width in pixels of the border around the button.	`border_width: 3.0`
`border_rounding`	`float`	Rounding of the border, where `0.0` is no rounding and higher values are progressively more rounded.	`border_rounding: 3.0`
`text_color`	`Color`	Text color.	`color: Color(hex: "#ebdbb2")`
`border_color`	`Color`	Border color.	`color: Color(hex: "#ebdbb2")`
`background_color`	`Color`	Background color.	`background_color: Color(hex: "#282828")`
`dimensions`	`Dimensions`	Desired text dimensions. This means minimum and maximum width and height of the block (in pixels). ^{See TextBlock for notes on this behavior.}	`dimensions: (width: (min: 0, max: 150), height: (min: 0, max: 0))`

Optional Properties

Name	Type	Description	Example
`text_color_hovered`	`Color`	The text color that should be used while the mouse is hovered over this block. ^{Default: use text_color}	`text_color_hovered: Color(hex: "#fbf1c7")`
`border_color_hovered`	`Color`	The border color that should be used while the mouse is hovered over this block. ^{Default: use border_color}	`border_color_hovered: Color(hex: "#fbf1c7")`
`background_color_hovered`	`Color`	The background color that should be used while the mouse is hovered over this block. ^{Default: use background_color}	`background_color_hovered: Color(hex: "#fbf1c7")`
`ellipsize`	`EllipsizeMode`	Determines which part of the string should be trimmed when it exceeds its maximum width. Either `Start`, `Middle`, `End`, or `None`. ^{Default: Middle}	`ellipsize: Middle`
`align`	`AlignMode`	Where the text should be aligned within its block. Note that this only really useful if your `dimensions` are larger than the text. Either `Left`, `Center`, or `Right`. ^{Default: Left}	`align: Center`

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

ButtonBlock

ButtonBlock

Required Properties

Optional Properties

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Index

Blocks

Clone this wiki locally