Manuel Cillero
e3ed4ecae9
Los traits `ExtensionTrait`, `ThemeTrait` y `ComponentTrait` pasan a ser `Extension`, `Theme`y `Component`, respectivamente,
76 lines
2.2 KiB
Rust
76 lines
2.2 KiB
Rust
use crate::prelude::*;
|
|
|
|
/// Componente básico para renderizar dinámicamente código HTML recibiendo el contexto.
|
|
///
|
|
/// Este componente permite generar contenido HTML arbitrario, usando la macro `html!` y accediendo
|
|
/// opcionalmente al contexto de renderizado.
|
|
///
|
|
/// # Ejemplo
|
|
///
|
|
/// ```rust
|
|
/// use pagetop::prelude::*;
|
|
///
|
|
/// let component = Html::with(|_| {
|
|
/// html! {
|
|
/// div class="example" {
|
|
/// p { "Hello from PageTop." }
|
|
/// }
|
|
/// }
|
|
/// });
|
|
/// ```
|
|
///
|
|
/// Para renderizar contenido que dependa del contexto, se puede acceder a él dentro del *closure*:
|
|
///
|
|
/// ```rust
|
|
/// use pagetop::prelude::*;
|
|
///
|
|
/// let component = Html::with(|cx| {
|
|
/// let user = cx.get_param::<String>("username").unwrap_or(String::from("visitor"));
|
|
/// html! {
|
|
/// h1 { "Hello, " (user) }
|
|
/// }
|
|
/// });
|
|
/// ```
|
|
pub struct Html(Box<dyn Fn(&mut Context) -> Markup + Send + Sync>);
|
|
|
|
impl Default for Html {
|
|
fn default() -> Self {
|
|
Html::with(|_| html! {})
|
|
}
|
|
}
|
|
impl Component for Html {
|
|
fn new() -> Self {
|
|
Html::default()
|
|
}
|
|
|
|
fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup {
|
|
PrepareMarkup::With((self.0)(cx))
|
|
}
|
|
}
|
|
|
|
impl Html {
|
|
/// Crea una instancia que generará el `Markup`, con acceso opcional al contexto.
|
|
///
|
|
/// El método [`prepare_component`](crate::core::component::ComponentTrait::prepare_component)
|
|
/// delega el renderizado en la función proporcionada, que recibe una referencia mutable
|
|
/// al contexto de renderizado ([`Context`]).
|
|
pub fn with<F>(f: F) -> Self
|
|
where
|
|
F: Fn(&mut Context) -> Markup + Send + Sync + 'static,
|
|
{
|
|
Html(Box::new(f))
|
|
}
|
|
|
|
/// Sustituye la función que genera el `Markup`.
|
|
///
|
|
/// Permite a otras extensiones modificar la función de renderizado que se ejecutará cuando
|
|
/// [`prepare_component`](crate::core::component::ComponentTrait::prepare_component) invoque
|
|
/// esta instancia. La nueva función también recibe una referencia al contexto ([`Context`]).
|
|
pub fn alter_html<F>(&mut self, f: F) -> &mut Self
|
|
where
|
|
F: Fn(&mut Context) -> Markup + Send + Sync + 'static,
|
|
{
|
|
self.0 = Box::new(f);
|
|
self
|
|
}
|
|
}
|