div 0.4.0

Ad hoc HTML for Rust Web Apps.
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
77
78
79
80

use std::error::Error;
use std::fmt;

#[derive(Debug)]
/// Generic error type for all library calls which may fail.
///
/// Having a common type for all errors can vastly simplify all kinds of call-chains.
pub enum DivError {
    UseAfterDelete,
    NotAllocated,
    NotInitialized,
    AlreadyInitialized,
    Locked,
    MissingBody,
    MissingHead,
    MissingWindow,
    MissingDocument,
    MissingRoot(String),
    MissingChild,
    BrowserError(Box<dyn Error>),
    JsError(String),
    JsCastError,
    UndefinedSize,
}

impl fmt::Display for DivError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            DivError::UseAfterDelete =>
                write!(f, "This pane has already been deleted."),
            DivError::NotAllocated =>
                write!(f, "Invalid pane handle, pane has never been allocated."),
            DivError::Locked =>
                write!(f, "The Div-internal data structure has dead-locked itself. This is most likely a bug in Div."),
            DivError::NotInitialized =>
                write!(f, "Called div functions before initializing it. Call div::init() to initialize to body."),
            DivError::AlreadyInitialized=>
                write!(f, "Div has already been initialized, cannot do it again."),
            DivError::MissingBody =>
                write!(f, "No HTML body found."),
            DivError::MissingHead =>
                write!(f, "No HTML head found."),
            DivError::MissingWindow =>
                write!(f, "No Window."),
            DivError::MissingDocument =>
                write!(f, "No Document."),
            DivError::MissingRoot(id) =>
                write!(f, "HTML root element with id = {} not found.", id),
            DivError::MissingChild =>
                write!(f, "DOM child is missing which has been inserted before."),
            DivError::UndefinedSize =>
                write!(f, "Pane has no size."),
            DivError::BrowserError(e) =>
                write!(f, "A browser-call returned an error: {}", e),
            DivError::JsError(msg) =>
                write!(f, "JS error: {}", msg),
            DivError::JsCastError =>
                write!(f, "JS Cast Error"),
        }
    }
}

impl Error for DivError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        match self {
            DivError::BrowserError(err) => Some(err.as_ref()),
            _ => None,
        }
    }
}

impl From<wasm_bindgen::JsValue> for DivError {
    fn from(err: wasm_bindgen::JsValue) -> Self {
        web_sys::console::error_1(&err);
        DivError::JsError(
            "Something in the browser went wrong, check the console error output for more info"
                .to_owned(),
        )
    }
}