seigi_toast 0.2.1

Unstyled toast components for web
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! Ready-to-use global toasts with predefined styles

mod renderer;
mod toast;
mod toaster;
use std::cell::OnceCell;

use gloo::utils::{body, document, head};
pub use toast::*;
pub use toaster::*;
use wasm_bindgen::JsCast;
use web_sys::{HtmlElement, HtmlStyleElement};

use crate::renderer::{RendererOptions, create_renderer};

thread_local! {
    static GLOBAL_TOASTS: OnceCell<Toaster> = const { OnceCell::new() };
}

fn global() -> Toaster {
    GLOBAL_TOASTS.with(|toaster| toaster.get().unwrap().clone())
}

/// Initialize styles and global
pub fn initialize(options: ToasterOptions) {
    initialize_styles();
    initialize_global(options);
}

/// Add default stylesheet to document head
pub fn initialize_styles() {
    let styles = include_str!("styles.css");
    let element = document()
        .create_element("style")
        .unwrap()
        .unchecked_into::<HtmlStyleElement>();
    head().append_child(element.unchecked_ref()).unwrap();

    element.set_type("text/css");
    element
        .append_child(document().create_text_node(styles).unchecked_ref())
        .unwrap();
}

/// Initialize global state and renderer
pub fn initialize_global(options: ToasterOptions) {
    // Initialize global state
    GLOBAL_TOASTS.with(|cell| {
        let toaster = Toaster::new(options);
        cell.get_or_init(|| toaster.clone());

        let container = document()
            .create_element("ol")
            .unwrap()
            .unchecked_into::<HtmlElement>();
        body().append_child(container.unchecked_ref()).unwrap();
        create_renderer(toaster, container, RendererOptions::default());
    });
}

/// Add toast to global state
///
/// # Returns
/// Handle to the toast
pub fn create_toast(toast: impl Into<Toast>) -> ToastHandle {
    let toast = toast.into();
    global().add_toast(toast)
}

/// Dismiss a toast of handle with given reason from global toast state
///
/// # Returns
/// True if toast has been set to be dismissed, false if no toast of handle was found
pub fn dismiss_toast(handle: ToastHandle) -> bool {
    global().dismiss_toast(handle, DismissReason::User)
}