✨ (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:
parent
e2e2ccb31e
commit
c940403869
9 changed files with 292 additions and 10 deletions
|
|
@ -5,3 +5,6 @@ pub use component::Dropdown;
|
|||
|
||||
mod item;
|
||||
pub use item::{Item, ItemKind};
|
||||
|
||||
mod items;
|
||||
pub use items::Items;
|
||||
|
|
|
|||
|
|
@ -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
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
68
src/base/component/dropdown/items.rs
Normal file
68
src/base/component/dropdown/items.rs
Normal 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);
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue