319 lines
12 KiB
Rust
319 lines
12 KiB
Rust
use crate::prelude::*;
|
|
|
|
/// Tipo de apertura que se mostrará en la introducción del componente [`Intro`].
|
|
///
|
|
/// Permite elegir entre una apertura con textos predefinidos sobre PageTop (como hace la página de
|
|
/// bienvenida [`Welcome`](crate::base::extension::Welcome)) o una introducción completamente
|
|
/// personalizada.
|
|
#[derive(AutoDefault, Copy, Clone, Debug, Eq, PartialEq)]
|
|
pub enum IntroOpening {
|
|
/// Modo por defecto. Muestra una introducción estándar de PageTop e incluye automáticamente
|
|
/// *badges* con información de la última versión liberada, fecha del último lanzamiento y
|
|
/// licencia de uso.
|
|
#[default]
|
|
PageTop,
|
|
/// Modo totalmente personalizado. No añade *badges* ni textos predefinidos. Usa la imagen de
|
|
/// PageTop pero el contenido lo define el propio desarrollador.
|
|
Custom,
|
|
}
|
|
|
|
/// Componente para divulgar PageTop (como hace [`Welcome`](crate::base::extension::Welcome)), o
|
|
/// mostrar presentaciones.
|
|
///
|
|
/// Usa la imagen de PageTop para mostrar:
|
|
///
|
|
/// - Una **figura decorativa** (que incluye el *monster* de PageTop) antecediendo al contenido.
|
|
/// - Una vista destacada del **título** de la página con un **eslogan** de presentación.
|
|
/// - Un **botón opcional** de llamada a la acción con texto y enlace configurables.
|
|
/// - Un **área para la presentación de contenidos**, con *badges* informativos de PageTop (si se
|
|
/// opta por [`IntroOpening::PageTop`]) y bloques ([`Block`](crate::base::component::Block)) de
|
|
/// contenido libre para crear párrafos vistosos de texto. Aunque admite todo tipo de componentes.
|
|
///
|
|
/// ### Ejemplos
|
|
///
|
|
/// **Intro mínima por defecto**
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default();
|
|
/// ```
|
|
///
|
|
/// **Título, eslogan y botón personalizados**
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default()
|
|
/// .with_title(L10n::l("intro_custom_title"))
|
|
/// .with_slogan(L10n::l("intro_custom_slogan"))
|
|
/// .with_button(Some((
|
|
/// L10n::l("intro_learn_more"),
|
|
/// |_| "/learn-more"
|
|
/// )));
|
|
/// ```
|
|
///
|
|
/// **Sin botón y en modo *Custom* (sin *badges* predefinidos)**
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default()
|
|
/// .with_button(None::<(L10n, FnPathByContext)>)
|
|
/// .with_opening(IntroOpening::Custom);
|
|
/// ```
|
|
///
|
|
/// **Añadir contenidos hijo**
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default()
|
|
/// .add_child(
|
|
/// Block::new()
|
|
/// .with_title(L10n::l("intro_custom_block_title"))
|
|
/// .add_child(Html::with(move |cx| {
|
|
/// html! {
|
|
/// p { (L10n::l("intro_custom_paragraph_1").using(cx)) }
|
|
/// p { (L10n::l("intro_custom_paragraph_2").using(cx)) }
|
|
/// }
|
|
/// })),
|
|
/// );
|
|
/// ```
|
|
#[rustfmt::skip]
|
|
pub struct Intro {
|
|
title : L10n,
|
|
slogan : L10n,
|
|
button : Option<(L10n, FnPathByContext)>,
|
|
opening : IntroOpening,
|
|
children: Children,
|
|
}
|
|
|
|
impl Default for Intro {
|
|
#[rustfmt::skip]
|
|
fn default() -> Self {
|
|
Intro {
|
|
title : L10n::l("intro_default_title"),
|
|
slogan : L10n::l("intro_default_slogan").with_arg("app", &global::SETTINGS.app.name),
|
|
button : Some((L10n::l("intro_default_button"), |_| "https://pagetop.cillero.es")),
|
|
opening : IntroOpening::default(),
|
|
children: Children::default(),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Component for Intro {
|
|
fn new() -> Self {
|
|
Intro::default()
|
|
}
|
|
|
|
fn setup_before_prepare(&mut self, cx: &mut Context) {
|
|
cx.alter_assets(ContextOp::AddStyleSheet(
|
|
StyleSheet::from("/css/intro.css").with_version(PAGETOP_VERSION),
|
|
));
|
|
}
|
|
|
|
fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup {
|
|
if self.opening() == IntroOpening::PageTop {
|
|
cx.alter_assets(ContextOp::AddJavaScript(JavaScript::on_load_async("intro-js", |cx|
|
|
util::indoc!(r#"
|
|
try {
|
|
const resp = await fetch("https://crates.io/api/v1/crates/pagetop");
|
|
const data = await resp.json();
|
|
const date = new Date(data.versions[0].created_at);
|
|
const formatted = date.toLocaleDateString("LANGID", { year: "numeric", month: "2-digit", day: "2-digit" });
|
|
document.getElementById("intro-release").src = `https://img.shields.io/badge/Release%20date-${encodeURIComponent(formatted)}-blue?label=LABEL&style=for-the-badge`;
|
|
document.getElementById("intro-badges").style.display = "block";
|
|
} catch (e) {
|
|
console.error("Failed to fetch release date from crates.io:", e);
|
|
}
|
|
"#)
|
|
.replace("LANGID", cx.langid().to_string().as_str())
|
|
.replace("LABEL", L10n::l("intro_release_label").using(cx).as_str())
|
|
)));
|
|
}
|
|
|
|
PrepareMarkup::With(html! {
|
|
div class="intro" {
|
|
div class="intro-header" {
|
|
section class="intro-header__body" {
|
|
h1 class="intro-header__title" {
|
|
span { (self.title().using(cx)) }
|
|
(self.slogan().using(cx))
|
|
}
|
|
}
|
|
aside class="intro-header__image" aria-hidden="true" {
|
|
div class="intro-header__monster" {
|
|
(PageTopSvg::Color.render(cx))
|
|
}
|
|
}
|
|
}
|
|
div class="intro-content" {
|
|
section class="intro-content__body" {
|
|
div class="intro-text" {
|
|
@if let Some((txt, lnk)) = self.button() {
|
|
div class="intro-button" {
|
|
a
|
|
class="intro-button__link"
|
|
href=((lnk)(cx))
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
{
|
|
span {} span {} span {}
|
|
div class="intro-button__text" {
|
|
(txt.using(cx))
|
|
}
|
|
}
|
|
}
|
|
}
|
|
div class="intro-text__children" {
|
|
@if self.opening() == IntroOpening::PageTop {
|
|
p { (L10n::l("intro_text1").using(cx)) }
|
|
div id="intro-badges" {
|
|
img
|
|
src="https://img.shields.io/crates/v/pagetop.svg?label=PageTop&style=for-the-badge"
|
|
alt=[L10n::l("intro_pagetop_label").lookup(cx)] {} (" ")
|
|
img
|
|
id="intro-release"
|
|
alt=[L10n::l("intro_release_label").lookup(cx)] {} (" ")
|
|
img
|
|
src=(format!(
|
|
"https://img.shields.io/badge/license-MIT%2FApache-blue.svg?label={}&style=for-the-badge",
|
|
L10n::l("intro_license_label").lookup(cx).unwrap_or_default()
|
|
))
|
|
alt=[L10n::l("intro_license_label").lookup(cx)] {}
|
|
}
|
|
p { (L10n::l("intro_text2").using(cx)) }
|
|
}
|
|
(self.children().render(cx))
|
|
}
|
|
}
|
|
}
|
|
}
|
|
div class="intro-footer" {
|
|
section class="intro-footer__body" {
|
|
div class="intro-footer__logo" {
|
|
(PageTopSvg::LineLight.render(cx))
|
|
}
|
|
div class="intro-footer__links" {
|
|
a href="https://crates.io/crates/pagetop" target="_blank" rel="noopener noreferrer" { ("Crates.io") }
|
|
a href="https://docs.rs/pagetop" target="_blank" rel="noopener noreferrer" { ("Docs.rs") }
|
|
a href="https://git.cillero.es/manuelcillero/pagetop" target="_blank" rel="noopener noreferrer" { (L10n::l("intro_code").using(cx)) }
|
|
em { (L10n::l("intro_have_fun").using(cx)) }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
impl Intro {
|
|
// **< Intro BUILDER >**************************************************************************
|
|
|
|
/// Establece el título de entrada.
|
|
///
|
|
/// # Ejemplo
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default().with_title(L10n::n("Intro title"));
|
|
/// ```
|
|
#[builder_fn]
|
|
pub fn with_title(mut self, title: L10n) -> Self {
|
|
self.title = title;
|
|
self
|
|
}
|
|
|
|
/// Establece el eslogan de entrada (línea secundaria del título).
|
|
///
|
|
/// # Ejemplo
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default().with_slogan(L10n::n("A short slogan"));
|
|
/// ```
|
|
#[builder_fn]
|
|
pub fn with_slogan(mut self, slogan: L10n) -> Self {
|
|
self.slogan = slogan;
|
|
self
|
|
}
|
|
|
|
/// Configura el botón opcional de llamada a la acción.
|
|
///
|
|
/// - Usa `Some((texto, closure_url))` para mostrarlo, donde [`FnPathByContext`] recibe el
|
|
/// [`Context`] y devuelve la ruta o URL final al pulsar el botón.
|
|
/// - Usa `None` para ocultarlo.
|
|
///
|
|
/// # Ejemplo
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// // Define un botón con texto y una URL fija.
|
|
/// let intro = Intro::default().with_button(Some((L10n::n("Learn more"), |_| "/start")));
|
|
/// // Descarta el botón de la intro.
|
|
/// let intro_no_button = Intro::default().with_button(None);
|
|
/// ```
|
|
#[builder_fn]
|
|
pub fn with_button(mut self, button: Option<(L10n, FnPathByContext)>) -> Self {
|
|
self.button = button;
|
|
self
|
|
}
|
|
|
|
/// Selecciona el tipo de apertura: [`IntroOpening::PageTop`] (por defecto) o
|
|
/// [`IntroOpening::Custom`].
|
|
///
|
|
/// - `PageTop`: añade *badges* automáticos y una presentación de lo que es PageTop.
|
|
/// - `Custom`: introducción en blanco para añadir cualquier contenido.
|
|
///
|
|
/// # Ejemplo
|
|
///
|
|
/// ```rust
|
|
/// # use pagetop::prelude::*;
|
|
/// let intro = Intro::default().with_opening(IntroOpening::Custom);
|
|
/// ```
|
|
#[builder_fn]
|
|
pub fn with_opening(mut self, opening: IntroOpening) -> Self {
|
|
self.opening = opening;
|
|
self
|
|
}
|
|
|
|
/// Añade un nuevo componente hijo a la intro.
|
|
///
|
|
/// Si es un bloque ([`Block`]) aplica estilos específicos para destacarlo.
|
|
#[inline]
|
|
pub fn add_child(mut self, component: impl Component) -> Self {
|
|
self.children.add(Child::with(component));
|
|
self
|
|
}
|
|
|
|
/// Modifica la lista de componentes (`children`) aplicando una operación [`ChildOp`].
|
|
#[builder_fn]
|
|
pub fn with_child(mut self, op: ChildOp) -> Self {
|
|
self.children.alter_child(op);
|
|
self
|
|
}
|
|
|
|
// **< Intro GETTERS >**************************************************************************
|
|
|
|
/// Devuelve el título de entrada.
|
|
pub fn title(&self) -> &L10n {
|
|
&self.title
|
|
}
|
|
|
|
/// Devuelve el eslogan de la entrada.
|
|
pub fn slogan(&self) -> &L10n {
|
|
&self.slogan
|
|
}
|
|
|
|
/// Devuelve el botón de llamada a la acción, si existe.
|
|
pub fn button(&self) -> Option<(&L10n, &FnPathByContext)> {
|
|
self.button.as_ref().map(|(txt, lnk)| (txt, lnk))
|
|
}
|
|
|
|
/// Devuelve el modo de apertura configurado.
|
|
pub fn opening(&self) -> IntroOpening {
|
|
self.opening
|
|
}
|
|
|
|
/// Devuelve la lista de componentes (`children`) de la intro.
|
|
pub fn children(&self) -> &Children {
|
|
&self.children
|
|
}
|
|
}
|