La plantilla Admin ya no pinta la navegación del panel: la coloca la aplicación con Nav::admin(), en una barra aparte o en la suya. Se elimina AdminMenu y AdminFrame pasa a layout::AdminFrame.
119 lines
3.9 KiB
Rust
119 lines
3.9 KiB
Rust
//! Definiciones y plantillas del tema Bootsier.
|
|
//!
|
|
//! El módulo [`bs`] expone todos los tipos y componentes disponibles. Para usarlos sin ambigüedad
|
|
//! junto a `use pagetop::prelude::*`, y cargar también los traits del tema, importa este módulo
|
|
//! con glob:
|
|
//!
|
|
//! ```rust,no_run
|
|
//! use pagetop::prelude::*;
|
|
//! use pagetop_bootsier::theme::*;
|
|
//! ```
|
|
//!
|
|
//! # Plantillas
|
|
//!
|
|
//! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]) con la misma cabecera,
|
|
//! contenido y pie: `Standard`, la plantilla por defecto de cualquier página; y `Admin`, que se
|
|
//! activa creando la página con [`Page::admin()`] en lugar de [`Page::new()`] y añade el panel de
|
|
//! administración (ver más abajo).
|
|
//!
|
|
//! ```rust,no_run
|
|
//! use pagetop::prelude::*;
|
|
//!
|
|
//! async fn about(request: HttpRequest) -> Result<Markup, ErrorPage> {
|
|
//! Page::new(request)
|
|
//! .with_child(Html::with(|_| html! {
|
|
//! h1 { "Sobre nosotros" }
|
|
//! p { "Texto de presentación." }
|
|
//! }))
|
|
//! .render().await
|
|
//! }
|
|
//! ```
|
|
//!
|
|
//! [`CoreTemplates`]: pagetop::prelude::CoreTemplates
|
|
//! [`Page::admin()`]: pagetop::response::Page::admin
|
|
//! [`Page::new()`]: pagetop::response::Page::new
|
|
//!
|
|
//! # Panel de administración
|
|
//!
|
|
//! En la plantilla `Admin`, Bootsier sigue la composición del núcleo: en lugar del contenido pinta
|
|
//! el marco de la página ([`AdminFrame`]: migas, título, botones y pestañas). La navegación del
|
|
//! panel ([`Nav::admin()`]) la coloca la aplicación, en una barra aparte o en su barra principal,
|
|
//! donde se pliega con su botón en pantallas pequeñas. Todo se construye con componentes del núcleo
|
|
//! ([`Navbar`]/[`Nav`]/[`Dropdown`], [`Breadcrumb`]), que Bootsier ya pinta con su aspecto.
|
|
//!
|
|
//! [`AdminFrame`]: pagetop::prelude::layout::AdminFrame
|
|
//!
|
|
//! # Selector de modo de color
|
|
//!
|
|
//! [`bs::theme_toggle()`] crea un ítem de menú con el selector de modo de color (claro / oscuro /
|
|
//! automático), pensado para añadirse a cualquier [`Nav`] de la aplicación, no sólo a las
|
|
//! páginas de administración:
|
|
//!
|
|
//! ```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::theme_toggle()),
|
|
//! ));
|
|
//! ```
|
|
|
|
use pagetop::prelude::*;
|
|
|
|
pub mod bs;
|
|
|
|
pub mod class;
|
|
|
|
mod token;
|
|
pub use token::*;
|
|
|
|
#[doc(hidden)]
|
|
pub use bs::badge::BadgeBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::button::ButtonBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::dropdown::DropdownBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::form::input::InputBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::form::select::SelectBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::form::textarea::TextareaBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::nav::NavBsExt;
|
|
#[doc(hidden)]
|
|
pub use bs::navbar::NavbarBsExt;
|
|
|
|
// Añade la clase de un punto de corte con un prefijo y un sufijo (opcional) a la cadena de clases,
|
|
// separada con un espacio de las que ya hubiera: `prefix-name-suffix`, sin `-suffix` si no hay
|
|
// sufijo, y sin `-name` si el punto de corte aplica siempre.
|
|
//
|
|
// `name` es el nombre del punto de corte según `Theme::breakpoint_entry()` en el tema activo de
|
|
// `cx`. Si el tema no le asocia un ancho mínimo (`Breakpoint::resolved()` devuelve `None`), el
|
|
// punto de corte aplica siempre y se omite `name`, igual que Bootstrap con `container` frente a
|
|
// `container-lg`, o `container-fluid` frente a `container-lg-fluid`.
|
|
pub(crate) fn push_breakpoint_class(
|
|
cx: &Context,
|
|
bp: Breakpoint,
|
|
classes: &mut String,
|
|
prefix: &str,
|
|
suffix: &str,
|
|
) {
|
|
if prefix.is_empty() {
|
|
return;
|
|
}
|
|
if !classes.is_empty() {
|
|
classes.push(' ');
|
|
}
|
|
classes.push_str(prefix);
|
|
if let Some(entry) = bp.resolved(cx) {
|
|
classes.push('-');
|
|
classes.push_str(entry.name);
|
|
}
|
|
if !suffix.is_empty() {
|
|
classes.push('-');
|
|
classes.push_str(suffix);
|
|
}
|
|
}
|