Struct ToastAction 

pub struct ToastAction {
    pub label: String,
    pub id: String,
}

An interactive action button displayed in a toast.

Actions allow users to respond to a toast (e.g., “Undo”, “Retry”, “View”). Each action has a display label and a unique identifier used to match callbacks when the action is invoked.

Invariants

• label must be non-empty after trimming whitespace.
• id must be non-empty; it serves as the stable callback key.
• Display width of label is bounded by toast max_width minus chrome.

Evidence Ledger

Action focus uses a simple round-robin model: Tab advances focus index modulo action count. This is deterministic and requires no scoring heuristic. The decision rule is: next_focus = (current_focus + 1) % actions.len().

Fields

label: String

Display label for the action button (e.g., “Undo”).

id: String

Unique identifier for callback matching.

Implementations

impl ToastAction

pub fn new(label: impl Into<String>, id: impl Into<String>) -> Self

Create a new toast action.

Panics

Panics in debug builds if label or id is empty after trimming.

pub fn display_width(&self) -> usize

Display width of the action button including brackets.

Rendered as [Label], so width = label_width + 2 (brackets).

Trait Implementations

impl Clone for ToastAction

fn clone(&self) -> ToastAction

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToastAction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for ToastAction

fn eq(&self, other: &ToastAction) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ToastAction

impl StructuralPartialEq for ToastAction