🎨 (core): Retoques de estilo menores
This commit is contained in:
parent
b50d186fb1
commit
997017bb75
11 changed files with 23 additions and 22 deletions
|
|
@ -109,7 +109,7 @@ impl TypeInfo {
|
||||||
|
|
||||||
/// Proporciona información de tipo en tiempo de ejecución y conversión dinámica de tipos.
|
/// Proporciona información de tipo en tiempo de ejecución y conversión dinámica de tipos.
|
||||||
///
|
///
|
||||||
/// Este *trait* se implementa automáticamente para **todos** los tipos que implementen [`Any`], de
|
/// Este trait se implementa automáticamente para **todos** los tipos que implementen [`Any`], de
|
||||||
/// modo que basta con traer [`AnyInfo`] al ámbito (`use crate::AnyInfo;`) para disponer de estos
|
/// modo que basta con traer [`AnyInfo`] al ámbito (`use crate::AnyInfo;`) para disponer de estos
|
||||||
/// métodos adicionales, o usar el [`prelude`](crate::prelude) de PageTop.
|
/// métodos adicionales, o usar el [`prelude`](crate::prelude) de PageTop.
|
||||||
///
|
///
|
||||||
|
|
|
||||||
|
|
@ -18,7 +18,7 @@ pub trait ComponentClone {
|
||||||
|
|
||||||
/// Define la función de renderizado para todos los componentes.
|
/// Define la función de renderizado para todos los componentes.
|
||||||
///
|
///
|
||||||
/// Este *trait* se implementa automáticamente en cualquier tipo (componente) que implemente
|
/// Este trait se implementa automáticamente en cualquier tipo (componente) que implemente
|
||||||
/// [`Component`], por lo que no requiere ninguna codificación manual.
|
/// [`Component`], por lo que no requiere ninguna codificación manual.
|
||||||
#[async_trait]
|
#[async_trait]
|
||||||
pub trait ComponentRender {
|
pub trait ComponentRender {
|
||||||
|
|
|
||||||
|
|
@ -8,7 +8,7 @@ use crate::web::Router;
|
||||||
|
|
||||||
/// Interfaz común que debe implementar cualquier extensión de PageTop.
|
/// Interfaz común que debe implementar cualquier extensión de PageTop.
|
||||||
///
|
///
|
||||||
/// Este *trait* es fácil de implementar, basta con declarar una estructura sin campos para la
|
/// Este trait es fácil de implementar, basta con declarar una estructura sin campos para la
|
||||||
/// extensión y sobrescribir los métodos que sean necesarios. Por ejemplo:
|
/// extensión y sobrescribir los métodos que sean necesarios. Por ejemplo:
|
||||||
///
|
///
|
||||||
/// ```rust,no_run
|
/// ```rust,no_run
|
||||||
|
|
|
||||||
|
|
@ -19,7 +19,7 @@ use crate::web::http::StatusCode;
|
||||||
/// error. El contenido de cada región depende del [`Context`](crate::core::component::Context) y de
|
/// error. El contenido de cada región depende del [`Context`](crate::core::component::Context) y de
|
||||||
/// su nombre lógico.
|
/// su nombre lógico.
|
||||||
///
|
///
|
||||||
/// Todos los métodos de este *trait* tienen una implementación por defecto, por lo que pueden
|
/// Todos los métodos de este trait tienen una implementación por defecto, por lo que pueden
|
||||||
/// sobrescribirse selectivamente para crear nuevos temas con comportamientos distintos a los
|
/// sobrescribirse selectivamente para crear nuevos temas con comportamientos distintos a los
|
||||||
/// predeterminados.
|
/// predeterminados.
|
||||||
///
|
///
|
||||||
|
|
|
||||||
|
|
@ -81,9 +81,9 @@ pub enum PropsError {
|
||||||
///
|
///
|
||||||
/// Las variantes `*Extra` permiten añadir valores tipados usando una clave. Están pensadas para
|
/// Las variantes `*Extra` permiten añadir valores tipados usando una clave. Están pensadas para
|
||||||
/// ampliar el comportamiento de componentes ya existentes. Como no es posible añadir campos a la
|
/// ampliar el comportamiento de componentes ya existentes. Como no es posible añadir campos a la
|
||||||
/// estructura de un componente ya definido, temas y extensiones pueden definir un *trait* con
|
/// estructura de un componente ya definido, temas y extensiones pueden definir un trait con nuevos
|
||||||
/// nuevos métodos que leen y escriben valores extra en [`Props`]. Esos valores se interpretan como
|
/// métodos que leen y escriben valores extra en [`Props`]. Esos valores se interpretan como si
|
||||||
/// si fueran valores internos del componente para tomar decisiones durante el renderizado.
|
/// fueran valores internos del componente para tomar decisiones durante el renderizado.
|
||||||
#[derive(Clone, Debug)]
|
#[derive(Clone, Debug)]
|
||||||
pub enum PropsOp {
|
pub enum PropsOp {
|
||||||
/// Establece el identificador del componente normalizando el valor: recorta espacios, convierte
|
/// Establece el identificador del componente normalizando el valor: recorta espacios, convierte
|
||||||
|
|
@ -374,7 +374,7 @@ impl PropsOp {
|
||||||
/// Las variantes [`SetExtra`](PropsOp::SetExtra) y [`RemoveExtra`](PropsOp::RemoveExtra), usando
|
/// Las variantes [`SetExtra`](PropsOp::SetExtra) y [`RemoveExtra`](PropsOp::RemoveExtra), usando
|
||||||
/// [`PropsOp::set_extra()`] y [`PropsOp::remove_extra()`] respectivamente, permiten adjuntar
|
/// [`PropsOp::set_extra()`] y [`PropsOp::remove_extra()`] respectivamente, permiten adjuntar
|
||||||
/// valores tipados a un `Props`. Son útiles para que temas y extensiones amplíen el comportamiento
|
/// valores tipados a un `Props`. Son útiles para que temas y extensiones amplíen el comportamiento
|
||||||
/// de componentes ya existentes mediante *traits* con nuevos métodos que lean y escriban esos
|
/// de componentes ya existentes mediante traits con nuevos métodos que lean y escriban esos
|
||||||
/// valores.
|
/// valores.
|
||||||
///
|
///
|
||||||
/// ```rust
|
/// ```rust
|
||||||
|
|
|
||||||
|
|
@ -125,8 +125,8 @@ use std::ops::Deref;
|
||||||
/// referencia a la versión del *crate* que lo usa.
|
/// referencia a la versión del *crate* que lo usa.
|
||||||
pub const PAGETOP_VERSION: &str = env!("CARGO_PKG_VERSION");
|
pub const PAGETOP_VERSION: &str = env!("CARGO_PKG_VERSION");
|
||||||
|
|
||||||
/// Re-exporta el atributo [`async_trait`](https://docs.rs/async-trait) para implementar *traits*
|
/// Re-exporta el atributo [`async_trait`](https://docs.rs/async-trait) para implementar traits con
|
||||||
/// con métodos `async`.
|
/// métodos `async`.
|
||||||
///
|
///
|
||||||
/// Si en el ámbito se declara `use pagetop::prelude::*` o `use pagetop::async_trait;` basta con
|
/// Si en el ámbito se declara `use pagetop::prelude::*` o `use pagetop::async_trait;` basta con
|
||||||
/// usar el nombre corto `#[async_trait]`. Otra opción es usar su forma cualificada
|
/// usar el nombre corto `#[async_trait]`. Otra opción es usar su forma cualificada
|
||||||
|
|
|
||||||
|
|
@ -15,7 +15,7 @@ static FALLBACK_LANGID: LazyLock<LanguageIdentifier> = LazyLock::new(|| langid!(
|
||||||
|
|
||||||
/// Representa el identificador de idioma [`LanguageIdentifier`] asociado a un recurso.
|
/// Representa el identificador de idioma [`LanguageIdentifier`] asociado a un recurso.
|
||||||
///
|
///
|
||||||
/// Este *trait* permite que distintas estructuras expongan su idioma de forma uniforme. Las
|
/// Este trait permite que distintas estructuras expongan su idioma de forma uniforme. Las
|
||||||
/// implementaciones deben garantizar que siempre se devuelve un identificador de idioma válido. Si
|
/// implementaciones deben garantizar que siempre se devuelve un identificador de idioma válido. Si
|
||||||
/// el recurso no tiene uno asignado, se puede devolver, si procede, el identificador de idioma por
|
/// el recurso no tiene uno asignado, se puede devolver, si procede, el identificador de idioma por
|
||||||
/// defecto de la aplicación ([`Locale::default_langid()`]).
|
/// defecto de la aplicación ([`Locale::default_langid()`]).
|
||||||
|
|
|
||||||
|
|
@ -10,7 +10,7 @@ use super::{LangId, LanguageIdentifier, Locale};
|
||||||
/// `?lang=...`. El comportamiento concreto depende de la política global [`LangNegotiation`]
|
/// `?lang=...`. El comportamiento concreto depende de la política global [`LangNegotiation`]
|
||||||
/// configurada en la aplicación.
|
/// configurada en la aplicación.
|
||||||
///
|
///
|
||||||
/// El idioma resultante se expone a través del *trait* [`LangId`], de modo que pueda usarse
|
/// El idioma resultante se expone a través del trait [`LangId`], de modo que pueda usarse
|
||||||
/// [`RequestLocale`] como cualquier otra fuente de idioma en PageTop.
|
/// [`RequestLocale`] como cualquier otra fuente de idioma en PageTop.
|
||||||
///
|
///
|
||||||
/// [`LangNegotiation`]: crate::global::LangNegotiation
|
/// [`LangNegotiation`]: crate::global::LangNegotiation
|
||||||
|
|
|
||||||
|
|
@ -37,9 +37,10 @@ impl TestComp {
|
||||||
|
|
||||||
/// Creates a component with no id, with fixed output text.
|
/// Creates a component with no id, with fixed output text.
|
||||||
fn text(text: &str) -> Self {
|
fn text(text: &str) -> Self {
|
||||||
let mut c = Self::default();
|
Self {
|
||||||
c.text = text.to_string();
|
text: text.to_string(),
|
||||||
c
|
..Default::default()
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -31,7 +31,7 @@ impl Theme for MarkerTheme {
|
||||||
component: &mut dyn Component,
|
component: &mut dyn Component,
|
||||||
_cx: &mut Context,
|
_cx: &mut Context,
|
||||||
) -> Option<Result<Markup, ComponentError>> {
|
) -> Option<Result<Markup, ComponentError>> {
|
||||||
let template = (&*component).downcast_ref::<layout::Template>()?;
|
let template = (*component).downcast_ref::<layout::Template>()?;
|
||||||
template.template().downcast_ref::<CoreTemplates>()?;
|
template.template().downcast_ref::<CoreTemplates>()?;
|
||||||
Some(Ok(html! { "marker-template-output" }))
|
Some(Ok(html! { "marker-template-output" }))
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@ use pagetop::prelude::*;
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
async fn set_and_read_extra() {
|
async fn set_and_read_extra() {
|
||||||
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
||||||
assert_eq!(*props.extra::<bool>("ext.flag").unwrap(), true);
|
assert!(*props.extra::<bool>("ext.flag").unwrap());
|
||||||
}
|
}
|
||||||
|
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
|
|
@ -52,13 +52,13 @@ async fn extra_type_mismatch() {
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
async fn extra_or_returns_value_when_found() {
|
async fn extra_or_returns_value_when_found() {
|
||||||
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
||||||
assert_eq!(props.extra_or("ext.flag", false), true);
|
assert!(props.extra_or("ext.flag", false));
|
||||||
}
|
}
|
||||||
|
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
async fn extra_or_returns_default_on_missing() {
|
async fn extra_or_returns_default_on_missing() {
|
||||||
let props = Props::default();
|
let props = Props::default();
|
||||||
assert_eq!(props.extra_or("ext.flag", false), false);
|
assert!(!props.extra_or("ext.flag", false));
|
||||||
}
|
}
|
||||||
|
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
|
|
@ -72,7 +72,7 @@ async fn extra_or_returns_default_on_type_mismatch() {
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
async fn extra_or_default_returns_type_default_on_missing() {
|
async fn extra_or_default_returns_type_default_on_missing() {
|
||||||
let props = Props::default();
|
let props = Props::default();
|
||||||
assert_eq!(props.extra_or_default::<bool>("ext.flag"), false);
|
assert!(!props.extra_or_default::<bool>("ext.flag"));
|
||||||
assert_eq!(props.extra_or_default::<i32>("ext.count"), 0);
|
assert_eq!(props.extra_or_default::<i32>("ext.count"), 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -93,7 +93,7 @@ async fn extra_or_else_calls_closure_on_missing() {
|
||||||
async fn clone_preserves_extras() {
|
async fn clone_preserves_extras() {
|
||||||
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
let props = Props::default().with_prop(PropsOp::set_extra("ext.flag", true));
|
||||||
let cloned = props.clone();
|
let cloned = props.clone();
|
||||||
assert_eq!(*cloned.extra::<bool>("ext.flag").unwrap(), true);
|
assert!(*cloned.extra::<bool>("ext.flag").unwrap());
|
||||||
}
|
}
|
||||||
|
|
||||||
#[pagetop::test]
|
#[pagetop::test]
|
||||||
|
|
@ -103,7 +103,7 @@ async fn multiple_extras_with_different_types() {
|
||||||
.with_prop(PropsOp::set_extra("ext.count", 42_u32))
|
.with_prop(PropsOp::set_extra("ext.count", 42_u32))
|
||||||
.with_prop(PropsOp::set_extra("ext.label", "hello".to_string()));
|
.with_prop(PropsOp::set_extra("ext.label", "hello".to_string()));
|
||||||
|
|
||||||
assert_eq!(*props.extra::<bool>("ext.flag").unwrap(), true);
|
assert!(*props.extra::<bool>("ext.flag").unwrap());
|
||||||
assert_eq!(*props.extra::<u32>("ext.count").unwrap(), 42);
|
assert_eq!(*props.extra::<u32>("ext.count").unwrap(), 42);
|
||||||
assert_eq!(props.extra::<String>("ext.label").unwrap(), "hello");
|
assert_eq!(props.extra::<String>("ext.label").unwrap(), "hello");
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue