Struct Toast 

pub struct Toast<Message>
where
    Message: Clone,
{
    pub id: u64,
    pub title: String,
    pub message: String,
    pub intent: ToastIntent,
    pub lifetime: ToastLifetime,
    pub created_at: Instant,
    pub on_dismiss: Message,
}

A toast notification.

Message is your application’s top-level message type. The on_dismiss field is fired when the user clicks the toast’s close button. It is not fired when a transient toast expires; expiration is a silent sweep.

Fields

id: u64

Application-assigned id. snora does not interpret or generate ids; the application is the source of truth. Typically a monotonically increasing u64.

title: String

Bold heading line — typically a few words.

message: String

Body text — one or two short sentences, explaining the situation.

intent: ToastIntent

Semantic category (Info, Success, Warning, …). Resolved to a theme color by the engine.

lifetime: ToastLifetime

Auto-dismiss policy. Defaults to ToastLifetime::DEFAULT (4-second transient).

created_at: Instant

When this toast was enqueued. Used with lifetime to compute expiration.

on_dismiss: Message

Emitted when the user clicks the close button.

Implementations

impl<Message> Toast<Message>

where Message: Clone,

pub fn new( id: u64, intent: ToastIntent, title: impl Into<String>, message: impl Into<String>, on_dismiss: Message, ) -> Toast<Message>

Build a new toast with created_at set to Instant::now().

This constructor takes the mandatory fields positionally and uses ToastLifetime::DEFAULT for the lifetime. Use builder-style methods below to customize further.

Example

use snora_core::{Toast, ToastIntent};

#[derive(Clone, Debug)]
enum Msg { DismissToast(u64) }

let toast = Toast::new(
    /* id */       1,
    /* intent */   ToastIntent::Success,
    /* title */    "Saved",
    /* message */  "Your changes are stored.",
    /* on_dismiss */ Msg::DismissToast(1),
);
assert_eq!(toast.id, 1);
assert_eq!(toast.title, "Saved");
assert_eq!(toast.intent, ToastIntent::Success);

pub fn with_lifetime(self, lifetime: ToastLifetime) -> Toast<Message>

Override the lifetime.

pub fn persistent(self) -> Toast<Message>

Make this toast persistent (never auto-dismiss).

Use for notifications the user must explicitly acknowledge — “Export complete”, “Disk almost full”, confirmations of long operations.

Example

use snora_core::{Toast, ToastIntent, ToastLifetime};

#[derive(Clone, Debug)]
enum Msg { DismissToast(u64) }

let toast = Toast::new(
    1, ToastIntent::Info, "Exported", "Done.", Msg::DismissToast(1),
)
.persistent();
assert_eq!(toast.lifetime, ToastLifetime::Persistent);

pub fn with_created_at(self, created_at: Instant) -> Toast<Message>

Override the creation timestamp. Mainly useful for tests.

pub fn is_expired(&self, now: Instant) -> bool

True when this toast has outlived its transient deadline. Persistent toasts always return false.

Trait Implementations

impl<Message> Clone for Toast<Message>

where Message: Clone,

fn clone(&self) -> Toast<Message>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Message> Debug for Toast<Message>

where Message: Debug + Clone,

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

Formats the value using the given formatter.