🚧 (theme): Renombra variantes de Intent
Renombra `Intent::Secondary`/`Danger` a `Neutral`/`Severe` y actualiza Badge y su CSS por defecto (basic.css) al nuevo vocabulario. Introduce el punto de extensión `Theme::intent_color()`, que traduce una `Intent` al nombre de color de la paleta propia de cada tema, con `Intent::color(cx)` como atajo de uso desde los componentes.
This commit is contained in:
parent
af53cd4b52
commit
56a6691c87
6 changed files with 116 additions and 61 deletions
|
|
@ -3,7 +3,7 @@ use crate::base::component::{Html, Intro, IntroOpening, layout};
|
|||
use crate::core::component::{ChildOp, Component, ComponentError, ComponentRender};
|
||||
use crate::core::component::{Context, Contextual};
|
||||
use crate::core::extension::Extension;
|
||||
use crate::core::theme::CoreRegions;
|
||||
use crate::core::theme::{CoreRegions, Intent};
|
||||
use crate::global;
|
||||
use crate::html::{Markup, html};
|
||||
use crate::locale::Lc;
|
||||
|
|
@ -65,6 +65,34 @@ pub trait Theme: Extension + Send + Sync {
|
|||
None
|
||||
}
|
||||
|
||||
/// Traduce una [`Intent`] al nombre de color de la paleta propia del tema.
|
||||
///
|
||||
/// `Intent` no define ninguna cadena propia. Cada tema decide qué nombre le corresponde a cada
|
||||
/// variante en su paleta (p. ej. un tema basado en Bootstrap traduce `Severe` a `"danger"`).
|
||||
/// Los componentes que generan clases CSS a partir de una `Intent` (`Button`, `Badge`,
|
||||
/// `Dropdown`, etc.) no llaman a este método directamente en su `setup()`, usan mejor
|
||||
/// [`Intent::color()`](crate::core::theme::Intent::color) como la forma más sencilla de obtener
|
||||
/// este mismo valor a través de [`Context::theme()`](crate::core::component::Context::theme),
|
||||
/// para que la clase resultante ya nazca en la paleta del tema activo.
|
||||
///
|
||||
/// La implementación por defecto devuelve el vocabulario semántico propio de PageTop
|
||||
/// (`"primary"`, `"severe"`, etc.), que actúa como paleta base cuando ningún tema la
|
||||
/// sobrescribe.
|
||||
#[rustfmt::skip]
|
||||
fn intent_color(&self, intent: Intent) -> &'static str {
|
||||
if let Some(parent) = self.parent() {
|
||||
return parent.intent_color(intent);
|
||||
}
|
||||
match intent {
|
||||
Intent::Primary => "primary",
|
||||
Intent::Neutral => "neutral",
|
||||
Intent::Info => "info",
|
||||
Intent::Success => "success",
|
||||
Intent::Warning => "warning",
|
||||
Intent::Severe => "severe",
|
||||
}
|
||||
}
|
||||
|
||||
/// Acciones específicas del tema antes de renderizar el `<body>` de la página.
|
||||
///
|
||||
/// Es un buen lugar para inicializar o ajustar recursos en función del contexto de la página,
|
||||
|
|
|
|||
|
|
@ -1,31 +1,41 @@
|
|||
use crate::AutoDefault;
|
||||
use crate::core::component::{Context, Contextual};
|
||||
|
||||
/// Intención semántica de un componente visual.
|
||||
///
|
||||
/// Representa la intención que pretende comunicar un componente (énfasis principal, confirmación de
|
||||
/// un evento exitoso, aviso, peligro, etc.). Cada tema decidirá cómo pintarlo.
|
||||
/// Describe *qué comunica* un componente, y cada tema traduce la intención a su propia paleta de
|
||||
/// colores. Define un vocabulario con variantes por énfasis (`Primary`, `Neutral`), un canal
|
||||
/// informativo (`Info`) y una escala de severidad (`Success`, `Warning`, `Severe`).
|
||||
#[derive(AutoDefault, Clone, Copy, Debug, PartialEq)]
|
||||
pub enum Intent {
|
||||
/// Énfasis principal, suele ser la acción que más destaca a la vista.
|
||||
#[default]
|
||||
Primary,
|
||||
Secondary,
|
||||
Success,
|
||||
/// Presencia sin énfasis, una opción discreta o normal.
|
||||
Neutral,
|
||||
/// Informa de algo que merece leerse, ajeno a la escala de severidad. Encaja en notas o avisos
|
||||
/// informativos.
|
||||
Info,
|
||||
/// Destaca algo que ha ido bien, un estado favorable o un camino afirmativo. En una alerta
|
||||
/// podría indicar la confirmación de una operación correcta o un estado saludable; en un botón,
|
||||
/// la acción que confirma o aprueba algo positivamente.
|
||||
Success,
|
||||
/// Precaución, representa algo que requiere atención o cuidado. En una alerta, sería un
|
||||
/// problema no bloqueante o un aviso; en un botón, una acción que conviene meditar sin llegar a
|
||||
/// ser destructiva.
|
||||
Warning,
|
||||
Danger,
|
||||
/// Algo va mal, es peligroso o destructivo. En una alerta sería un error o un fallo bloqueante;
|
||||
/// en un botón, la acción destructiva o irreversible (p. ej. eliminar).
|
||||
Severe,
|
||||
}
|
||||
|
||||
impl Intent {
|
||||
/// Devuelve el nombre de la intención (`"primary"`, `"danger"`, etc.).
|
||||
#[rustfmt::skip]
|
||||
pub const fn as_str(&self) -> &'static str {
|
||||
match self {
|
||||
Self::Primary => "primary",
|
||||
Self::Secondary => "secondary",
|
||||
Self::Success => "success",
|
||||
Self::Info => "info",
|
||||
Self::Warning => "warning",
|
||||
Self::Danger => "danger",
|
||||
}
|
||||
/// Devuelve el nombre del color asociado a la intención en el tema activo del contexto actual.
|
||||
///
|
||||
/// Atajo de [`Theme::intent_color()`](crate::core::theme::Theme::intent_color) a través de
|
||||
/// [`Context::theme()`]. La intención no tiene una cadena propia, es el tema activo quien
|
||||
/// decide su traducción.
|
||||
pub fn color(&self, cx: &Context) -> &'static str {
|
||||
cx.theme().intent_color(*self)
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue