✨ (bootsier): Maqueta la plantilla Admin del panel

This commit is contained in:
Manuel Cillero 2026-11-07 16:39:22 +01:00
parent d1f3ede963
commit 4062a57cff
5 changed files with 101 additions and 49 deletions

View file

@ -77,10 +77,8 @@ async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
Bootsier maqueta las dos plantillas de PageTop (`CoreTemplates`) con las mismas regiones (cabecera, 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 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 se activa creando la página con `Page::admin()` en lugar de `Page::new()` y añade el panel de
hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué administración (ver más abajo).
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).
```rust,no_run ```rust,no_run
use pagetop::prelude::*; use pagetop::prelude::*;
@ -95,12 +93,12 @@ async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
} }
``` ```
## Menú de administración ## Panel de administración
`pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la
páginas en `CoreRegions::Aside`, autolimitado a páginas con la plantilla `Admin` -- no requiere navegación del panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`:
ningún registro por parte de Bootsier. Se construye con `Navbar`/`Nav`/`Dropdown`, los mismos migas, título, botones y pestañas). Los dos se construyen con componentes del núcleo
componentes disponibles para cualquier página de la aplicación. (`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto.
## Selector de modo de color ## Selector de modo de color

View file

@ -248,3 +248,51 @@ fieldset > legend {
border-start-start-radius: 0; border-start-start-radius: 0;
border-end-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;
}

View file

@ -78,10 +78,8 @@ async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
Bootsier maqueta las dos plantillas de PageTop (`CoreTemplates`) con las mismas regiones (cabecera, 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 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 se activa creando la página con `Page::admin()` en lugar de `Page::new()` y añade el panel de
hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, sino en qué administración (ver más abajo).
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).
```rust,no_run ```rust,no_run
use pagetop::prelude::*; use pagetop::prelude::*;
@ -96,12 +94,12 @@ async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
} }
``` ```
## Menú de administración ## Panel de administración
`pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la
páginas en `CoreRegions::Aside`, autolimitado a páginas con la plantilla `Admin` -- no requiere navegación del panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`:
ningún registro por parte de Bootsier. Se construye con `Navbar`/`Nav`/`Dropdown`, los mismos migas, título, botones y pestañas). Los dos se construyen con componentes del núcleo
componentes disponibles para cualquier página de la aplicación. (`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto.
## Selector de modo de color ## Selector de modo de color
@ -156,7 +154,7 @@ impl Extension for Bootsier {
Some(&config::SETTINGS) 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 base = &config::SETTINGS.static_dir;
let subdir = |s: &str| { let subdir = |s: &str| {
if base.is_empty() { if base.is_empty() {
@ -165,10 +163,10 @@ impl Extension for Bootsier {
format!("{base}/{s}") format!("{base}/{s}")
} }
}; };
serve_static_files!(router, [subdir("css"), bootsier_css] => "/bootsier/css"); serve_static_files!(files, [subdir("css"), bootsier_css] => "/bootsier/css");
serve_static_files!(router, [subdir("js"), bootsier_js] => "/bootsier/js"); serve_static_files!(files, [subdir("js"), bootsier_js] => "/bootsier/js");
serve_static_files!(router, [subdir("fonts"), bootsier_fonts] => "/bootsier/fonts"); serve_static_files!(files, [subdir("fonts"), bootsier_fonts] => "/bootsier/fonts");
router files
} }
} }
@ -234,12 +232,8 @@ impl Theme for Bootsier {
// Etiquetas de los botones del modal de confirmación que sustituye al `confirm()` nativo // 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 // 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 `<body>`. // acceso al `Context` para resolverlas antes de escribirlas en el `<body>`.
let confirm_ok = Lc::l("confirm_ok") let confirm_ok = Lc::l("confirm_ok").lookup(page).unwrap_or_default();
.lookup(page.context()) let confirm_cancel = Lc::l("confirm_cancel").lookup(page).unwrap_or_default();
.unwrap_or_default();
let confirm_cancel = Lc::l("confirm_cancel")
.lookup(page.context())
.unwrap_or_default();
// Las URLs de las fuentes deben coincidir exactamente con las declaradas en @font-face de // 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. // _bootsier-custom.scss; cualquier discrepancia hace que el navegador descargue dos veces.

View file

@ -13,10 +13,8 @@
//! //!
//! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]) con la misma cabecera, //! 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 //! 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 //! activa creando la página con [`Page::admin()`] en lugar de [`Page::new()`] y añade el panel de
//! igual hoy -- la distinción entre página "normal" y de administración no vive en el maquetado, //! administración (ver más abajo).
//! sino en qué extensión registra contenido en cada región y para qué plantilla se autolimita (ver
//! más abajo `pagetop-admin`).
//! //!
//! ```rust,no_run //! ```rust,no_run
//! use pagetop::prelude::*; //! use pagetop::prelude::*;
@ -35,13 +33,12 @@
//! [`Page::admin()`]: pagetop::response::Page::admin //! [`Page::admin()`]: pagetop::response::Page::admin
//! [`Page::new()`]: pagetop::response::Page::new //! [`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 //! En la plantilla `Admin`, Bootsier sigue la composición del núcleo: tras la cabecera pinta la
//! páginas en [`CoreRegions::Aside`], autolimitado a //! navegación del panel ([`AdminMenu`]) y, en lugar del contenido, el marco de la página
//! páginas con la plantilla `Admin` -- no requiere ningún registro por parte de Bootsier. Se //! ([`AdminFrame`]: migas, título, botones y pestañas). Los dos se construyen con componentes del
//! construye con [`Navbar`]/[`Nav`]/[`Dropdown`], los mismos //! núcleo ([`Navbar`]/[`Nav`]/[`Dropdown`], [`Breadcrumb`]), que Bootsier ya pinta con su aspecto.
//! componentes disponibles para cualquier página de la aplicación.
//! //!
//! # Selector de modo de color //! # Selector de modo de color
//! //!

View file

@ -8,28 +8,23 @@ use crate::theme::bs;
// `CoreTemplates`, dejando que el resto de la cadena de temas (o el propio componente) resuelva el // `CoreTemplates`, dejando que el resto de la cadena de temas (o el propio componente) resuelva el
// renderizado por defecto. // renderizado por defecto.
// //
// `CoreTemplates::Admin` delega hoy en el mismo maquetado que `Standard`: la diferencia entre // `CoreTemplates::Admin` sigue la composición del núcleo: tras la cabecera, la navegación del
// página "normal" y de administración no vive en la plantilla, sino en qué se registra en cada // panel (`AdminMenu`) y, en lugar del contenido, el marco de la página (`AdminFrame`), que
// región -- p. ej. el menú de `pagetop-admin` en `CoreRegions::Aside`, que se autolimita a // contiene la región `Content`.
// `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.
pub(crate) async fn render( pub(crate) async fn render(
component: &layout::Template, component: &layout::Template,
cx: &mut Context, cx: &mut Context,
) -> Option<Result<Markup, ComponentError>> { ) -> Option<Result<Markup, ComponentError>> {
match component.template().downcast_ref::<CoreTemplates>()? { match component.template().downcast_ref::<CoreTemplates>()? {
CoreTemplates::Standard => Some(Ok(render_standard(cx).await)), 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` // `CoreRegions::Header`, `CoreRegions::Aside`, `CoreRegions::Content` y `CoreRegions::Footer`
// envueltos en un contenedor de ancho configurable. // envueltos en un contenedor de ancho configurable.
async fn render_standard(cx: &mut Context) -> Markup { async fn render_standard(cx: &mut Context) -> Markup {
bs::Container::new() wrapper()
.with_prop(PropsOp::add_classes("container-wrapper"))
.with_width(bs::container::Width::FluidMax(config::SETTINGS.max_width))
.with_child(layout::Region::header()) .with_child(layout::Region::header())
.with_child(layout::Region::aside()) .with_child(layout::Region::aside())
.with_child(layout::Region::default()) .with_child(layout::Region::default())
@ -37,3 +32,23 @@ async fn render_standard(cx: &mut Context) -> Markup {
.render(cx) .render(cx)
.await .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))
}