diff --git a/extensions/pagetop-bootsier/README.md b/extensions/pagetop-bootsier/README.md index ec0a0fe8..ee55f903 100644 --- a/extensions/pagetop-bootsier/README.md +++ b/extensions/pagetop-bootsier/README.md @@ -77,10 +77,8 @@ async fn homepage(request: HttpRequest) -> Result { Bootsier maqueta las dos plantillas de PageTop (`CoreTemplates`) con las mismas regiones (cabecera, lateral, contenido y pie): `Standard`, la plantilla por defecto de cualquier página; y `Admin`, que -se activa creando la página con `Page::admin()` en lugar de `Page::new()`. Ambas se maquetan igual -hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué -extensión registra contenido en cada región y para qué plantilla se autolimita (por ejemplo, el menú -de `pagetop-admin`, ver más abajo). +se activa creando la página con `Page::admin()` en lugar de `Page::new()` y añade el panel de +administración (ver más abajo). ```rust,no_run use pagetop::prelude::*; @@ -95,12 +93,12 @@ async fn about(request: HttpRequest) -> Result { } ``` -## Menú de administración +## Panel de administración -`pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y -páginas en `CoreRegions::Aside`, autolimitado a páginas con la plantilla `Admin` -- no requiere -ningún registro por parte de Bootsier. Se construye con `Navbar`/`Nav`/`Dropdown`, los mismos -componentes disponibles para cualquier página de la aplicación. +En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la +navegación del panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`: +migas, título, botones y pestañas). Los dos se construyen con componentes del núcleo +(`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto. ## Selector de modo de color diff --git a/extensions/pagetop-bootsier/assets/_bootsier-custom.scss b/extensions/pagetop-bootsier/assets/_bootsier-custom.scss index 2884411e..7429effe 100644 --- a/extensions/pagetop-bootsier/assets/_bootsier-custom.scss +++ b/extensions/pagetop-bootsier/assets/_bootsier-custom.scss @@ -248,3 +248,51 @@ fieldset > legend { border-start-start-radius: 0; border-end-start-radius: 0; } + +// Frame of an administration page (`AdminFrame`): title with its action links, then the local +// tasks as tabs. +.admin-header { + display: flex; + flex-wrap: wrap; + align-items: center; + justify-content: space-between; + gap: 0.5rem 1rem; + margin: 1rem 0; +} + +.admin-page-title { + margin: 0; +} + +.admin-actions-list, +.admin-tasks-list { + display: flex; + flex-wrap: wrap; + gap: 0.5rem; + margin: 0; + padding: 0; + list-style: none; +} + +.admin-action-link { + @extend .btn; + @extend .btn-outline-primary; +} + +.admin-local-tasks { + margin-bottom: 1rem; + border-bottom: var(--bs-border-width) solid var(--bs-border-color); +} + +.admin-task a { + display: block; + padding: 0.5rem 0.75rem; + margin-bottom: calc(-1 * var(--bs-border-width)); + border-bottom: 2px solid transparent; + text-decoration: none; +} + +.admin-task-active a { + border-bottom-color: var(--bs-primary); + font-weight: 600; +} diff --git a/extensions/pagetop-bootsier/src/lib.rs b/extensions/pagetop-bootsier/src/lib.rs index 38bc9443..3bc0fa0e 100644 --- a/extensions/pagetop-bootsier/src/lib.rs +++ b/extensions/pagetop-bootsier/src/lib.rs @@ -78,10 +78,8 @@ async fn homepage(request: HttpRequest) -> Result { Bootsier maqueta las dos plantillas de PageTop (`CoreTemplates`) con las mismas regiones (cabecera, lateral, contenido y pie): `Standard`, la plantilla por defecto de cualquier página; y `Admin`, que -se activa creando la página con `Page::admin()` en lugar de `Page::new()`. Ambas se maquetan igual -hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué -extensión registra contenido en cada región y para qué plantilla se autolimita (por ejemplo, el menú -de `pagetop-admin`, ver más abajo). +se activa creando la página con `Page::admin()` en lugar de `Page::new()` y añade el panel de +administración (ver más abajo). ```rust,no_run use pagetop::prelude::*; @@ -96,12 +94,12 @@ async fn about(request: HttpRequest) -> Result { } ``` -## Menú de administración +## Panel de administración -`pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y -páginas en `CoreRegions::Aside`, autolimitado a páginas con la plantilla `Admin` -- no requiere -ningún registro por parte de Bootsier. Se construye con `Navbar`/`Nav`/`Dropdown`, los mismos -componentes disponibles para cualquier página de la aplicación. +En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la +navegación del panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`: +migas, título, botones y pestañas). Los dos se construyen con componentes del núcleo +(`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto. ## Selector de modo de color @@ -156,7 +154,7 @@ impl Extension for Bootsier { Some(&config::SETTINGS) } - fn configure_static_files(&self, router: Router) -> Router { + fn configure_static_files(&self, files: StaticFiles) -> StaticFiles { let base = &config::SETTINGS.static_dir; let subdir = |s: &str| { if base.is_empty() { @@ -165,10 +163,10 @@ impl Extension for Bootsier { format!("{base}/{s}") } }; - serve_static_files!(router, [subdir("css"), bootsier_css] => "/bootsier/css"); - serve_static_files!(router, [subdir("js"), bootsier_js] => "/bootsier/js"); - serve_static_files!(router, [subdir("fonts"), bootsier_fonts] => "/bootsier/fonts"); - router + serve_static_files!(files, [subdir("css"), bootsier_css] => "/bootsier/css"); + serve_static_files!(files, [subdir("js"), bootsier_js] => "/bootsier/js"); + serve_static_files!(files, [subdir("fonts"), bootsier_fonts] => "/bootsier/fonts"); + files } } @@ -234,12 +232,8 @@ impl Theme for Bootsier { // Etiquetas de los botones del modal de confirmación que sustituye al `confirm()` nativo // de htmx (ver `bootsier.confirm.js`); se leen aquí porque este es el único punto con // acceso al `Context` para resolverlas antes de escribirlas en el ``. - let confirm_ok = Lc::l("confirm_ok") - .lookup(page.context()) - .unwrap_or_default(); - let confirm_cancel = Lc::l("confirm_cancel") - .lookup(page.context()) - .unwrap_or_default(); + let confirm_ok = Lc::l("confirm_ok").lookup(page).unwrap_or_default(); + let confirm_cancel = Lc::l("confirm_cancel").lookup(page).unwrap_or_default(); // Las URLs de las fuentes deben coincidir exactamente con las declaradas en @font-face de // _bootsier-custom.scss; cualquier discrepancia hace que el navegador descargue dos veces. diff --git a/extensions/pagetop-bootsier/src/theme.rs b/extensions/pagetop-bootsier/src/theme.rs index 5dd22b90..a7552e24 100644 --- a/extensions/pagetop-bootsier/src/theme.rs +++ b/extensions/pagetop-bootsier/src/theme.rs @@ -13,10 +13,8 @@ //! //! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]) con la misma cabecera, //! contenido y pie: `Standard`, la plantilla por defecto de cualquier página; y `Admin`, que se -//! activa creando la página con [`Page::admin()`] en lugar de [`Page::new()`]. Ambas se maquetan -//! igual hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, -//! sino en qué extensión registra contenido en cada región y para qué plantilla se autolimita (ver -//! más abajo `pagetop-admin`). +//! activa creando la página con [`Page::admin()`] en lugar de [`Page::new()`] y añade el panel de +//! administración (ver más abajo). //! //! ```rust,no_run //! use pagetop::prelude::*; @@ -35,13 +33,12 @@ //! [`Page::admin()`]: pagetop::response::Page::admin //! [`Page::new()`]: pagetop::response::Page::new //! -//! # Menú de administración +//! # Panel de administración //! -//! `pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y -//! páginas en [`CoreRegions::Aside`], autolimitado a -//! páginas con la plantilla `Admin` -- no requiere ningún registro por parte de Bootsier. Se -//! construye con [`Navbar`]/[`Nav`]/[`Dropdown`], los mismos -//! componentes disponibles para cualquier página de la aplicación. +//! En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la +//! navegación del panel ([`AdminMenu`]) y, en lugar del contenido, el marco de la página +//! ([`AdminFrame`]: migas, título, botones y pestañas). Los dos se construyen con componentes del +//! núcleo ([`Navbar`]/[`Nav`]/[`Dropdown`], [`Breadcrumb`]), que Bootsier ya pinta con su aspecto. //! //! # Selector de modo de color //! diff --git a/extensions/pagetop-bootsier/src/theme/bs/layout/template.rs b/extensions/pagetop-bootsier/src/theme/bs/layout/template.rs index 8a4f7295..89a38358 100644 --- a/extensions/pagetop-bootsier/src/theme/bs/layout/template.rs +++ b/extensions/pagetop-bootsier/src/theme/bs/layout/template.rs @@ -8,28 +8,23 @@ use crate::theme::bs; // `CoreTemplates`, dejando que el resto de la cadena de temas (o el propio componente) resuelva el // renderizado por defecto. // -// `CoreTemplates::Admin` delega hoy en el mismo maquetado que `Standard`: la diferencia entre -// página "normal" y de administración no vive en la plantilla, sino en qué se registra en cada -// región -- p. ej. el menú de `pagetop-admin` en `CoreRegions::Aside`, que se autolimita a -// `CoreTemplates::Admin` (ver `pagetop_admin::component::AdminMenu`). Mantener la rama separada -// deja abierta la posibilidad de que un maquetado distinto lo necesite en el futuro sin tocar el -// núcleo. +// `CoreTemplates::Admin` sigue la composición del núcleo: tras la cabecera, la navegación del +// panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`), que +// contiene la región `Content`. pub(crate) async fn render( component: &layout::Template, cx: &mut Context, ) -> Option> { match component.template().downcast_ref::()? { CoreTemplates::Standard => Some(Ok(render_standard(cx).await)), - CoreTemplates::Admin => Some(Ok(render_standard(cx).await)), + CoreTemplates::Admin => Some(Ok(render_admin(cx).await)), } } // `CoreRegions::Header`, `CoreRegions::Aside`, `CoreRegions::Content` y `CoreRegions::Footer` // envueltos en un contenedor de ancho configurable. async fn render_standard(cx: &mut Context) -> Markup { - bs::Container::new() - .with_prop(PropsOp::add_classes("container-wrapper")) - .with_width(bs::container::Width::FluidMax(config::SETTINGS.max_width)) + wrapper() .with_child(layout::Region::header()) .with_child(layout::Region::aside()) .with_child(layout::Region::default()) @@ -37,3 +32,23 @@ async fn render_standard(cx: &mut Context) -> Markup { .render(cx) .await } + +// Como `render_standard()`, con la navegación del panel tras la cabecera y el marco de la página +// en lugar de la región `Content`. +async fn render_admin(cx: &mut Context) -> Markup { + wrapper() + .with_prop(PropsOp::add_classes("container-wrapper-admin")) + .with_child(layout::Region::header()) + .with_child(AdminMenu::new()) + .with_child(layout::Region::aside()) + .with_child(AdminFrame::new()) + .with_child(layout::Region::footer()) + .render(cx) + .await +} + +fn wrapper() -> bs::Container { + bs::Container::new() + .with_prop(PropsOp::add_classes("container-wrapper")) + .with_width(bs::container::Width::FluidMax(config::SETTINGS.max_width)) +}