🔥 (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:
parent
6df71885cc
commit
11c2bdffb1
63 changed files with 201 additions and 7491 deletions
|
|
@ -83,7 +83,6 @@ use pagetop::prelude::*;
|
|||
|
||||
include_locales!(LOCALES_BOOTSIER);
|
||||
|
||||
pub(crate) const ADMINLTE_VERSION: &str = "4.0.0";
|
||||
const BOOTSTRAP_VERSION: &str = "5.3.8";
|
||||
|
||||
pub mod config;
|
||||
|
|
@ -169,7 +168,6 @@ impl Theme for Bootsier {
|
|||
cx: &mut Context,
|
||||
) -> Option<Result<Markup, ComponentError>> {
|
||||
render_component!(component, {
|
||||
layout::Region => |c| theme::bs::layout::region::render(c, cx).await?,
|
||||
layout::Template => |c| theme::bs::layout::template::render(c, cx).await?,
|
||||
Dialog => |c| theme::bs::dialog::render(c, cx).await,
|
||||
Dropdown => |c| theme::bs::dropdown::render(c, cx).await,
|
||||
|
|
@ -201,7 +199,7 @@ impl Theme for Bootsier {
|
|||
)
|
||||
.alter_assets(
|
||||
StyleSheet::from("/bootsier/css/bootsier.min.css")
|
||||
.with_version(ADMINLTE_VERSION)
|
||||
.with_version(BOOTSTRAP_VERSION)
|
||||
.with_weight(-99),
|
||||
)
|
||||
.alter_assets(
|
||||
|
|
@ -210,8 +208,8 @@ impl Theme for Bootsier {
|
|||
.with_weight(-99),
|
||||
)
|
||||
.alter_assets(
|
||||
JavaScript::defer("/bootsier/js/bootsier.extended.min.js")
|
||||
.with_version(ADMINLTE_VERSION)
|
||||
JavaScript::defer("/bootsier/js/bootsier.theme.min.js")
|
||||
.with_version(BOOTSTRAP_VERSION)
|
||||
.with_weight(-99),
|
||||
)
|
||||
.alter_assets(
|
||||
|
|
|
|||
|
|
@ -7,8 +7,7 @@ toggle = Toggle navigation
|
|||
# Offcanvas
|
||||
offcanvas_close = Close
|
||||
|
||||
# Shell AdminLTE (BootsierTemplates::Admin)
|
||||
shell_fullscreen = Full screen
|
||||
# Theme toggle
|
||||
shell_theme_toggle = Color mode selector
|
||||
shell_theme_light = Light
|
||||
shell_theme_dark = Dark
|
||||
|
|
|
|||
|
|
@ -1,3 +0,0 @@
|
|||
# BootsierRegions
|
||||
region_sidebar = Sidebar
|
||||
region_navbar = Navigation bar
|
||||
|
|
@ -7,8 +7,7 @@ toggle = Mostrar/ocultar navegación
|
|||
# Offcanvas
|
||||
offcanvas_close = Cerrar
|
||||
|
||||
# Shell AdminLTE (BootsierTemplates::Admin)
|
||||
shell_fullscreen = Pantalla completa
|
||||
# Theme toggle
|
||||
shell_theme_toggle = Selector de modo de color
|
||||
shell_theme_light = Claro
|
||||
shell_theme_dark = Oscuro
|
||||
|
|
|
|||
|
|
@ -1,3 +0,0 @@
|
|||
# BootsierRegions
|
||||
region_sidebar = Barra lateral
|
||||
region_navbar = Barra de navegación
|
||||
|
|
@ -11,10 +11,12 @@
|
|||
//!
|
||||
//! # Plantillas
|
||||
//!
|
||||
//! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]): `Standard`, con cabecera,
|
||||
//! contenido y pie, que es la plantilla por defecto de cualquier página; y `Admin`, con la shell
|
||||
//! completa de administración (barra superior + barra lateral + área de contenido), que se activa
|
||||
//! creando la página con [`Page::admin()`] en lugar de [`Page::new()`].
|
||||
//! 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`).
|
||||
//!
|
||||
//! ```rust,no_run
|
||||
//! use pagetop::prelude::*;
|
||||
|
|
@ -33,60 +35,29 @@
|
|||
//! [`Page::admin()`]: pagetop::response::Page::admin
|
||||
//! [`Page::new()`]: pagetop::response::Page::new
|
||||
//!
|
||||
//! # Barra lateral
|
||||
//! # Menú de administración
|
||||
//!
|
||||
//! Registra elementos en [`BootsierRegions::Sidebar`](bs::BootsierRegions::Sidebar) para poblar la
|
||||
//! barra lateral de la shell. Los elementos esperados son [`bs::sidebar::Item`] y
|
||||
//! [`bs::sidebar::Section`].
|
||||
//! `pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y
|
||||
//! páginas en [`CoreRegions::Aside`](pagetop::core::theme::CoreRegions::Aside), autolimitado a
|
||||
//! páginas con la plantilla `Admin` -- no requiere ningún registro por parte de Bootsier. Se
|
||||
//! construye con [`Navbar`](bs::Navbar)/[`Nav`](bs::Nav)/[`Dropdown`](bs::Dropdown), los mismos
|
||||
//! componentes disponibles para cualquier página de la aplicación.
|
||||
//!
|
||||
//! De forma **global** (visibles en todas las páginas de administración):
|
||||
//! # Selector de modo de color
|
||||
//!
|
||||
//! [`bs::theme_toggle()`] crea un ítem de menú con el selector de modo de color (claro / oscuro /
|
||||
//! automático), pensado para añadirse a cualquier [`Nav`](bs::Nav) de la aplicación, no sólo a las
|
||||
//! páginas de administración:
|
||||
//!
|
||||
//! ```rust,no_run
|
||||
//! use pagetop::prelude::*;
|
||||
//! use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
|
||||
//! use pagetop_bootsier::theme::*;
|
||||
//!
|
||||
//! 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"));
|
||||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! O de forma **por página**:
|
||||
//!
|
||||
//! ```rust,no_run
|
||||
//! use pagetop::prelude::*;
|
||||
//! use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
|
||||
//!
|
||||
//! async fn settings(request: HttpRequest) -> Result<Markup, ErrorPage> {
|
||||
//! Page::admin(request)
|
||||
//! .with_child_in(
|
||||
//! &BootsierRegions::Sidebar,
|
||||
//! sidebar::Item::link(Lc::n("Ajustes"), "/settings", "gear"),
|
||||
//! )
|
||||
//! .with_child(Html::with(|_| html! { h3 { "Ajustes" } }))
|
||||
//! .render().await
|
||||
//! }
|
||||
//! ```
|
||||
//!
|
||||
//! # Barra de navegación superior
|
||||
//!
|
||||
//! La barra superior incluye por defecto los controles de pantalla completa y selector de tema.
|
||||
//! Para añadir elementos adicionales en el lado derecho (por ejemplo, el dropdown de usuario de
|
||||
//! `pagetop-user`), registra componentes en
|
||||
//! [`BootsierRegions::Navbar`](bs::BootsierRegions::Navbar):
|
||||
//!
|
||||
//! ```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" }
|
||||
//! }
|
||||
//! }));
|
||||
//! 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()),
|
||||
//! ));
|
||||
//! ```
|
||||
|
||||
use pagetop::prelude::*;
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -1,4 +1 @@
|
|||
pub(crate) mod region;
|
||||
pub use region::BootsierRegions;
|
||||
|
||||
pub(crate) mod template;
|
||||
|
|
|
|||
|
|
@ -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))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -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)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
@ -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
|
||||
}
|
||||
}
|
||||
|
|
@ -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
|
||||
}
|
||||
}
|
||||
75
extensions/pagetop-bootsier/src/theme/bs/theme_toggle.rs
Normal file
75
extensions/pagetop-bootsier/src/theme/bs/theme_toggle.rs
Normal 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"))
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue