pagetop/src/core/theme/definition.rs

use crate::core::extension::Extension;
use crate::core::theme::CONTENT_REGION_NAME;
use crate::global;
use crate::html::{html, Markup};
use crate::locale::L10n;
use crate::response::page::Page;

/// Representa una referencia a un tema.
///
/// Los temas son también extensiones. Por tanto se deben definir igual, es decir, como instancias
/// estáticas globales que implementan [`Theme`], pero también [`Extension`].
pub type ThemeRef = &'static dyn Theme;

/// Interfaz común que debe implementar cualquier tema de `PageTop`.
///
/// Un tema implementará [`Theme`] y los métodos que sean necesarios de [`Extension`], aunque el
/// único obligatorio es [`theme()`](Extension::theme).
///
/// ```rust
/// use pagetop::prelude::*;
///
/// pub struct MyTheme;
///
/// impl Extension for MyTheme {
///     fn name(&self) -> L10n { L10n::n("My theme") }
///     fn description(&self) -> L10n { L10n::n("Un tema personal") }
///
///     fn theme(&self) -> Option<ThemeRef> {
///         Some(&Self)
///     }
/// }
///
/// impl Theme for MyTheme {}
/// ```
pub trait Theme: Extension + Send + Sync {
    fn regions(&self) -> Vec<(&'static str, L10n)> {
        vec![(CONTENT_REGION_NAME, L10n::l("content"))]
    }

    #[allow(unused_variables)]
    fn before_render_page_body(&self, page: &mut Page) {}

    fn render_page_body(&self, page: &mut Page) -> Markup {
        html! {
            body id=[page.body_id().get()] class=[page.body_classes().get()] {
                @for (region_name, _) in self.regions() {
                    @let output = page.render_region(region_name);
                    @if !output.is_empty() {
                        div id=(region_name) class={ "region-container region-" (region_name) } {
                            (output)
                        }
                    }
                }
            }
        }
    }

    #[allow(unused_variables)]
    fn after_render_page_body(&self, page: &mut Page) {}

    fn render_page_head(&self, page: &mut Page) -> Markup {
        let viewport = "width=device-width, initial-scale=1, shrink-to-fit=no";
        html! {
            head {
                meta charset="utf-8";

                @if let Some(title) = page.title() {
                    title { (global::SETTINGS.app.name) (" | ") (title) }
                } @else {
                    title { (global::SETTINGS.app.name) }
                }

                @if let Some(description) = page.description() {
                    meta name="description" content=(description);
                }

                meta name="viewport" content=(viewport);
                @for (name, content) in page.metadata() {
                    meta name=(name) content=(content) {}
                }

                meta http-equiv="X-UA-Compatible" content="IE=edge";
                @for (property, content) in page.properties() {
                    meta property=(property) content=(content) {}
                }

                (page.render_assets())
            }
        }
    }

    fn error403(&self, _page: &mut Page) -> Markup {
        html! { div { h1 { ("FORBIDDEN ACCESS") } } }
    }

    fn error404(&self, _page: &mut Page) -> Markup {
        html! { div { h1 { ("RESOURCE NOT FOUND") } } }
    }
}