longcipher-leptos-components 0.1.0

Production-ready UI components for Leptos applications
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

//! DOM helper utilities
//!
//! Provides cross-platform DOM manipulation helpers that work
//! in both SSR and CSR contexts.

#[cfg(feature = "editor")]
use web_sys::Document;

/// Get the current document, if available.
///
/// Returns `None` in SSR context or if document is not available.
#[cfg(feature = "editor")]
#[allow(dead_code)]
pub fn get_document() -> Option<Document> {
    #[cfg(target_arch = "wasm32")]
    {
        web_sys::window().and_then(|w| w.document())
    }
    #[cfg(not(target_arch = "wasm32"))]
    {
        None
    }
}

/// Check if we're running in a browser context.
#[must_use]
#[allow(dead_code)]
pub fn is_browser() -> bool {
    #[cfg(target_arch = "wasm32")]
    {
        web_sys::window().is_some()
    }
    #[cfg(not(target_arch = "wasm32"))]
    {
        false
    }
}

/// Safely execute code only in browser context.
///
/// This is useful for operations that should only run on the client,
/// such as accessing localStorage, clipboard, or other browser APIs.
#[allow(dead_code)]
pub fn on_browser<F, T>(f: F) -> Option<T>
where
    F: FnOnce() -> T,
{
    if is_browser() { Some(f()) } else { None }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_is_browser_in_tests() {
        // In test context (not wasm), this should be false
        #[cfg(not(target_arch = "wasm32"))]
        assert!(!is_browser());
    }
}