✨ (bootsier): Maqueta la plantilla Admin del panel
This commit is contained in:
parent
d1f3ede963
commit
4062a57cff
5 changed files with 101 additions and 49 deletions
|
|
@ -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,
|
||||
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<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
|
||||
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
|
||||
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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,
|
||||
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<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
|
||||
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 `<body>`.
|
||||
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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
//!
|
||||
|
|
|
|||
|
|
@ -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<Result<Markup, ComponentError>> {
|
||||
match component.template().downcast_ref::<CoreTemplates>()? {
|
||||
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))
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue