ToastOverlay
Superclasses: Widget
, InitiallyUnowned
, Object
Implemented Interfaces: Accessible
, Buildable
, ConstraintTarget
A widget showing toasts above its content.
Much like Overlay
, AdwToastOverlay
is a container with a single
main child, on top of which it can display a Toast
, overlaid.
Toasts can be shown with add_toast
.
See Toast
for details.
CSS nodes
toastoverlay
├── [child]
├── toast
┊ ├── widget
┊ │ ├── [label.heading]
│ ╰── [custom title]
├── [button]
╰── button.circular.flat
AdwToastOverlay
’s CSS node is called toastoverlay
. It contains the child,
as well as zero or more toast
subnodes.
Each of the toast
nodes contains a widget
subnode, optionally a button
subnode, and another button
subnode with .circular
and .flat
style
classes.
The widget
subnode contains a label
subnode with the .heading
style
class, or a custom widget provided by the application.
Accessibility
AdwToastOverlay
uses the GTK_ACCESSIBLE_ROLE_TAB_GROUP
role.
Constructors
Methods
- class ToastOverlay
- add_toast(toast: Toast) None
Displays
toast
.Only one toast can be shown at a time; if a toast is already being displayed, either
toast
or the original toast will be placed in a queue, depending on the priority oftoast
. Seepriority
.If called on a toast that’s already displayed, its timeout will be reset.
If called on a toast currently in the queue, the toast will be bumped forward to be shown as soon as possible.
- Parameters:
toast – a toast