♻️ (admin): Navegación del panel con Nav::admin()

La plantilla Admin ya no pinta la navegación del panel: la coloca la
aplicación con Nav::admin(), en una barra aparte o en la suya. Se
elimina AdminMenu y AdminFrame pasa a layout::AdminFrame.
This commit is contained in:
Manuel Cillero 2026-11-16 13:09:08 +01:00
parent a29f0f2b75
commit 105d5a81af
15 changed files with 375 additions and 107 deletions

View file

@ -95,9 +95,10 @@ async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
## Panel de administració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
En la plantilla `Admin`, Bootsier sigue la composición del núcleo: en lugar del contenido pinta el
marco de la página (`AdminFrame`: migas, título, botones y pestañas). La navegación del panel
(`Nav::admin()`) la coloca la aplicación, en una barra aparte o en su barra principal, donde se
pliega con su botón en pantallas pequeñas. Todo se construye con componentes del núcleo
(`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto.
## Selector de modo de color

View file

@ -96,9 +96,10 @@ async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
## Panel de administració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
En la plantilla `Admin`, Bootsier sigue la composición del núcleo: en lugar del contenido pinta el
marco de la página (`AdminFrame`: migas, título, botones y pestañas). La navegación del panel
(`Nav::admin()`) la coloca la aplicación, en una barra aparte o en su barra principal, donde se
pliega con su botón en pantallas pequeñas. Todo se construye con componentes del núcleo
(`Navbar`/`Nav`/`Dropdown`, `Breadcrumb`), que Bootsier ya pinta con su aspecto.
## Selector de modo de color
@ -257,7 +258,7 @@ impl Theme for Bootsier {
fn breakpoint_entry(&self, bp: Breakpoint) -> BreakpointEntry {
use Breakpoint::*;
// Anchos mínimos de la rejilla de Bootstrap (`$grid-breakpoints`). Bootstrap no tiene un
// Anchos mínimos de los puntos de corte de Bootstrap (`$grid-breakpoints`). No tiene un
// punto de corte por encima de `xxl`, así que `Xxxl` se resuelve como `xxl`.
match bp {
Xs => BreakpointEntry { breakpoint: Xs, name: "xs", min_width: "" },

View file

@ -35,10 +35,13 @@
//!
//! # Panel de administració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.
//! En la plantilla `Admin`, Bootsier sigue la composición del núcleo: en lugar del contenido pinta
//! el marco de la página ([`AdminFrame`]: migas, título, botones y pestañas). La navegación del
//! panel ([`Nav::admin()`]) la coloca la aplicación, en una barra aparte o en su barra principal,
//! donde se pliega con su botón en pantallas pequeñas. Todo se construye con componentes del núcleo
//! ([`Navbar`]/[`Nav`]/[`Dropdown`], [`Breadcrumb`]), que Bootsier ya pinta con su aspecto.
//!
//! [`AdminFrame`]: pagetop::prelude::layout::AdminFrame
//!
//! # Selector de modo de color
//!

View file

@ -8,9 +8,9 @@ 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` 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`.
// `CoreTemplates::Admin` sigue la composición del núcleo: en lugar del contenido, el marco de la
// página (`AdminFrame`), que contiene la región `Content`. La navegación del panel la coloca la
// aplicación (`Nav::admin()`).
pub(crate) async fn render(
component: &layout::Template,
cx: &mut Context,
@ -33,15 +33,13 @@ async fn render_standard(cx: &mut Context) -> Markup {
.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`.
// Como `render_standard()`, con 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::AdminFrame::new())
.with_child(layout::Region::footer())
.render(cx)
.await

View file

@ -83,7 +83,9 @@
//! [`DeclareAdminTasks`]: crate::base::action::admin::DeclareAdminTasks
//! [`DeclareAdminActions`]: crate::base::action::admin::DeclareAdminActions
use crate::core::component::Context;
use crate::core::AnyCast;
use crate::core::component::{Context, Contextual};
use crate::core::theme::CoreTemplates;
use crate::{global, util};
mod bag;
@ -136,3 +138,25 @@ pub fn can_access_admin(cx: &Context) -> bool {
.iter()
.any(|page| registry.section(page.section()).is_some() && page.is_accessible(cx))
}
/// Devuelve `true` si la página es del panel de administración y el usuario tiene acceso a él.
///
/// Concretamente, devuelve `true` cuando la página actual del contexto utiliza la plantilla
/// [`CoreTemplates::Admin`] y el usuario de la petición puede acceder a alguna de las páginas del
/// panel ([`can_access_admin()`]).
///
/// Es la condición con la que se muestra la navegación del panel ([`Nav::admin()`]). Una página del
/// panel puede responder a quien no tiene acceso (el error 403 se pinta con la plantilla de la
/// página), así que no basta con comprobar la plantilla.
///
/// Sirve también para ocultar en el panel uno o más menús, negando esta función en su
/// [`Nav::with_renderable()`].
///
/// [`Nav::admin()`]: crate::base::component::Nav::admin
/// [`Nav::with_renderable()`]: crate::base::component::Nav::with_renderable
pub fn is_admin_panel(cx: &Context) -> bool {
matches!(
cx.template().downcast_ref::<CoreTemplates>(),
Some(CoreTemplates::Admin)
) && can_access_admin(cx)
}

View file

@ -2,12 +2,6 @@
pub mod layout;
mod admin_frame;
pub use admin_frame::AdminFrame;
mod admin_menu;
pub use admin_menu::AdminMenu;
mod badge;
pub use badge::Badge;

View file

@ -1,60 +0,0 @@
use crate::prelude::*;
/// Navegación del panel de administración para el usuario de la petición actual.
///
/// Es una [`Navbar`] con un enlace al inicio del panel (*dashboard*) seguido de un desplegable por
/// sección, con las páginas de cada una a las que el usuario puede acceder; las secciones sin
/// ninguna no se muestran. Lo construye en cada petición a partir de [`AdminRegistry`].
///
/// La plantilla [`CoreTemplates::Admin`] lo pinta tras la región [`CoreRegions::Header`]. Se
/// construye sólo con componentes del núcleo (`Navbar`, `Nav` y `Dropdown`), así que un tema le da
/// su aspecto capturando esos componentes o éste mismo en [`Theme::render_component()`].
///
/// Sin acceso a ninguna página del panel ([`can_access_admin()`]) no se renderiza: no se despachan
/// sus acciones ni intervienen los temas.
///
/// [`Theme::render_component()`]: crate::core::theme::Theme::render_component
#[derive(AutoDefault, Clone, Debug)]
pub struct AdminMenu;
#[async_trait]
impl Component for AdminMenu {
fn new() -> Self {
Self
}
fn is_renderable(&self, cx: &Context) -> bool {
can_access_admin(cx)
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
let registry = AdminRegistry::global();
let mut nav =
Nav::new().with_item(nav::Item::link(Lc::l("admin_dashboard"), admin_path("")));
for section in registry.sections() {
let pages: Vec<_> = registry
.pages_for_section(section.key())
.iter()
.filter(|p| p.is_accessible(cx))
.collect();
if pages.is_empty() {
continue;
}
let mut menu = Dropdown::new().with_title(section.title().clone());
for page in pages {
menu = menu.with_item(dropdown::Item::link(
page.title().clone(),
admin_path(page.path()),
));
}
nav = nav.with_item(nav::Item::dropdown(menu));
}
Ok(Navbar::simple()
.with_prop(PropsOp::add_classes("admin-menu"))
.with_item(navbar::Item::nav(nav))
.render(cx)
.await)
}
}

View file

@ -1,4 +1,7 @@
//! Definiciones para la composición de documentos ([`Region`] y [`Template`]).
//! Definiciones para la composición de documentos ([`Region`], [`Template`] y [`AdminFrame`]).
mod admin_frame;
pub use admin_frame::AdminFrame;
mod region;
pub use region::Region;

View file

@ -2,7 +2,7 @@ use crate::prelude::*;
/// Marco de las páginas de administración, alrededor de [`CoreRegions::Content`].
///
/// Pinta, para la ruta de la petición actual, las migas de pan del panel, el título de la página
/// Muestra, para la ruta de la petición actual, el *breadcrumb* del panel, el título de la página
/// ([`Contextual::title()`]) con sus botones de acción ([`AdminAction`]), las pestañas de la
/// página ([`AdminTask`]) y, después, el contenido. Si la página no tiene título, usa el de la
/// página declarada para esa ruta, también en el `<title>` del documento:
@ -17,10 +17,10 @@ use crate::prelude::*;
/// <div class="admin-content">...</div>
/// ```
///
/// La plantilla [`CoreTemplates::Admin`] lo pinta en lugar de la región `Content`, así que un
/// La plantilla [`CoreTemplates::Admin`] lo muestra en lugar de la región `Content`, así que un
/// *handler* sólo tiene que crear la página con [`Page::admin()`], darle título y añadir su
/// contenido. Un tema puede capturarlo en [`Theme::render_component()`] para darle otro aspecto,
/// pero entonces le corresponde pintar también la región `Content`
/// pero entonces le corresponde mostrar también la región `Content`
/// ([`layout::Region::content()`](crate::base::component::layout::Region::content)).
///
/// Para una ruta que no es una página declarada (p. ej. la edición de un elemento de un listado),

View file

@ -10,9 +10,10 @@ use std::fmt;
/// su gusto (por ejemplo, usando CSS Grid, para que `Aside` se muestre como columna lateral junto a
/// `Content`). Si `Aside`, o cualquier otra región, no tiene contenido, no se renderiza.
///
/// [`CoreTemplates::Admin`] añade el panel de administración: tras `Header` pinta la navegación
/// del panel ([`AdminMenu`]) y, en lugar de `Content`, el marco de la página ([`AdminFrame`]), que
/// contiene la región; el contenedor lleva además la clase `wrapper-admin`.
/// [`CoreTemplates::Admin`] añade el panel de administración: en lugar de `Content` pinta el marco
/// de la página ([`AdminFrame`]), que contiene la región; el contenedor lleva además la clase
/// `wrapper-admin`. La navegación del panel no forma parte de la plantilla: la coloca la aplicación
/// donde quiera, con [`Nav::admin()`] en una barra aparte o en la suya.
///
/// No incluye las regiones reservadas ([`ReservedRegions::PageTop`] y
/// [`ReservedRegions::PageBottom`]) porque el propio [`Page::render()`] las añade antes y después
@ -28,6 +29,8 @@ use std::fmt;
/// intervenir en su renderizado.
///
/// [`Region`]: crate::base::component::layout::Region
/// [`AdminFrame`]: crate::base::component::layout::AdminFrame
/// [`Nav::admin()`]: crate::base::component::Nav::admin
/// [`ReservedRegions::PageTop`]: crate::response::ReservedRegions::PageTop
/// [`ReservedRegions::PageBottom`]: crate::response::ReservedRegions::PageBottom
/// [`Page::render()`]: crate::response::Page::render
@ -76,9 +79,8 @@ impl Component for Template {
let body = if admin {
html! {
(layout::Region::header().render(cx).await)
(AdminMenu::new().render(cx).await)
(layout::Region::aside().render(cx).await)
(AdminFrame::new().render(cx).await)
(layout::AdminFrame::new().render(cx).await)
(layout::Region::footer().render(cx).await)
}
} else {

View file

@ -8,6 +8,9 @@ use crate::prelude::*;
/// Si no contiene elementos, o si ninguno se muestra (ver [`Endpoint`]), el componente **no se
/// renderiza**.
///
/// Con [`with_renderable()`](Nav::with_renderable) se puede decidir en cada petición si se muestra,
/// y con [`Nav::admin()`] presenta la navegación del panel de administración.
///
/// # Ejemplo
///
/// ```rust,no_run
@ -32,6 +35,13 @@ pub struct Nav {
nav_layout: nav::Layout,
/// Devuelve la lista de elementos del menú.
items: Children,
/// Devuelve la función que decide en cada petición si se renderiza, si la hay (ver
/// [`with_renderable()`](Nav::with_renderable)).
#[getters(copy)]
renderable: Option<FnIsRenderable>,
/// Indica si presenta la navegación del panel de administración (ver [`Nav::admin()`]).
#[getters(copy)]
is_admin: bool,
}
#[async_trait]
@ -44,7 +54,11 @@ impl Component for Nav {
self.props.get_id()
}
fn setup(&mut self, _cx: &mut Context) {
fn is_renderable(&self, cx: &Context) -> bool {
self.renderable().is_none_or(|f| f(cx)) && (!self.is_admin() || is_admin_panel(cx))
}
fn setup(&mut self, cx: &mut Context) {
self.alter_prop(PropsOp::prepend_classes(match self.nav_layout() {
nav::Layout::Default => "nav",
nav::Layout::Start => "nav nav-start",
@ -54,6 +68,10 @@ impl Component for Nav {
nav::Layout::Fill => "nav nav-fill",
nav::Layout::Justified => "nav nav-justified",
}));
if self.is_admin() {
self.alter_prop(PropsOp::add_classes("nav-admin"));
self.add_admin_items(cx);
}
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
@ -70,6 +88,89 @@ impl Component for Nav {
}
}
impl Nav {
/// Crea la navegación del panel de administración para el usuario de la petición actual.
///
/// Al renderizarse añade un enlace al inicio del panel (*dashboard*) seguido de un desplegable
/// por sección, con las páginas de cada una a las que el usuario puede acceder; las secciones
/// sin ninguna no se muestran. Los construye en cada petición a partir de [`AdminRegistry`],
/// detrás de los elementos que se hayan añadido con [`with_item()`](Self::with_item).
///
/// Sólo se renderiza en las páginas del panel y si el usuario puede acceder a él
/// ([`is_admin_panel()`]); en las demás no se despachan sus acciones ni intervienen los temas.
/// Así puede colocarse en una barra o región presente en todas las páginas. Para que ocupe en
/// el panel el sitio de otro menú, ese otro menú se oculta en el panel con
/// [`with_renderable()`](Self::with_renderable) (ver el ejemplo).
///
/// La plantilla [`CoreTemplates::Admin`] no la pinta: la coloca la aplicación donde quiera,
/// como cualquier otro menú, con su disposición, clases y propiedades. Lleva además la clase
/// `nav-admin`, para que los temas puedan darle un aspecto propio.
///
/// # Ejemplos
///
/// En una barra aparte bajo la cabecera, centrada:
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// let admin = Navbar::simple().with_item(navbar::Item::nav(
/// Nav::admin()
/// .with_layout(nav::Layout::Center)
/// .with_prop(FlexItem::new().with_grow(flex::ItemGrow::Is1)),
/// ));
///
/// InRegion::Global(&CoreRegions::Header).add(admin);
/// ```
///
/// En la barra principal, junto al menú de la aplicación y centrada en el espacio libre:
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// let navbar = Navbar::brand_left(Brand::new().with_title(Lc::n("My app")))
/// .with_item(navbar::Item::nav(
/// Nav::new().with_item(nav::Item::link(Lc::n("Home"), "/")),
/// ))
/// .with_item(navbar::Item::nav(
/// Nav::admin()
/// .with_layout(nav::Layout::Center)
/// .with_prop(FlexItem::new().with_grow(flex::ItemGrow::Is1)),
/// ));
///
/// InRegion::Global(&CoreRegions::Header).add(navbar);
/// ```
pub fn admin() -> Self {
Self {
is_admin: true,
..Self::default()
}
}
// Añade el enlace al *dashboard* y un desplegable por sección con las páginas a las que puede
// acceder el usuario de la petición.
fn add_admin_items(&mut self, cx: &Context) {
let registry = AdminRegistry::global();
self.alter_item(nav::Item::link(Lc::l("admin_dashboard"), admin_path("")));
for section in registry.sections() {
let mut pages = registry
.pages_for_section(section.key())
.iter()
.filter(|p| p.is_accessible(cx))
.peekable();
if pages.peek().is_none() {
continue;
}
let mut menu = Dropdown::new().with_title(section.title().clone());
for page in pages {
menu = menu.with_item(dropdown::Item::link(
page.title().clone(),
admin_path(page.path()),
));
}
self.alter_item(nav::Item::dropdown(menu));
}
}
}
#[builder_impl]
impl Nav {
// **< Nav BUILDER >****************************************************************************
@ -92,6 +193,38 @@ impl Nav {
self
}
/// Asigna una función que decide en cada petición si el menú se renderiza.
///
/// Se evalúa antes que cualquier otra fase de su ciclo: si devuelve `false`, el menú no se
/// renderiza, no se despachan sus acciones ni intervienen los temas. Así un menú creado una
/// sola vez (por ejemplo, en una barra registrada con [`InRegion`]) puede mostrarse sólo en
/// las páginas que corresponda. Un cierre sin capturas sirve como función.
///
/// # Ejemplo
///
/// Menú principal que, en las páginas del panel de administración, deja su sitio a la
/// navegación del panel ([`Nav::admin()`]). Como ésta se muestra justo cuando se cumple
/// [`is_admin_panel()`], el menú principal usa la condición contraria: en cada página se ve uno
/// de los dos, también en una página del panel que responde a quien no tiene acceso (un error
/// 403), donde se ve el menú principal:
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// let main = Nav::new()
/// .with_item(nav::Item::link(Lc::n("Home"), "/"))
/// .with_renderable(|cx| !is_admin_panel(cx));
///
/// let navbar = Navbar::brand_left(Brand::new().with_title(Lc::n("My app")))
/// .with_item(navbar::Item::nav(main))
/// .with_item(navbar::Item::nav(Nav::admin()));
///
/// InRegion::Global(&CoreRegions::Header).add(navbar);
/// ```
pub fn with_renderable(mut self, f: FnIsRenderable) -> Self {
self.renderable = Some(f);
self
}
/// Añade un nuevo elemento al menú o modifica la lista de elementos del menú con una
/// operación [`TypedOp`].
///

View file

@ -211,8 +211,10 @@ pub trait Contextual {
/// Establece el título del documento como un valor traducible.
///
/// Además de usarse en el `<head>`, lo ven las plantillas y los componentes al renderizarse,
/// como el marco de las páginas del panel de administración
/// ([`AdminFrame`](crate::base::component::AdminFrame)), que lo muestra como encabezado.
/// como el marco de las páginas del panel de administración ([`AdminFrame`]), que lo muestra
/// como encabezado.
///
/// [`AdminFrame`]: crate::base::component::layout::AdminFrame
fn with_title(self, title: Lc) -> Self {
self.context_mut().title = title;
self

View file

@ -177,13 +177,16 @@ pub enum CoreTemplates {
/// Plantilla para la **interfaz de administración**, de nombre `"admin"`.
///
/// Se utiliza para las páginas del panel de administración ([`Page::admin()`]): además de las
/// regiones de `Standard`, pinta la navegación del panel ([`AdminMenu`]) y el marco de la
/// página ([`AdminFrame`]) alrededor de la región de contenido.
/// Se utiliza para las páginas del panel de administración ([`Page::admin()`]). Además de las
/// regiones de `Standard`, muestra también el marco de la página ([`AdminFrame`]) alrededor de
/// la región de contenido.
///
/// Sin embargo, no muestra el menú de navegación del panel: será la aplicación la que decida
/// dónde colocarlo, usando [`Nav::admin()`].
///
/// [`Page::admin()`]: crate::response::Page::admin
/// [`AdminMenu`]: crate::base::component::AdminMenu
/// [`AdminFrame`]: crate::base::component::AdminFrame
/// [`AdminFrame`]: crate::base::component::layout::AdminFrame
/// [`Nav::admin()`]: crate::base::component::Nav::admin
Admin,
}

View file

@ -116,10 +116,8 @@ async fn the_admin_template_frames_the_content_of_the_page() {
render(Page::admin(request("/admin/config/export/csv")).with_title(Lc::n("CSV"))).await;
assert!(html.contains(r#"class="wrapper wrapper-admin""#), "{html}");
// Navigation: only the sections with an accessible page.
assert!(html.contains("admin-menu"), "{html}");
assert!(html.contains(r#"href="/admin/config/export""#), "{html}");
assert!(!html.contains(r#"href="/admin/reports/audit""#), "{html}");
// The template does not paint the navigation of the panel: the application places it.
assert!(!html.contains("nav-admin"), "{html}");
// Breadcrumbs up to the nearest declared page, then the page title.
assert!(html.contains(r#"href="/admin/config""#), "{html}");
assert!(
@ -165,11 +163,156 @@ async fn the_standard_template_has_no_admin_frame() {
let html = render(Page::new(request("/admin/config/export")).with_title(Lc::n("Export"))).await;
assert!(!html.contains("wrapper-admin"), "{html}");
assert!(!html.contains("admin-menu"), "{html}");
assert!(!html.contains("nav-admin"), "{html}");
assert!(!html.contains("admin-content"), "{html}");
assert!(html.contains("Body of the page."), "{html}");
}
// Navigation of the panel in its own bar.
fn admin_navbar() -> Navbar {
Navbar::simple().with_item(navbar::Item::nav(Nav::admin()))
}
#[pagetop::test]
async fn the_admin_menu_goes_where_the_application_places_it() {
let _ = Application::prepare(&Ext).await;
let page = Page::admin(request("/admin/config/export/csv"))
.with_child_in(&CoreRegions::Header, admin_navbar());
let html = render(page).await;
// Only the sections with an accessible page.
let header = &html[html.find(r#"id="header""#).unwrap()..html.find("admin-content").unwrap()];
assert!(header.contains("nav-admin"), "{header}");
assert!(header.contains("navbar-nav"), "{header}");
assert!(
header.contains(r#"href="/admin/config/export""#),
"{header}"
);
assert!(
!header.contains(r#"href="/admin/reports/audit""#),
"{header}"
);
}
#[pagetop::test]
async fn the_admin_menu_only_shows_in_the_panel() {
let _ = Application::prepare(&Ext).await;
let page = Page::new(request("/home")).with_child_in(&CoreRegions::Header, admin_navbar());
let html = render(page).await;
assert!(!html.contains("nav-admin"), "{html}");
assert!(!html.contains(r#"href="/admin"#), "{html}");
}
#[pagetop::test]
async fn the_admin_menu_does_not_repeat_its_links_when_rendered_again() {
let _ = Application::prepare(&Ext).await;
// The same prototype for every page, as with `InRegion`.
let navbar = admin_navbar();
for _ in 0..2 {
let page = Page::admin(request("/admin/config/export"))
.with_child_in(&CoreRegions::Header, navbar.clone());
let html = render(page).await;
// Links of the menu only (the breadcrumbs also link to the dashboard).
let links = r#"class="nav-link" href="/admin""#;
assert_eq!(html.matches(links).count(), 1, "{html}");
}
}
// Main navbar of an application, with its own menu and the navigation of the panel.
fn main_navbar() -> Navbar {
Navbar::simple()
.with_item(navbar::Item::nav(
Nav::new().with_item(nav::Item::link(Lc::n("Home"), "/home")),
))
.with_item(navbar::Item::nav(Nav::admin()))
}
#[pagetop::test]
async fn the_admin_menu_can_go_in_the_main_navbar() {
let _ = Application::prepare(&Ext).await;
let page = Page::admin(request("/admin/config/export/csv"))
.with_child_in(&CoreRegions::Header, main_navbar());
let html = render(page).await;
// The navigation of the panel goes in the main navbar, with the accessible pages only.
let header = &html[html.find(r#"id="header""#).unwrap()..html.find("admin-content").unwrap()];
assert!(header.contains(r#"href="/home""#), "{header}");
assert!(header.contains(r#"href="/admin""#), "{header}");
assert!(
header.contains(r#"href="/admin/config/export""#),
"{header}"
);
assert!(
!header.contains(r#"href="/admin/reports/audit""#),
"{header}"
);
}
#[pagetop::test]
async fn the_admin_nav_keeps_its_layout_in_the_main_navbar() {
let _ = Application::prepare(&Ext).await;
let navbar = Navbar::simple().with_item(navbar::Item::nav(
Nav::admin()
.with_id("admin-nav")
.with_layout(nav::Layout::Center),
));
let page =
Page::admin(request("/admin/config/export")).with_child_in(&CoreRegions::Header, navbar);
let html = render(page).await;
let start = html
.find(r#"id="admin-nav""#)
.expect("the admin nav is rendered");
let nav = &html[html[..start].rfind('<').unwrap()..];
let nav = &nav[..nav.find('>').unwrap()];
assert!(nav.contains("nav-center"), "{nav}");
assert!(nav.contains("nav-admin"), "{nav}");
assert!(html.contains(r#"href="/admin/config/export""#), "{html}");
}
// Main navbar whose own menu leaves its place to the navigation of the panel.
fn swapping_navbar() -> Navbar {
Navbar::simple()
.with_item(navbar::Item::nav(
Nav::new()
.with_item(nav::Item::link(Lc::n("Home"), "/home"))
.with_renderable(|cx| !is_admin_panel(cx)),
))
.with_item(navbar::Item::nav(Nav::admin()))
}
#[pagetop::test]
async fn the_admin_nav_takes_the_place_of_the_main_menu_in_the_panel() {
let _ = Application::prepare(&Ext).await;
let page = Page::admin(request("/admin/config/export"))
.with_child_in(&CoreRegions::Header, swapping_navbar());
let html = render(page).await;
assert!(html.contains(r#"href="/admin/config/export""#), "{html}");
assert!(!html.contains(r#"href="/home""#), "{html}");
}
#[pagetop::test]
async fn the_main_menu_shows_outside_the_panel() {
let _ = Application::prepare(&Ext).await;
let page = Page::new(request("/home")).with_child_in(&CoreRegions::Header, swapping_navbar());
let html = render(page).await;
assert!(html.contains(r#"href="/home""#), "{html}");
assert!(!html.contains(r#"href="/admin"#), "{html}");
}
#[pagetop::test]
async fn the_admin_menu_of_the_main_navbar_only_shows_in_the_panel() {
let _ = Application::prepare(&Ext).await;
let page = Page::new(request("/home")).with_child_in(&CoreRegions::Header, main_navbar());
let html = render(page).await;
assert!(html.contains(r#"href="/home""#), "{html}");
assert!(!html.contains(r#"href="/admin"#), "{html}");
}
async fn get(uri: &str) -> (u16, String) {
let app = Application::prepare(&Ext).await.test();
let request = web::test::TestRequest::get().uri(uri).to_request();

View file

@ -13,3 +13,24 @@ async fn without_declared_pages_the_panel_is_not_mounted() {
assert_eq!(response.status().as_u16(), 404, "{uri}");
}
}
#[pagetop::test]
async fn without_access_to_the_panel_its_pages_show_the_main_menu() {
let _ = Application::prepare(&Ext).await;
let navbar = Navbar::simple()
.with_item(navbar::Item::nav(
Nav::new()
.with_item(nav::Item::link(Lc::n("Home"), "/home"))
.with_renderable(|cx| !is_admin_panel(cx)),
))
.with_item(navbar::Item::nav(Nav::admin()));
// A page with the admin template that nobody can access, as an error 403 would be.
let request = web::test::TestRequest::get()
.uri("/admin")
.to_http_request();
let mut page = Page::admin(request).with_child_in(&CoreRegions::Header, navbar);
let html = page.render().await.unwrap().into_string();
assert!(html.contains(r#"href="/home""#), "{html}");
assert!(!html.contains("nav-admin"), "{html}");
}