🎨 (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.
|
||||
///
|
||||
/// 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
|
||||
/// 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.
|
||||
///
|
||||
/// 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.
|
||||
#[async_trait]
|
||||
pub trait ComponentRender {
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ use crate::web::Router;
|
|||
|
||||
/// 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:
|
||||
///
|
||||
/// ```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
|
||||
/// 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
|
||||
/// predeterminados.
|
||||
///
|
||||
|
|
|
|||
|
|
@ -81,9 +81,9 @@ pub enum PropsError {
|
|||
///
|
||||
/// 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
|
||||
/// estructura de un componente ya definido, temas y extensiones pueden definir un *trait* con
|
||||
/// nuevos métodos que leen y escriben valores extra en [`Props`]. Esos valores se interpretan como
|
||||
/// si fueran valores internos del componente para tomar decisiones durante el renderizado.
|
||||
/// estructura de un componente ya definido, temas y extensiones pueden definir un trait con nuevos
|
||||
/// métodos que leen y escriben valores extra en [`Props`]. Esos valores se interpretan como si
|
||||
/// fueran valores internos del componente para tomar decisiones durante el renderizado.
|
||||
#[derive(Clone, Debug)]
|
||||
pub enum PropsOp {
|
||||
/// 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
|
||||
/// [`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
|
||||
/// 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.
|
||||
///
|
||||
/// ```rust
|
||||
|
|
|
|||
|
|
@ -125,8 +125,8 @@ use std::ops::Deref;
|
|||
/// referencia a la versión del *crate* que lo usa.
|
||||
pub const PAGETOP_VERSION: &str = env!("CARGO_PKG_VERSION");
|
||||
|
||||
/// Re-exporta el atributo [`async_trait`](https://docs.rs/async-trait) para implementar *traits*
|
||||
/// con métodos `async`.
|
||||
/// Re-exporta el atributo [`async_trait`](https://docs.rs/async-trait) para implementar traits con
|
||||
/// métodos `async`.
|
||||
///
|
||||
/// 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
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ static FALLBACK_LANGID: LazyLock<LanguageIdentifier> = LazyLock::new(|| langid!(
|
|||
|
||||
/// 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
|
||||
/// el recurso no tiene uno asignado, se puede devolver, si procede, el identificador de idioma por
|
||||
/// 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`]
|
||||
/// 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.
|
||||
///
|
||||
/// [`LangNegotiation`]: crate::global::LangNegotiation
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue