use pagetop::prelude::*; use crate::LOCALES_BOOTSIER; use crate::theme::*; const TOGGLE_COLLAPSE: &str = "collapse"; const TOGGLE_OFFCANVAS: &str = "offcanvas"; const EXTRA_LAYOUT: &str = "bootsier.navbar.layout"; /// Extensión de Bootsier para [`Navbar`]. /// /// Permite mostrar enlaces, menús y una marca de identidad en distintas disposiciones (simples, con /// botón de despliegue o dentro de un [`navbar::Panel`]), controladas por [`navbar::Layout`]. /// También puede fijarse en la parte superior o inferior del documento con [`navbar::Position`]. El /// punto de corte a partir del cual deja de colapsar se define con [`Navbar::with_expand()`]. /// /// [`Navbar`]: crate::theme::bs::Navbar /// [`navbar::Layout`]: crate::theme::bs::navbar::Layout /// [`navbar::Panel`]: crate::theme::bs::navbar::Panel /// [`navbar::Position`]: crate::theme::bs::navbar::Position /// /// # Ejemplos /// /// Barra **simple**, sólo con un menú horizontal: /// /// ```rust,no_run /// use pagetop::prelude::*; /// use pagetop_bootsier::theme::*; /// /// let navbar = bs::Navbar::simple() /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_item(bs::nav::Item::link(Lc::n("Home"), "/")) /// .with_item(bs::nav::Item::link(Lc::n("About"), "/about")) /// .with_item(bs::nav::Item::link(Lc::n("Contact"), "/contact")) /// )); /// ``` /// /// Barra **colapsable**, con botón de despliegue y contenido en el desplegable cuando colapsa: /// /// ```rust,no_run /// # use pagetop::prelude::*; /// # use pagetop_bootsier::theme::*; /// let navbar = bs::Navbar::simple_toggle() /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_item(bs::nav::Item::link(Lc::n("Home"), "/")) /// .with_item(bs::nav::Item::link_blank(Lc::n("Doc"), "https://docs.rs")) /// .with_item(bs::nav::Item::link(Lc::n("Support"), "/support")) /// )); /// ``` /// /// Barra con **marca de identidad a la izquierda** y menú a la derecha, típica de una cabecera: /// /// ```rust,no_run /// # use pagetop::prelude::*; /// # use pagetop_bootsier::theme::*; /// let brand = Brand::new() /// .with_title(Lc::n("PageTop")) /// .with_route(Route::from("/")); /// /// let navbar = bs::Navbar::brand_left(brand) /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_item(bs::nav::Item::link(Lc::n("Home"), "/")) /// .with_item(bs::nav::Item::dropdown( /// bs::Dropdown::new() /// .with_title(Lc::n("Tools")) /// .with_item(bs::dropdown::Item::link( /// Lc::n("Generator"), "/tools/gen") /// ) /// .with_item(bs::dropdown::Item::link( /// Lc::n("Reports"), "/tools/reports") /// ) /// )) /// .with_item(bs::nav::Item::link_disabled(Lc::n("Disabled"), "#")) /// )); /// ``` /// /// Barra con **botón de despliegue a la izquierda** y **marca de identidad a la derecha**: /// /// ```rust,no_run /// # use pagetop::prelude::*; /// # use pagetop_bootsier::theme::*; /// let brand = Brand::new() /// .with_title(Lc::n("Intranet")) /// .with_route(Route::from("/")); /// /// let navbar = bs::Navbar::brand_right(brand) /// .with_expand(Breakpoint::Lg) /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_kind(bs::nav::Kind::Pills) /// .with_item(bs::nav::Item::link(Lc::n("Dashboard"), "/dashboard")) /// .with_item(bs::nav::Item::link(Lc::n("Users"), "/users")) /// )); /// ``` /// /// Barra con el **contenido en un *offcanvas***, ideal para dispositivos móviles o menús largos: /// /// ```rust,no_run /// # use pagetop::prelude::*; /// # use pagetop_bootsier::theme::*; /// let panel = bs::navbar::Panel::new() /// .with_title(Lc::n("Main menu")) /// .with_placement(bs::offcanvas::Placement::Start) /// .with_backdrop(bs::offcanvas::Backdrop::Enabled); /// /// let navbar = bs::Navbar::offcanvas(panel) /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_item(bs::nav::Item::link(Lc::n("Home"), "/")) /// .with_item(bs::nav::Item::link(Lc::n("Profile"), "/profile")) /// .with_item(bs::nav::Item::dropdown( /// bs::Dropdown::new() /// .with_title(Lc::n("More")) /// .with_item(bs::dropdown::Item::link(Lc::n("Settings"), "/settings")) /// .with_item(bs::dropdown::Item::link(Lc::n("Help"), "/help")) /// )) /// )); /// ``` /// /// Barra **fija arriba**: /// /// ```rust,no_run /// # use pagetop::prelude::*; /// # use pagetop_bootsier::theme::*; /// let brand = Brand::new() /// .with_title(Lc::n("Main App")) /// .with_route(Route::from("/")); /// /// let navbar = bs::Navbar::brand_left(brand) /// .with_position(bs::navbar::Position::FixedTop) /// .with_item(bs::navbar::Item::nav( /// bs::Nav::new() /// .with_item(bs::nav::Item::link(Lc::n("Dashboard"), "/")) /// .with_item(bs::nav::Item::link(Lc::n("Donors"), "/donors")) /// .with_item(bs::nav::Item::link(Lc::n("Stock"), "/stock")) /// )); /// ``` #[builder_impl] pub trait NavbarBsExt { /// Crea una barra de navegación cuyo contenido se muestra en un panel lateral. fn offcanvas(panel: bs::navbar::Panel) -> Self; /// Crea una barra de navegación con **marca de identidad a la izquierda** y contenido en un /// panel lateral. fn offcanvas_brand_left(brand: Brand, panel: bs::navbar::Panel) -> Self; /// Crea una barra de navegación con **marca de identidad a la derecha** y contenido en un panel /// lateral. fn offcanvas_brand_right(brand: Brand, panel: bs::navbar::Panel) -> Self; } #[builder_impl] impl NavbarBsExt for Navbar { fn offcanvas(panel: bs::navbar::Panel) -> Self { let mut navbar = Self::new(); navbar.alter_prop(PropsOp::set_extra( EXTRA_LAYOUT, bs::navbar::Layout::Offcanvas(panel), )); navbar } fn offcanvas_brand_left(brand: Brand, panel: bs::navbar::Panel) -> Self { let mut navbar = Self::new(); navbar.alter_prop(PropsOp::set_extra( EXTRA_LAYOUT, bs::navbar::Layout::OffcanvasBrandLeft(Embed::with(brand), panel), )); navbar } fn offcanvas_brand_right(brand: Brand, panel: bs::navbar::Panel) -> Self { let mut navbar = Self::new(); navbar.alter_prop(PropsOp::set_extra( EXTRA_LAYOUT, bs::navbar::Layout::OffcanvasBrandRight(Embed::with(brand), panel), )); navbar } } // **< Navbar SETUP >******************************************************************************* pub(crate) fn setup(navbar: &mut Navbar) { // Sin botón de despliegue no hay nada que colapsar, así que el punto de corte no debe afectar a // la barra: Bootstrap apilaría igualmente el menú por debajo de él. `navbar-expand` a secas es // su «expandida siempre». Las disposiciones de Bootsier (`EXTRA_LAYOUT`, con panel lateral) // siempre llevan botón; de las de base sólo `Simple` y `SimpleBrandLeft` no lo llevan. let has_toggle = navbar .props() .extra::(EXTRA_LAYOUT) .is_ok() || !matches!( navbar.layout(), navbar::Layout::Simple | navbar::Layout::SimpleBrandLeft(_) ); if !has_toggle { let expand = navbar.props().get_classes().and_then(|classes| { classes .split_whitespace() .find(|class| class.starts_with("navbar-expand-")) .map(String::from) }); if let Some(class) = expand { navbar.alter_prop(PropsOp::replace_classes(class, "navbar-expand")); } } } // **< Navbar RENDER >****************************************************************************** pub(crate) async fn render(navbar: &Navbar, cx: &mut Context) -> Result { // Botón de despliegue (colapso u offcanvas) para la barra. fn button(cx: &mut Context, data_bs_toggle: &str, id_content: &str) -> Markup { let id_content_target = util::join!("#", id_content); let aria_expanded = if data_bs_toggle == TOGGLE_COLLAPSE { Some("false") } else { None }; html! { button type="button" class="navbar-toggler" data-bs-toggle=(data_bs_toggle) data-bs-target=(id_content_target) aria-controls=(id_content) aria-expanded=[aria_expanded] aria-label=[Lc::t("toggle", &LOCALES_BOOTSIER).lookup(cx)] { span class="navbar-toggler-icon" {} } } } // Si no hay contenidos, no tiene sentido mostrar una barra vacía. let items = navbar.items().render(cx).await; if items.is_empty() { return Ok(html! {}); } // `Navbar::setup()` (base) garantiza que habrá un `id` antes de renderizar. El área de // contenido (colapsable o panel lateral) deriva su identificador del de la barra. let id = navbar.id().unwrap(); let id_content = util::join!(&id, "-content"); // El extra `EXTRA_LAYOUT` (fijado por los constructores propios de Bootsier `offcanvas()`, // `offcanvas_brand_left()`, `offcanvas_brand_right()`) tiene prioridad; si no se ha fijado, se // traduce el `navbar::Layout` de base que hayan podido fijar los constructores heredados de // `Navbar` (`simple()`, `brand_left()`...), que Bootsier no puede sobrescribir por nombre -las // funciones inherentes de base siempre ganan sobre las de un trait con el mismo nombre-. let layout = navbar .props() .extra::(EXTRA_LAYOUT) .cloned() .unwrap_or_else(|_| translate_layout(navbar.layout())); Ok(html! { nav (navbar.props().unpack(cx)) { div class="container-fluid" { @match layout { // Barra más sencilla: sólo contenido. bs::navbar::Layout::Simple => { (items) }, // Barra sencilla que se puede contraer/expandir. bs::navbar::Layout::SimpleToggle => { (button(cx, TOGGLE_COLLAPSE, &id_content)) div id=(&id_content) class="collapse navbar-collapse" { (items) } }, // Barra con marca a la izquierda, siempre visible. El contenedor deja los // contenidos junto a la marca: sin él, el `space-between` de `container-fluid` // los llevaría al extremo opuesto. Sin `collapse`, `setup()` garantiza // `navbar-expand` y Bootstrap lo muestra siempre. bs::navbar::Layout::SimpleBrandLeft(brand) => { (brand.render(cx).await) div class="navbar-collapse" { (items) } }, // Barra con marca a la izquierda y botón a la derecha. bs::navbar::Layout::BrandLeft(brand) => { (brand.render(cx).await) (button(cx, TOGGLE_COLLAPSE, &id_content)) div id=(&id_content) class="collapse navbar-collapse" { (items) } }, // Barra con botón a la izquierda y marca a la derecha. bs::navbar::Layout::BrandRight(brand) => { (button(cx, TOGGLE_COLLAPSE, &id_content)) (brand.render(cx).await) div id=(&id_content) class="collapse navbar-collapse" { (items) } }, // Barra cuyo contenido se muestra en un panel lateral, sin marca. bs::navbar::Layout::Offcanvas(panel) => { (button(cx, TOGGLE_OFFCANVAS, &id_content)) (panel.render_panel(cx, &id_content, &items)) }, // Barra con marca a la izquierda y contenido en un panel lateral. bs::navbar::Layout::OffcanvasBrandLeft(brand, panel) => { (brand.render(cx).await) (button(cx, TOGGLE_OFFCANVAS, &id_content)) (panel.render_panel(cx, &id_content, &items)) }, // Barra con contenido en un panel lateral y marca a la derecha. bs::navbar::Layout::OffcanvasBrandRight(brand, panel) => { (button(cx, TOGGLE_OFFCANVAS, &id_content)) (brand.render(cx).await) (panel.render_panel(cx, &id_content, &items)) }, } } } }) } // Traduce el `navbar::Layout` semántico de base (sin `Offcanvas`, sin `Position`/`expand`) a la // variante equivalente de `bs::navbar::Layout`, para las barras construidas con los constructores // heredados de `Navbar` (`simple()`, `simple_toggle()`, `simple_brand_left()`, `brand_left()`, // `brand_right()`) en vez de con `with_layout()`. fn translate_layout(layout: &navbar::Layout) -> bs::navbar::Layout { match layout { navbar::Layout::Simple => bs::navbar::Layout::Simple, navbar::Layout::SimpleToggle => bs::navbar::Layout::SimpleToggle, navbar::Layout::SimpleBrandLeft(brand) => { bs::navbar::Layout::SimpleBrandLeft(brand.clone()) } navbar::Layout::BrandLeft(brand) => bs::navbar::Layout::BrandLeft(brand.clone()), navbar::Layout::BrandRight(brand) => bs::navbar::Layout::BrandRight(brand.clone()), } }