Manuel Cillero
59268e9ddd
- Incluye un componente base `Template` para gestionar la estructura del documento y sus regiones (`Region`). - Actualiza el *trait* `Contextual` para permitir la selección de la plantilla de renderizado. - Modifica `Page` y `Context`, y refactoriza el manejo de temas, para dar soporte al nuevo sistema de plantillas y eliminar la gestión obsoleta de regiones.
84 lines
3 KiB
Rust
84 lines
3 KiB
Rust
use crate::prelude::*;
|
|
|
|
/// Componente estructural para renderizar plantillas de contenido.
|
|
///
|
|
/// `Template` describe cómo se compone el cuerpo del documento a partir de varias regiones lógicas
|
|
/// ([`Region`]). En función de su nombre, decide qué regiones se renderizan y en qué orden.
|
|
///
|
|
/// Normalmente se invoca desde una página ([`Page`]), que consulta el nombre de plantilla guardado
|
|
/// en el [`Context`] y delega en `Template` la composición de las regiones que forman el cuerpo del
|
|
/// documento.
|
|
///
|
|
/// Los temas pueden sobrescribir este componente para exponer sus propias plantillas o adaptar las
|
|
/// plantillas predeterminadas.
|
|
#[derive(AutoDefault)]
|
|
pub struct Template {
|
|
#[default(AttrName::new(Self::DEFAULT))]
|
|
name: AttrName,
|
|
}
|
|
|
|
impl Component for Template {
|
|
fn new() -> Self {
|
|
Template::default()
|
|
}
|
|
|
|
fn id(&self) -> Option<String> {
|
|
self.name.get()
|
|
}
|
|
|
|
fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup {
|
|
let Some(name) = self.name().get() else {
|
|
return PrepareMarkup::None;
|
|
};
|
|
match name.as_str() {
|
|
Self::DEFAULT | Self::ERROR => PrepareMarkup::With(html! {
|
|
(Region::labeled(Region::HEADER, L10n::l("region-header")).render(cx))
|
|
(Region::default().render(cx))
|
|
(Region::labeled(Region::FOOTER, L10n::l("region-footer")).render(cx))
|
|
}),
|
|
_ => PrepareMarkup::None,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Template {
|
|
/// Nombre de la plantilla predeterminada.
|
|
///
|
|
/// Por defecto define una estructura básica con las regiones [`Region::HEADER`],
|
|
/// [`Region::CONTENT`] y [`Region::FOOTER`], en ese orden. Esta plantilla se usa cuando no se
|
|
/// selecciona ninguna otra de forma explícita (ver [`Contextual::with_template()`]).
|
|
pub const DEFAULT: &str = "default";
|
|
|
|
/// Nombre de la plantilla de error.
|
|
///
|
|
/// Se utiliza para páginas de error u otros estados excepcionales. Por defecto reutiliza
|
|
/// la misma estructura que [`Self::DEFAULT`], pero permite a temas y extensiones distinguir
|
|
/// el contexto de error para aplicar estilos o contenidos específicos.
|
|
pub const ERROR: &str = "error";
|
|
|
|
/// Selecciona la plantilla asociada al nombre indicado.
|
|
///
|
|
/// El valor de `name` se utiliza como nombre de la plantilla y como identificador (`id`) del
|
|
/// componente.
|
|
pub fn named(name: impl AsRef<str>) -> Self {
|
|
Template {
|
|
name: AttrName::new(name),
|
|
}
|
|
}
|
|
|
|
// **< Template BUILDER >***********************************************************************
|
|
|
|
/// Establece o modifica el nombre de la plantilla seleccionada.
|
|
#[builder_fn]
|
|
pub fn with_name(mut self, name: impl AsRef<str>) -> Self {
|
|
self.name.alter_value(name);
|
|
self
|
|
}
|
|
|
|
// **< Template GETTERS >***********************************************************************
|
|
|
|
/// Devuelve el nombre de la plantilla seleccionada.
|
|
pub fn name(&self) -> &AttrName {
|
|
&self.name
|
|
}
|
|
}
|