✨ (base): Oculta separadores en menús sin opciones

`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()`.
This commit is contained in:
Manuel Cillero 2026-11-08 10:11:42 +01:00
parent e2e2ccb31e
commit c940403869
9 changed files with 292 additions and 10 deletions

View file

@ -5,3 +5,6 @@ pub use component::Dropdown;
mod item;
pub use item::{Item, ItemKind};
mod items;
pub use items::Items;

View file

@ -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<TypedOp<dropdown::Item>>) -> Self {
self.items.alter_child(op.into());
self.items.alter_item(op.into());
self
}
}

View file

@ -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.

View file

@ -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<Markup> = 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::<Item>().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<Item>) {
self.0.alter_child(op);
}
}

View file

@ -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::<Html>().is_some());
/// assert!(child.downcast_ref::<Button>().is_none());
/// ```
pub fn downcast_ref<C: Component>(&self) -> Option<&C> {
self.0.as_deref().and_then(|c| c.downcast_ref::<C>())
}
// **< Child HELPERS >**************************************************************************
// Devuelve el [`UniqueId`] del tipo del componente, si el Child no está vacío.
@ -440,6 +459,11 @@ impl Children {
self.0.iter().filter(move |c| c.type_id() == Some(type_id))
}
/// Devuelve un iterador sobre todos los componentes hijo, en orden.
pub fn iter(&self) -> impl Iterator<Item = &Child> {
self.0.iter()
}
// **< Children RENDER >************************************************************************
/// Renderiza todos los componentes hijo, en orden.