✨ (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);
}
}