From c940403869dc9076d0b7a3c6b0a2413f39e637e0 Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Sun, 8 Nov 2026 10:11:42 +0100 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20(base):=20Oculta=20separadores=20en?= =?UTF-8?q?=20men=C3=BAs=20sin=20opciones?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `Dropdown::items()` devuelve `dropdown::Items`, cuyo `render()` sólo pinta un encabezado si su grupo tiene algún elemento visible, y un separador sólo entre elementos visibles. Lo aprovecha cualquier tema que pinte el menú con `items().render()`. --- .../pagetop-bootsier/src/theme/bs/dropdown.rs | 2 +- .../pagetop-bootsier/tests/hidden_links.rs | 14 +- src/base/component/dropdown.rs | 3 + src/base/component/dropdown/component.rs | 21 ++- src/base/component/dropdown/item.rs | 3 +- src/base/component/dropdown/items.rs | 68 ++++++++ src/core/component/children.rs | 24 +++ tests/component_children.rs | 22 +++ tests/component_dropdown.rs | 145 ++++++++++++++++++ 9 files changed, 292 insertions(+), 10 deletions(-) create mode 100644 src/base/component/dropdown/items.rs diff --git a/extensions/pagetop-bootsier/src/theme/bs/dropdown.rs b/extensions/pagetop-bootsier/src/theme/bs/dropdown.rs index b5660a19..8ab4db6e 100644 --- a/extensions/pagetop-bootsier/src/theme/bs/dropdown.rs +++ b/extensions/pagetop-bootsier/src/theme/bs/dropdown.rs @@ -15,7 +15,7 @@ mod props; pub use props::{AutoClose, Direction, MenuAlign, MenuPosition}; pub use pagetop::base::component::Dropdown; -pub use pagetop::base::component::dropdown::{Item, ItemKind}; +pub use pagetop::base::component::dropdown::{Item, ItemKind, Items}; const EXTRA_BUTTON_GROUPED: &str = "bootsier.dropdown.button_grouped"; const EXTRA_AUTO_CLOSE: &str = "bootsier.dropdown.auto_close"; diff --git a/extensions/pagetop-bootsier/tests/hidden_links.rs b/extensions/pagetop-bootsier/tests/hidden_links.rs index f39be679..43dc5b1d 100644 --- a/extensions/pagetop-bootsier/tests/hidden_links.rs +++ b/extensions/pagetop-bootsier/tests/hidden_links.rs @@ -66,6 +66,9 @@ fn menu() -> Nav { .with_item(bs::nav::Item::dropdown( Dropdown::new() .with_title(Lc::n("dropdown-partial")) + .with_item(dropdown::Item::header(Lc::n("header-empty"))) + .with_item(dropdown::Item::link(Lc::n("x"), TestRoute::Forbidden)) + .with_item(dropdown::Item::divider()) .with_item(dropdown::Item::link( Lc::n("in-allowed"), TestRoute::Allowed, @@ -97,9 +100,18 @@ fn assert_only_allowed_links(html: &str) { for shown in ["nav-allowed", "dropdown-partial", "in-allowed"] { assert!(html.contains(shown), "`{shown}` is missing in {html}"); } - for hidden in ["nav-forbidden", "dropdown-empty", "in-forbidden"] { + for hidden in [ + "nav-forbidden", + "dropdown-empty", + "in-forbidden", + "header-empty", + ] { assert!(!html.contains(hidden), "`{hidden}` is shown in {html}"); } + assert!( + !html.contains("dropdown-divider"), + "a divider is shown in {html}" + ); } #[pagetop::test] diff --git a/src/base/component/dropdown.rs b/src/base/component/dropdown.rs index 631c8974..466f4198 100644 --- a/src/base/component/dropdown.rs +++ b/src/base/component/dropdown.rs @@ -5,3 +5,6 @@ pub use component::Dropdown; mod item; pub use item::{Item, ItemKind}; + +mod items; +pub use items::Items; diff --git a/src/base/component/dropdown/component.rs b/src/base/component/dropdown/component.rs index 5de952ee..a2b19b02 100644 --- a/src/base/component/dropdown/component.rs +++ b/src/base/component/dropdown/component.rs @@ -2,13 +2,15 @@ use crate::prelude::*; /// Componente para crear un **menú desplegable**. /// -/// Renderiza un botón (único o desdoblado, ver [`with_button_split()`](Self::with_button_split)) -/// que despliega u oculta una lista de elementos [`dropdown::Item`](super::Item). +/// Renderiza un botón (único o desdoblado, ver [`with_button_split()`]) que despliega u oculta una +/// lista de elementos [`dropdown::Item`]. /// -/// Sin título (ver [`with_title()`](Self::with_title)), se muestra únicamente la lista de -/// elementos, sin ningún botón para interactuar, sólo un menú contextual estático. +/// Sin título (ver [`with_title()`]), se muestra únicamente la lista de elementos, sin ningún botón +/// para interactuar, sólo un menú contextual estático. /// -/// Si no contiene elementos, el componente **no se renderiza**. +/// Un encabezado sólo se muestra si su grupo tiene algún elemento visible, y un separador sólo +/// entre elementos visibles (ver [`dropdown::Items`]). Si no quedan elementos para mostrar, el +/// componente **no se renderiza**. /// /// # Ejemplo /// @@ -23,6 +25,11 @@ use crate::prelude::*; /// .with_item(dropdown::Item::header(Lc::n("User session"))) /// .with_item(dropdown::Item::button(Lc::n("Sign out"))); /// ``` +/// +/// [`with_title()`]: Self::with_title +/// [`with_button_split()`]: Self::with_button_split +/// [`dropdown::Item`]: super::Item +/// [`dropdown::Items`]: super::Items #[derive(AutoDefault, Clone, Debug, Getters)] pub struct Dropdown { /// Devuelve identificador, clases CSS, atributos HTML y valores extra del componente. @@ -40,7 +47,7 @@ pub struct Dropdown { /// Devuelve si el menú se alinea al final del botón (por defecto, al inicio). menu_end: bool, /// Devuelve la lista de elementos del menú. - items: Children, + items: dropdown::Items, } #[async_trait] @@ -210,7 +217,7 @@ impl Dropdown { /// ])); /// ``` pub fn with_item(mut self, op: impl Into>) -> Self { - self.items.alter_child(op.into()); + self.items.alter_item(op.into()); self } } diff --git a/src/base/component/dropdown/item.rs b/src/base/component/dropdown/item.rs index 52e1eee5..dd81a84f 100644 --- a/src/base/component/dropdown/item.rs +++ b/src/base/component/dropdown/item.rs @@ -42,7 +42,8 @@ pub enum ItemKind { /// asociada, manteniendo una interfaz común para renderizar todos los elementos del menú. /// /// Un enlace no se renderiza si el usuario actual no puede acceder a su ruta (ver [`Endpoint`]). -/// Los encabezados y separadores no dependen de ningún enlace y se muestran aunque queden solos. +/// Tampoco se muestra un encabezado si su grupo no tiene ningún elemento visible, ni un separador +/// que no quede entre elementos visibles (ver [`dropdown::Items`](super::Items)). #[derive(AutoDefault, Clone, Debug, Getters)] pub struct Item { /// Devuelve identificador, clases CSS, atributos HTML y valores extra del componente. diff --git a/src/base/component/dropdown/items.rs b/src/base/component/dropdown/items.rs new file mode 100644 index 00000000..8a4d4ec2 --- /dev/null +++ b/src/base/component/dropdown/items.rs @@ -0,0 +1,68 @@ +use crate::prelude::*; + +use super::{Item, ItemKind}; + +/// Lista de elementos [`Item`] de un menú desplegable [`Dropdown`](super::Dropdown). +/// +/// Se renderiza sin los encabezados ni los separadores que no separan nada (ver +/// [`render()`](Self::render)), así que cualquier tema que pinte el menú con `items().render(cx)` +/// aprovecha la limpieza sin hacer nada más. +#[derive(AutoDefault, Clone, Debug)] +pub struct Items(Children); + +impl Items { + /// Devuelve el número de elementos de la lista, también los que no se mostrarán. + pub fn len(&self) -> usize { + self.0.len() + } + + /// Indica si la lista está vacía. + pub fn is_empty(&self) -> bool { + self.0.is_empty() + } + + /// Renderiza los elementos sin los encabezados ni los separadores que no separan nada. + /// + /// Un encabezado sólo se muestra si le sigue algún elemento visible antes del siguiente + /// encabezado o separador, y un separador sólo entre dos elementos visibles, una sola vez. + /// Así, si se ocultan todos los enlaces de un grupo (por ejemplo, porque el usuario no tiene + /// acceso a sus rutas, ver [`Endpoint`]), su encabezado desaparece con ellos. Un elemento es + /// visible si su renderizado no queda vacío. Cada uno se renderiza como mucho una vez: los + /// encabezados y separadores, sólo si se muestran. + pub async fn render(&self, cx: &mut Context) -> Markup { + let mut shown: Vec = Vec::with_capacity(self.0.len()); + // Encabezado y separador a la espera de un elemento visible que los justifique. + let mut header = None; + let mut divider = None; + for item in self.0.iter() { + match item.downcast_ref::().map(Item::item_kind) { + Some(ItemKind::Header(_)) => header = Some(item), + Some(ItemKind::Divider) => { + header = None; + if !shown.is_empty() { + divider = Some(item); + } + } + _ => { + let markup = item.render(cx).await; + if markup.is_empty() { + continue; + } + if let Some(divider) = divider.take() { + shown.push(divider.render(cx).await); + } + if let Some(header) = header.take() { + shown.push(header.render(cx).await); + } + shown.push(markup); + } + } + } + html! { @for markup in &shown { (markup) } } + } + + // Añade un elemento o modifica la lista con una operación `TypedOp`. + pub(crate) fn alter_item(&mut self, op: TypedOp) { + self.0.alter_child(op); + } +} diff --git a/src/core/component/children.rs b/src/core/component/children.rs index 53be3f26..8bb13c56 100644 --- a/src/core/component/children.rs +++ b/src/core/component/children.rs @@ -1,3 +1,4 @@ +use crate::core::AnyCast; use crate::core::component::{Component, Context}; use crate::html::{Markup, html}; use crate::{AutoDefault, UniqueId, builder_impl}; @@ -71,6 +72,24 @@ impl Child { } } + /// Devuelve una referencia al componente si es del tipo `C`, o `None` si es de otro tipo o el + /// `Child` está vacío. + /// + /// Permite consultar el estado de un componente concreto de una lista sin renderizarlo (p. ej. + /// el tipo de cada [`dropdown::Item`](crate::base::component::dropdown::Item)). + /// + /// # Ejemplo + /// + /// ```rust + /// # use pagetop::prelude::*; + /// let child = Child::with(Html::with(|_| html! { "Prueba" })); + /// assert!(child.downcast_ref::().is_some()); + /// assert!(child.downcast_ref::