pagetop 0.5.0

Un entorno de desarrollo para crear soluciones web modulares, extensibles y configurables.
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

use crate::html::{html, Markup};
use crate::{AutoDefault, Getters};

/// Error producido durante el renderizado de un componente.
///
/// Se usa en [`Component::prepare()`](super::Component::prepare) para devolver
/// un [`Err`]. Puede incluir un marcado HTML alternativo para renderizar el componente de manera
/// diferente en caso de error.
///
/// # Ejemplo
///
/// ```rust
/// # use pagetop::prelude::*;
/// # #[derive(Clone)]
/// # struct MyComponent;
/// # impl Component for MyComponent {
/// #     fn new() -> Self { MyComponent }
/// fn prepare(&self, _cx: &mut Context) -> Result<Markup, ComponentError> {
///     Err(ComponentError::new("Database connection failed")
///         .with_fallback(html! { p class="error" { "Content temporarily unavailable." } }))
/// }
/// # }
/// ```
#[derive(AutoDefault, Debug, Getters)]
pub struct ComponentError {
    /// Mensaje descriptivo del error.
    message: String,
    /// Marcado HTML alternativo para mostrar si el componente falla.
    fallback: Markup,
}

impl ComponentError {
    /// Crea un nuevo error para un componente con un marcado alternativo vacío.
    pub fn new(message: impl Into<String>) -> Self {
        ComponentError {
            message: message.into(),
            fallback: html! {},
        }
    }

    // **< ComponentError BUILDER >*****************************************************************

    /// Asigna el marcado HTML alternativo (*fallback*) que se mostrará si el componente falla.
    ///
    /// Si no se proporciona, no se renderizará nada del componente.
    pub fn with_fallback(mut self, fallback: Markup) -> Self {
        self.fallback = fallback;
        self
    }

    // **< ComponentError GETTERS >*****************************************************************

    /// Consume el error y devuelve su marcado alternativo.
    ///
    /// Se invoca internamente en [`ComponentRender`](crate::core::component::ComponentRender).
    pub(crate) fn into_fallback(self) -> Markup {
        self.fallback
    }
}

impl std::fmt::Display for ComponentError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.message)
    }
}

impl std::error::Error for ComponentError {}