🔥 (bootsier): Elimina AdminLTE

Retira AdminLTE 4 de Bootsier: CSS/JS, `bs::sidebar`, `BootsierRegions`
y el shell propio de `CoreTemplates::Admin`. Sólo quedaba un sidebar de
5 secciones ya alcanzables desde el dashboard, las páginas de sección y
el breadcrumb de `AdminFrame`.
This commit is contained in:
Manuel Cillero 2026-09-22 21:34:16 +02:00
parent 6df71885cc
commit 11c2bdffb1
63 changed files with 201 additions and 7491 deletions

View file

@ -1,7 +1,6 @@
//! Componentes proporcionados por el tema.
pub(crate) mod layout;
pub use layout::BootsierRegions;
// Badge.
pub(crate) mod badge;
@ -81,10 +80,11 @@ pub use offcanvas::Offcanvas;
// Pager.
pub use pagetop::base::component::{Pager, PagerAlign, PagerVisibility};
// Sidebar (componentes de navegación de AdminLTE).
pub mod sidebar;
// Table.
pub use pagetop::base::component::table;
#[doc(inline)]
pub use table::Table;
// Theme toggle.
mod theme_toggle;
pub use theme_toggle::theme_toggle;

View file

@ -1,4 +1 @@
pub(crate) mod region;
pub use region::BootsierRegions;
pub(crate) mod template;

View file

@ -1,113 +0,0 @@
use pagetop::prelude::*;
use crate::LOCALES_BOOTSIER;
/// Regiones específicas de la shell de Bootsier.
pub enum BootsierRegions {
/// Barra lateral de navegación (`app-sidebar` de AdminLTE).
///
/// Los componentes registrados aquí se renderizan directamente dentro del
/// `<ul class="sidebar-menu">`, sin el `<div>` envolvente que añade
/// [`Region`](pagetop::base::component::layout::Region) por defecto --
/// [`Bootsier`](crate::Bootsier) intercepta este componente en `render_component()` para
/// renderizarlo así. Los elementos esperados son
/// [`bs::sidebar::Item`](crate::theme::bs::sidebar::Item) y
/// [`bs::sidebar::Section`](crate::theme::bs::sidebar::Section).
///
/// Sólo se renderiza en la plantilla de administración (`CoreTemplates::Admin`), que se
/// activa creando la página con [`Page::admin()`](pagetop::response::Page::admin). Registrar
/// elementos aquí no tiene efecto en páginas creadas con `Page::new()`.
///
/// # Registro global
///
/// Para que los ítems aparezcan en todas las páginas con shell, regístralos durante
/// el arranque de la aplicación con [`InRegion::Global`]:
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
///
/// InRegion::Global(&BootsierRegions::Sidebar)
/// .add(sidebar::Section::titled(Lc::n("Administración")))
/// .add(sidebar::Item::link(Lc::n("Usuarios"), "/users", "people"))
/// .add(sidebar::Item::link(Lc::n("Roles"), "/roles", "shield-check"));
/// ```
///
/// # Registro por página
///
/// Para añadir ítems sólo en una página concreta, usa [`Contextual::with_child_in`]:
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
///
/// async fn dashboard(request: HttpRequest) -> Result<Markup, ErrorPage> {
/// Page::admin(request)
/// .with_child_in(
/// &BootsierRegions::Sidebar,
/// sidebar::Item::link(Lc::n("Panel"), "/dashboard", "grid"),
/// )
/// .render().await
/// }
/// ```
Sidebar,
/// Elementos adicionales en la barra de navegación superior (`app-header`).
///
/// Los componentes registrados aquí se renderizan en el lado derecho de la barra superior,
/// a continuación de los controles fijos (pantalla completa y selector de tema). Los elementos
/// esperados son típicamente ítems de navegación (`<li class="nav-item">`).
///
/// Esta región es opcional: si no tiene contenido, no añade ningún marcado al navbar.
///
/// # Registro global
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::bs::BootsierRegions;
///
/// InRegion::Global(&BootsierRegions::Navbar)
/// .add(Html::with(|_| html! {
/// li class="nav-item" {
/// a class="nav-link" href="/logout" { "Cerrar sesión" }
/// }
/// }));
/// ```
Navbar,
}
impl RegionName for BootsierRegions {
#[inline]
fn name(&self) -> &'static str {
match self {
Self::Sidebar => "bootsier-sidebar",
Self::Navbar => "bootsier-navbar",
}
}
#[inline]
fn label(&self) -> Lc {
match self {
Self::Sidebar => Lc::t("region_sidebar", &LOCALES_BOOTSIER),
Self::Navbar => Lc::t("region_navbar", &LOCALES_BOOTSIER),
}
}
}
// **< Region RENDER >******************************************************************************
// Regiones de Bootsier: se renderizan sin el `<div role="region">` envolvente que aplica
// `layout::Region::prepare()` por defecto. Sus elementos van directamente dentro del contenedor que
// los gestiona (sidebar-menu o navbar-nav). Devuelve `None` si `component` no envuelve una
// `BootsierRegions`, dejando que el resto de la cadena de temas (o el propio componente) resuelva
// el renderizado por defecto.
pub(crate) async fn render(
component: &layout::Region,
cx: &mut Context,
) -> Option<Result<Markup, ComponentError>> {
match component.region().downcast_ref::<BootsierRegions>()? {
BootsierRegions::Sidebar | BootsierRegions::Navbar => {
Some(Ok(cx.render_region(component.region()).await))
}
}
}

View file

@ -2,25 +2,30 @@ use pagetop::prelude::*;
use crate::config;
use crate::theme::bs;
use crate::{ADMINLTE_VERSION, LOCALES_BOOTSIER};
// Regiones de Bootsier: se renderiza sin el `<div role="region">` envolvente que aplica
// `layout::Template::prepare()` por defecto; delega en `render_standard()`/`render_admin()` según
// la variante de `CoreTemplates` que envuelva el componente. Devuelve `None` si `component` no
// envuelve una `CoreTemplates`, dejando que el resto de la cadena de temas (o el propio componente)
// resuelva el renderizado por defecto.
// `layout::Template::prepare()` por defecto. Devuelve `None` si `component` no envuelve una
// `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.
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_admin(cx).await)),
CoreTemplates::Admin => Some(Ok(render_standard(cx).await)),
}
}
// Layout estándar: `CoreRegions::Header`, `CoreRegions::Aside`, `CoreRegions::Content` y
// `CoreRegions::Footer` envueltos en un contenedor de ancho configurable.
// `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"))
@ -34,137 +39,3 @@ async fn render_standard(cx: &mut Context) -> Markup {
.render(cx)
.await
}
// Layout de administración: shell de AdminLTE 4 (barra superior, barra lateral con el contenido
// de BootsierRegions::Sidebar, área de contenido y pie).
async fn render_admin(cx: &mut Context) -> Markup {
cx.alter_body_props(PropsOp::add_classes(
"layout-fixed sidebar-expand-lg bg-body-tertiary",
));
cx.alter_assets(
JavaScript::defer("/bootsier/js/bootsier.shell.min.js")
.with_version(ADMINLTE_VERSION)
.with_weight(-88),
);
// `CoreRegions::Aside` es una región neutra del core: la usa `pagetop-admin` para su menú de
// secciones sin que este tema tenga que depender de él. `BootsierRegions::Sidebar` sigue
// disponible para que cualquier extensión añada elementos propios a mano.
let aside = layout::Region::of(&CoreRegions::Aside).render(cx).await;
let sidebar = layout::Region::of(&bs::BootsierRegions::Sidebar)
.render(cx)
.await;
render_shell(cx, html! { (aside) (sidebar) }).await
}
async fn render_shell(cx: &mut Context, sidebar: Markup) -> Markup {
let navbar = layout::Region::of(&bs::BootsierRegions::Navbar)
.render(cx)
.await;
let content = layout::Region::default().render(cx).await;
let footer = layout::Region::footer().render(cx).await;
html! {
div class="app-wrapper" {
// Barra de navegación superior (app-header)
nav class="app-header navbar navbar-expand bg-body" {
div class="container-fluid" {
ul class="navbar-nav" {
li class="nav-item" {
a class="nav-link" data-lte-toggle="sidebar" href="#" role="button" {
i class="bi bi-list" {}
}
}
}
ul class="navbar-nav ms-auto" {
// Botón de pantalla completa
li class="nav-item" {
a class="nav-link" href="#" data-lte-toggle="fullscreen"
aria-label=[Lc::t("shell_fullscreen", &LOCALES_BOOTSIER).lookup(cx)]
{
i data-lte-icon="maximize" class="bi bi-fullscreen" {}
i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none" {}
}
}
// Selector de modo de color (claro / oscuro / automático)
li class="nav-item dropdown" {
a class="nav-link" href="#" id="bd-theme"
data-bs-toggle="dropdown" aria-expanded="false"
aria-label=[Lc::t("shell_theme_toggle", &LOCALES_BOOTSIER).lookup(cx)]
{
i class="bi bi-sun-fill" data-lte-theme-icon="light" {}
i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark" {}
i class="bi bi-circle-half d-none" data-lte-theme-icon="auto" {}
}
ul class="dropdown-menu dropdown-menu-end" aria-labelledby="bd-theme"
style="--bs-dropdown-min-width: 8rem"
{
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="light"
aria-pressed="false"
{
i class="bi bi-sun-fill me-2" {}
(Lc::t("shell_theme_light", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="dark"
aria-pressed="false"
{
i class="bi bi-moon-fill me-2" {}
(Lc::t("shell_theme_dark", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="auto"
aria-pressed="false"
{
i class="bi bi-circle-half me-2" {}
(Lc::t("shell_theme_auto", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
}
}
(navbar)
}
}
}
// Barra lateral (app-sidebar)
aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark" {
div class="sidebar-brand" {
a href="/" class="brand-link" {
span class="brand-text fw-light" { (global::SETTINGS.app.name) }
}
}
div class="sidebar-wrapper" {
nav class="mt-2" {
ul class="nav sidebar-menu flex-column"
data-lte-toggle="treeview" role="menu"
{
(sidebar)
}
}
}
}
// Área de contenido principal (app-main)
main class="app-main" {
div class="app-content" {
div class="container-fluid" {
(content)
}
}
}
// Pie de página (app-footer)
footer class="app-footer" {
(footer)
}
}
}
}

View file

@ -1,43 +0,0 @@
//! Componentes para la barra lateral de la shell de Bootsier.
//!
//! # Componentes disponibles
//!
//! - [`Section`] - encabezado de grupo (`<li class="nav-header">`).
//! - [`Item`] - enlace de navegación con icono de Bootstrap Icons. Detecta
//! automáticamente si la ruta activa coincide con la del *request* y añade la clase
//! `active` al enlace.
//!
//! # Flujo de uso
//!
//! Los componentes se añaden a la región
//! [`BootsierRegions::Sidebar`](crate::theme::bs::BootsierRegions::Sidebar).
//! El registro global se hace una sola vez en el arranque; el registro por página
//! se hace al construir la página. La región sólo se renderiza en páginas creadas con
//! [`Page::admin()`](pagetop::response::Page::admin); en páginas con
//! [`Page::new()`](pagetop::response::Page::new) no tiene efecto.
//!
//! ```rust,no_run
//! use pagetop::prelude::*;
//! use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
//!
//! // Registro global: visible en todas las páginas de administración.
//! fn register_navigation() {
//! InRegion::Global(&BootsierRegions::Sidebar)
//! .add(sidebar::Section::titled(Lc::n("Administración")))
//! .add(sidebar::Item::link(Lc::n("Usuarios"), "/users", "people"))
//! .add(sidebar::Item::link(Lc::n("Roles"), "/roles", "shield-check"));
//! }
//!
//! // Uso en un handler: la página de administración muestra el sidebar registrado.
//! async fn users(request: HttpRequest) -> Result<Markup, ErrorPage> {
//! Page::admin(request)
//! .with_child(Html::with(|_| html! { h3 { "Usuarios" } }))
//! .render().await
//! }
//! ```
mod item;
pub use item::Item;
mod section;
pub use section::Section;

View file

@ -1,102 +0,0 @@
use pagetop::prelude::*;
// **< Item >***************************************************************************************
/// Elemento de navegación individual en la barra lateral de AdminLTE.
///
/// Renderiza un `<li class="nav-item">` con un enlace `<a class="nav-link">`, un icono de
/// Bootstrap Icons y una etiqueta localizable. Si la ruta del ítem coincide con la del *request*
/// actual, el enlace se marca como activo con la clase `active`.
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::bs::sidebar;
///
/// let item = sidebar::Item::link(
/// Lc::n("Usuarios"),
/// "/users",
/// "people",
/// );
/// ```
#[derive(AutoDefault, Clone, Getters)]
pub struct Item {
/// Devuelve el texto localizable del ítem.
label: Lc,
/// Devuelve la ruta de destino en función del contexto.
#[getters(skip)]
route: Option<Route>,
/// Devuelve el nombre del icono de Bootstrap Icons (sin el prefijo `bi-`).
icon: CowStr,
}
#[async_trait]
impl Component for Item {
fn new() -> Self {
Self::default()
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
let Some(route) = self.route.as_ref() else {
return Ok(html! {});
};
let route_link = route.resolve(cx);
let current_path = cx.request().map(|r| r.path());
let is_active = current_path == Some(route_link.path());
let link_class = if is_active {
"nav-link active"
} else {
"nav-link"
};
let aria_current = is_active.then_some("page");
let icon_class = util::join!("nav-icon bi bi-", self.icon());
Ok(html! {
li class="nav-item" {
a href=(route_link) class=(link_class) aria-current=[aria_current] {
i class=(icon_class) {}
p { (self.label().using(cx)) }
}
}
})
}
}
#[builder_impl]
impl Item {
/// Crea un ítem de navegación con etiqueta, ruta e icono.
///
/// * `label` - Texto localizable del ítem.
/// * `route` - Ruta de destino, resuelta según el contexto (ver [`Route`]).
/// * `icon` - Nombre del icono de Bootstrap Icons sin el prefijo `bi-` (p. ej. `"people"`).
pub fn link(label: Lc, route: impl Into<Route>, icon: impl Into<CowStr>) -> Self {
Self {
label,
route: Some(route.into()),
icon: icon.into(),
}
}
// **< Item BUILDER >***************************************************************************
/// Establece el texto localizable del ítem.
pub fn with_label(mut self, label: Lc) -> Self {
self.label = label;
self
}
/// Establece la ruta de destino del ítem.
pub fn with_route(mut self, route: impl Into<Option<Route>>) -> Self {
self.route = route.into();
self
}
/// Establece el nombre del icono de Bootstrap Icons (sin el prefijo `bi-`).
pub fn with_icon(mut self, icon: impl Into<CowStr>) -> Self {
self.icon = icon.into();
self
}
}

View file

@ -1,57 +0,0 @@
use pagetop::prelude::*;
// **< Section >************************************************************************************
/// Encabezado de sección en la barra lateral de AdminLTE.
///
/// Renderiza un `<li class="nav-header">` con el texto localizable de la sección. Se usa para
/// agrupar visualmente los ítems de navegación ([`Item`](super::Item)) en la sidebar.
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::bs::sidebar;
///
/// // Sección con texto fijo.
/// let section = sidebar::Section::titled(Lc::n("Administración"));
///
/// // Sección con texto localizable.
/// let section_i18n = sidebar::Section::titled(Lc::l("nav-admin"));
/// ```
#[derive(AutoDefault, Clone, Getters)]
pub struct Section {
/// Devuelve el título localizable de la sección.
title: Lc,
}
#[async_trait]
impl Component for Section {
fn new() -> Self {
Self::default()
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
Ok(html! {
li class="nav-header" {
(self.title().using(cx))
}
})
}
}
#[builder_impl]
impl Section {
/// Crea un encabezado de sección con el título indicado.
pub fn titled(title: Lc) -> Self {
Self { title }
}
// **< Section BUILDER >************************************************************************
/// Establece el título localizable de la sección.
pub fn with_title(mut self, title: Lc) -> Self {
self.title = title;
self
}
}

View file

@ -0,0 +1,75 @@
use pagetop::prelude::*;
use crate::LOCALES_BOOTSIER;
/// Crea un [`nav::Item`] con el selector de modo de color (claro / oscuro / automático), pensado
/// para añadirse a cualquier [`Nav`](super::Nav), suelto o dentro de una
/// [`Navbar`](super::Navbar).
///
/// El estado se recuerda en `localStorage` y se aplica con `/bootsier/js/bootsier.theme.min.js`,
/// cargado siempre por Bootsier (ver [`crate::Bootsier::before_render_page_body()`]).
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
/// use pagetop_bootsier::theme::*;
///
/// let navbar = bs::Navbar::simple().with_item(bs::navbar::Item::nav(
/// bs::Nav::new()
/// .with_item(bs::nav::Item::link(Lc::n("Home"), "/"))
/// .with_item(bs::theme_toggle()),
/// ));
/// ```
pub fn theme_toggle() -> nav::Item {
nav::Item::html(Html::with(|cx| {
html! {
a class="nav-link" href="#" id="bd-theme"
data-bs-toggle="dropdown" aria-expanded="false"
aria-label=[Lc::t("shell_theme_toggle", &LOCALES_BOOTSIER).lookup(cx)]
{
i class="bi bi-sun-fill" data-bs-theme-icon="light" {}
i class="bi bi-moon-fill d-none" data-bs-theme-icon="dark" {}
i class="bi bi-circle-half d-none" data-bs-theme-icon="auto" {}
}
ul class="dropdown-menu dropdown-menu-end" aria-labelledby="bd-theme"
style="--bs-dropdown-min-width: 8rem"
{
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="light"
aria-pressed="false"
{
i class="bi bi-sun-fill me-2" {}
(Lc::t("shell_theme_light", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="dark"
aria-pressed="false"
{
i class="bi bi-moon-fill me-2" {}
(Lc::t("shell_theme_dark", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
li {
button type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="auto"
aria-pressed="false"
{
i class="bi bi-circle-half me-2" {}
(Lc::t("shell_theme_auto", &LOCALES_BOOTSIER).using(cx))
i class="bi bi-check-lg ms-auto d-none" {}
}
}
}
}
}))
.with_prop(PropsOp::add_classes("dropdown"))
}