✨ (bootsier): Añade componentes esenciales
- Añade Dialog como modal de Bootstrap, con el JS de soporte para `htmx:confirm` y el saneado de su posición fija. - Adapta Nav, Navbar y Dropdown al reuso de los tipos movidos al core, y traduce BootsierColors/Intent en Button y Badge, con soporte para Light/Dark vía with_color(). - Reexporta en el tema los componentes de PageTop que faltaban: Block, Breadcrumb, Messages, Pager, Table y form::Number.
This commit is contained in:
parent
eb63a7ef37
commit
c0a5a8c3ab
47 changed files with 2135 additions and 1818 deletions
|
|
@ -1,17 +1,245 @@
|
|||
//! Definiciones para crear menús desplegables ([`Dropdown`]).
|
||||
//!
|
||||
//! Cada [`dropdown::Item`](crate::theme::bs::dropdown::Item) representa un elemento individual del
|
||||
//! Cada [`dropdown::Item`] representa un elemento individual del
|
||||
//! desplegable [`Dropdown`], con distintos comportamientos según su finalidad, como enlaces de
|
||||
//! navegación, botones de acción, encabezados o divisores visuales.
|
||||
//!
|
||||
//! Los ítems pueden estar activos, deshabilitados o abrirse en nueva ventana según su contexto y
|
||||
//! configuración, y permiten incluir etiquetas localizables usando [`Lc`](pagetop::locale::Lc).
|
||||
//! configuración, y permiten incluir etiquetas localizables usando [`Lc`].
|
||||
|
||||
use pagetop::prelude::*;
|
||||
|
||||
use crate::LOCALES_BOOTSIER;
|
||||
|
||||
mod props;
|
||||
pub use props::{AutoClose, Direction, MenuAlign, MenuPosition};
|
||||
|
||||
mod component;
|
||||
pub use component::Dropdown;
|
||||
pub use pagetop::base::component::Dropdown;
|
||||
pub use pagetop::base::component::dropdown::{Item, ItemKind};
|
||||
|
||||
mod item;
|
||||
pub use item::{Item, ItemKind};
|
||||
const EXTRA_BUTTON_GROUPED: &str = "bootsier.dropdown.button_grouped";
|
||||
const EXTRA_AUTO_CLOSE: &str = "bootsier.dropdown.auto_close";
|
||||
const EXTRA_DIRECTION: &str = "bootsier.dropdown.direction";
|
||||
const EXTRA_MENU_ALIGN: &str = "bootsier.dropdown.menu_align";
|
||||
const EXTRA_MENU_POSITION: &str = "bootsier.dropdown.menu_position";
|
||||
|
||||
/// Extensión de Bootsier para [`Dropdown`].
|
||||
///
|
||||
/// Admite variaciones para el tamaño y el color del botón, y también para la dirección de
|
||||
/// apertura, la alineación o la política de cierre del menú.
|
||||
///
|
||||
/// ```rust,no_run
|
||||
/// use pagetop::prelude::*;
|
||||
/// use pagetop_bootsier::theme::*;
|
||||
///
|
||||
/// let dd = bs::Dropdown::new()
|
||||
/// .with_title(Lc::n("Menu"))
|
||||
/// .with_button_size(button::Size::Small)
|
||||
/// .with_button_style(button::Style::Solid(Intent::Neutral))
|
||||
/// .with_auto_close(bs::dropdown::AutoClose::ClickableInside)
|
||||
/// .with_direction(bs::dropdown::Direction::Dropend)
|
||||
/// .with_item(bs::dropdown::Item::link(Lc::n("Home"), "/"))
|
||||
/// .with_item(bs::dropdown::Item::link_blank(Lc::n("Doc"), "https://docs.rs"))
|
||||
/// .with_item(bs::dropdown::Item::divider())
|
||||
/// .with_item(bs::dropdown::Item::header(Lc::n("User session")))
|
||||
/// .with_item(bs::dropdown::Item::button(Lc::n("Sign out")));
|
||||
/// ```
|
||||
pub trait DropdownBootsier {
|
||||
/// Indica si el botón del menú está integrado en un grupo de botones.
|
||||
#[builder_fn]
|
||||
fn with_button_grouped(self, grouped: bool) -> Self;
|
||||
|
||||
/// Establece la política de cierre automático del menú desplegable.
|
||||
#[builder_fn]
|
||||
fn with_auto_close(self, auto_close: AutoClose) -> Self;
|
||||
|
||||
/// Establece la dirección de despliegue del menú.
|
||||
#[builder_fn]
|
||||
fn with_direction(self, direction: Direction) -> Self;
|
||||
|
||||
/// Configura la alineación horizontal (con posible comportamiento *responsive* adicional).
|
||||
#[builder_fn]
|
||||
fn with_menu_align(self, align: MenuAlign) -> Self;
|
||||
|
||||
/// Configura la posición del menú.
|
||||
#[builder_fn]
|
||||
fn with_menu_position(self, position: MenuPosition) -> Self;
|
||||
}
|
||||
|
||||
impl DropdownBootsier for Dropdown {
|
||||
#[builder_fn]
|
||||
fn with_button_grouped(mut self, grouped: bool) -> Self {
|
||||
self.alter_prop(PropsOp::set_extra(EXTRA_BUTTON_GROUPED, grouped));
|
||||
self
|
||||
}
|
||||
|
||||
#[builder_fn]
|
||||
fn with_auto_close(mut self, auto_close: AutoClose) -> Self {
|
||||
self.alter_prop(PropsOp::set_extra(EXTRA_AUTO_CLOSE, auto_close));
|
||||
self
|
||||
}
|
||||
|
||||
#[builder_fn]
|
||||
fn with_direction(mut self, direction: Direction) -> Self {
|
||||
self.alter_prop(PropsOp::set_extra(EXTRA_DIRECTION, direction));
|
||||
self
|
||||
}
|
||||
|
||||
#[builder_fn]
|
||||
fn with_menu_align(mut self, align: MenuAlign) -> Self {
|
||||
self.alter_prop(PropsOp::set_extra(EXTRA_MENU_ALIGN, align));
|
||||
self
|
||||
}
|
||||
|
||||
#[builder_fn]
|
||||
fn with_menu_position(mut self, position: MenuPosition) -> Self {
|
||||
self.alter_prop(PropsOp::set_extra(EXTRA_MENU_POSITION, position));
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
// **< Dropdown SETUP >*****************************************************************************
|
||||
|
||||
pub(crate) fn setup(dropdown: &mut Dropdown) {
|
||||
let direction = dropdown
|
||||
.props()
|
||||
.extra_or(EXTRA_DIRECTION, Direction::default());
|
||||
let grouped = dropdown.props().extra_or(EXTRA_BUTTON_GROUPED, false);
|
||||
dropdown.alter_prop(PropsOp::replace_classes(
|
||||
"dropdown",
|
||||
direction.to_class(grouped),
|
||||
));
|
||||
}
|
||||
|
||||
// **< Dropdown RENDER >****************************************************************************
|
||||
|
||||
pub(crate) async fn render(
|
||||
dropdown: &Dropdown,
|
||||
cx: &mut Context,
|
||||
) -> Result<Markup, ComponentError> {
|
||||
// Si no hay elementos en el menú, no se prepara.
|
||||
let items = dropdown.items().render(cx).await;
|
||||
if items.is_empty() {
|
||||
return Ok(html! {});
|
||||
}
|
||||
|
||||
// Título opcional para el menú desplegable.
|
||||
let title = dropdown.title().using(cx);
|
||||
|
||||
if title.is_empty() {
|
||||
// Sin título: menú contextual estático, sin botón ni comportamiento de apertura/cierre.
|
||||
return Ok(html! {
|
||||
div (dropdown.props()) {
|
||||
ul class="dropdown-menu" { (items) }
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
let button_size = dropdown.button_size();
|
||||
let style = dropdown.button_style();
|
||||
let auto_close = dropdown
|
||||
.props()
|
||||
.extra_or(EXTRA_AUTO_CLOSE, AutoClose::default());
|
||||
let direction = dropdown
|
||||
.props()
|
||||
.extra_or(EXTRA_DIRECTION, Direction::default());
|
||||
let menu_align = dropdown
|
||||
.props()
|
||||
.extra_or(EXTRA_MENU_ALIGN, MenuAlign::default());
|
||||
let menu_position = dropdown
|
||||
.props()
|
||||
.extra_or(EXTRA_MENU_POSITION, MenuPosition::default());
|
||||
|
||||
let btn_base = {
|
||||
let mut classes = String::from("btn");
|
||||
match button_size {
|
||||
button::Size::None => {}
|
||||
button::Size::Small => classes.push_str(" btn-sm"),
|
||||
button::Size::Large => classes.push_str(" btn-lg"),
|
||||
}
|
||||
match style {
|
||||
button::Style::None => {}
|
||||
button::Style::Solid(intent) => {
|
||||
classes.push_str(" btn-");
|
||||
classes.push_str(intent.color(cx));
|
||||
}
|
||||
button::Style::Outline(intent) => {
|
||||
classes.push_str(" btn-outline-");
|
||||
classes.push_str(intent.color(cx));
|
||||
}
|
||||
button::Style::Link => classes.push_str(" btn-link"),
|
||||
}
|
||||
classes
|
||||
};
|
||||
let offset = menu_position.data_offset();
|
||||
let reference = menu_position.data_reference();
|
||||
let auto_close = auto_close.opt_str();
|
||||
let menu_classes = {
|
||||
let mut classes = "dropdown-menu".to_string();
|
||||
menu_align.push_to(&mut classes);
|
||||
classes
|
||||
};
|
||||
|
||||
Ok(html! {
|
||||
div (dropdown.props()) {
|
||||
// Renderizado en modo split (dos botones) o simple (un botón).
|
||||
@if *dropdown.button_split() {
|
||||
// Botón principal (acción/etiqueta).
|
||||
@let btn = html! {
|
||||
button
|
||||
type="button"
|
||||
class=(&btn_base)
|
||||
{
|
||||
(&title)
|
||||
}
|
||||
};
|
||||
// Botón *toggle* que abre/cierra el menú asociado.
|
||||
@let btn_toggle_classes =
|
||||
util::join!(&btn_base, " dropdown-toggle dropdown-toggle-split");
|
||||
@let btn_toggle = html! {
|
||||
button
|
||||
type="button"
|
||||
class=(&btn_toggle_classes)
|
||||
data-bs-toggle="dropdown"
|
||||
data-bs-offset=[offset]
|
||||
data-bs-reference=[reference]
|
||||
data-bs-auto-close=[auto_close]
|
||||
aria-expanded="false"
|
||||
{
|
||||
span class="visually-hidden" {
|
||||
(Lc::t("dropdown_toggle", &LOCALES_BOOTSIER).using(cx))
|
||||
}
|
||||
}
|
||||
};
|
||||
// Orden según dirección (en `dropstart` el *toggle* se sitúa antes).
|
||||
@match direction {
|
||||
Direction::Dropstart => {
|
||||
(btn_toggle)
|
||||
ul class=(&menu_classes) { (items) }
|
||||
(btn)
|
||||
}
|
||||
_ => {
|
||||
(btn)
|
||||
(btn_toggle)
|
||||
ul class=(&menu_classes) { (items) }
|
||||
}
|
||||
}
|
||||
} @else {
|
||||
// Botón único con funcionalidad de *toggle*.
|
||||
@let btn_toggle_classes = util::join!(&btn_base, " dropdown-toggle");
|
||||
button
|
||||
type="button"
|
||||
class=(&btn_toggle_classes)
|
||||
data-bs-toggle="dropdown"
|
||||
data-bs-offset=[offset]
|
||||
data-bs-reference=[reference]
|
||||
data-bs-auto-close=[auto_close]
|
||||
aria-expanded="false"
|
||||
{
|
||||
(&title)
|
||||
}
|
||||
ul class=(&menu_classes) { (items) }
|
||||
}
|
||||
}
|
||||
})
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue