♻️ (locale): Renombra L10n a Lc
Simplifica el nombre del tipo de localización. Actualiza todas las referencias en el crate principal, extensiones, ejemplos y tests.
This commit is contained in:
parent
3198b74399
commit
be10dd28a1
65 changed files with 612 additions and 621 deletions
|
|
@ -206,9 +206,9 @@ impl<C: Component> Embed<C> {
|
|||
///
|
||||
/// ```rust,no_run
|
||||
/// # use pagetop::prelude::*;
|
||||
/// let mut embed = Embed::with(Block::new().with_title(L10n::n("Title")));
|
||||
/// let mut embed = Embed::with(Block::new().with_title(Lc::n("Title")));
|
||||
/// if let Some(component) = embed.get_mut() {
|
||||
/// component.alter_title(L10n::n("New Title"));
|
||||
/// component.alter_title(Lc::n("New Title"));
|
||||
/// }
|
||||
/// ```
|
||||
pub fn get_mut(&mut self) -> Option<&mut C>
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ use crate::core::theme::{ChildrenInRegions, CoreRegions, CoreTemplates};
|
|||
use crate::core::theme::{RegionRef, TemplateRef, ThemeRef};
|
||||
use crate::html::{Assets, Favicon, JavaScript, Preload, StyleSheet};
|
||||
use crate::html::{Markup, Props, PropsOp, RoutePath, html};
|
||||
use crate::locale::L10n;
|
||||
use crate::locale::Lc;
|
||||
use crate::locale::{LangId, LanguageIdentifier, RequestLocale};
|
||||
use crate::web::HttpRequest;
|
||||
use crate::{builder_fn, util};
|
||||
|
|
@ -509,9 +509,9 @@ impl Context {
|
|||
/// ```rust,no_run
|
||||
/// # use pagetop::prelude::*;
|
||||
/// # let mut cx = Context::default();
|
||||
/// cx.push_message(MessageLevel::Warning, L10n::n("Session is not valid"));
|
||||
/// cx.push_message(MessageLevel::Warning, Lc::n("Session is not valid"));
|
||||
/// ```
|
||||
pub fn push_message(&mut self, level: MessageLevel, text: L10n) {
|
||||
pub fn push_message(&mut self, level: MessageLevel, text: Lc) {
|
||||
self.messages.push(StatusMessage::new(level, text));
|
||||
}
|
||||
|
||||
|
|
@ -532,13 +532,13 @@ impl Context {
|
|||
/// global de idioma de la aplicación, la cabecera `Accept-Language` y/o el idioma de respaldo.
|
||||
///
|
||||
/// Todo ello según la negociación indicada en [`global::SETTINGS.app.lang_negotiation`]. Esto
|
||||
/// permite que el [`Context`] se use como fuente de idioma coherente en [`L10n::lookup()`] o
|
||||
/// [`L10n::using()`].
|
||||
/// permite que el [`Context`] se use como fuente de idioma coherente en [`Lc::lookup()`] o
|
||||
/// [`Lc::using()`].
|
||||
///
|
||||
/// [`Context`]: crate::core::component::Context
|
||||
/// [`global::SETTINGS.app.lang_negotiation`]: crate::global::App::lang_negotiation
|
||||
/// [`L10n::lookup()`]: crate::locale::L10n::lookup
|
||||
/// [`L10n::using()`]: crate::locale::L10n::using
|
||||
/// [`Lc::lookup()`]: crate::locale::Lc::lookup
|
||||
/// [`Lc::using()`]: crate::locale::Lc::using
|
||||
impl LangId for Context {
|
||||
#[inline]
|
||||
fn langid(&self) -> &'static LanguageIdentifier {
|
||||
|
|
|
|||
|
|
@ -111,28 +111,33 @@ pub trait Component: AnyInfo + ComponentClone + ComponentRender + Send + Sync {
|
|||
/// Genera el marcado HTML del componente cuando ningún tema lo sobrescribe.
|
||||
///
|
||||
/// Este es el cuarto paso del [ciclo de renderizado](ComponentRender) tras llamar al
|
||||
/// [`setup()`](Self::setup) del componente y despachar la acción
|
||||
/// [`BeforeRender`](crate::base::action::component::BeforeRender) que atiende los cambios de
|
||||
/// [`setup()`] del componente y despachar la acción [`BeforeRender`] que atiende los cambios de
|
||||
/// otras extensiones antes de renderizar. Se invoca sólo si ningún tema en la cadena devuelve
|
||||
/// `Some` en [`Theme::handle_component()`](crate::core::theme::Theme::handle_component) para
|
||||
/// este componente.
|
||||
/// `Some` en [`Theme::handle_component()`] para este componente.
|
||||
///
|
||||
/// Es `async`, a diferencia de [`setup()`](Self::setup), para permitir a los componentes
|
||||
/// realizar aquí sus llamadas asíncronas, como consultas a base de datos, peticiones a
|
||||
/// servicios externos, o cualquier operación de E/S, que necesiten para preparar su contenido.
|
||||
/// Es `async`, a diferencia de [`setup()`], para permitir a los componentes realizar aquí sus
|
||||
/// llamadas asíncronas, como consultas a base de datos, peticiones a servicios externos, o
|
||||
/// cualquier operación de E/S, que necesiten para preparar su contenido.
|
||||
///
|
||||
/// Se recomienda obtener los datos del componente a través de sus propios métodos para que los
|
||||
/// temas puedan implementar `handle_component()` sin depender de los detalles internos.
|
||||
///
|
||||
/// Los campos que representen contenido no deben almacenar [`Markup`] ya generado, sino que
|
||||
/// guardarán el dato en bruto, por ejemplo [`L10n`](crate::locale::L10n) para textos
|
||||
/// traducibles, o un componente anidado como [`Html`](crate::base::component::Html), o
|
||||
/// cualquier otro `Component`, normalmente a través de [`Embed`](crate::core::component::Embed)
|
||||
/// o [`Child`](crate::core::component::Child); y será este método quien lo convierta en HTML en
|
||||
/// el momento del renderizado, no quien construye la instancia.
|
||||
/// guardarán el dato en bruto, por ejemplo [`Lc`] para textos traducibles, o un componente
|
||||
/// anidado como [`Html`], o cualquier otro `Component`, normalmente a través de [`Embed`] o
|
||||
/// [`Child`]; y será este método quien lo convierta en HTML en el momento del renderizado, no
|
||||
/// quien construye la instancia.
|
||||
///
|
||||
/// Por defecto, devuelve un [`Markup`] vacío (`Ok(html! {})`). En caso de error, devuelve un
|
||||
/// [`ComponentError`] que puede incluir un marcado alternativo (*fallback*).
|
||||
///
|
||||
/// [`setup()`]: Self::setup
|
||||
/// [`BeforeRender`]: crate::base::action::component::BeforeRender
|
||||
/// [`Theme::handle_component()`]: crate::core::theme::Theme::handle_component
|
||||
/// [`Lc`]: crate::locale::Lc
|
||||
/// [`Html`]: crate::base::component::Html
|
||||
/// [`Embed`]: crate::core::component::Embed
|
||||
/// [`Child`]: crate::core::component::Child
|
||||
#[allow(unused_variables)]
|
||||
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
|
||||
Ok(html! {})
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
use crate::locale::L10n;
|
||||
use crate::locale::Lc;
|
||||
use crate::{AutoDefault, Getters};
|
||||
|
||||
/// Nivel de severidad de un [`StatusMessage`].
|
||||
|
|
@ -20,30 +20,30 @@ pub enum MessageLevel {
|
|||
/// puede generarse en cualquier punto del procesamiento de una petición web (handlers, renderizado,
|
||||
/// lógica de negocio, etc.).
|
||||
///
|
||||
/// El texto se almacena como [`L10n`] para resolverse con el idioma del contexto en el momento de
|
||||
/// la visualización.
|
||||
/// El texto se almacena como [`Lc`] para resolverse con el idioma del contexto en el momento de la
|
||||
/// visualización.
|
||||
///
|
||||
/// # Ejemplo
|
||||
///
|
||||
/// ```rust,no_run
|
||||
/// # use pagetop::prelude::*;
|
||||
/// // Mensaje informativo con clave traducible.
|
||||
/// let info = StatusMessage::new(MessageLevel::Info, L10n::l("saved-successfully"));
|
||||
/// let info = StatusMessage::new(MessageLevel::Info, Lc::l("saved-successfully"));
|
||||
///
|
||||
/// // Aviso con texto literal sin traducción.
|
||||
/// let warn = StatusMessage::new(MessageLevel::Warning, L10n::n("Incomplete form."));
|
||||
/// let warn = StatusMessage::new(MessageLevel::Warning, Lc::n("Incomplete form."));
|
||||
/// ```
|
||||
#[derive(Debug, Getters)]
|
||||
pub struct StatusMessage {
|
||||
/// Nivel de severidad del mensaje.
|
||||
level: MessageLevel,
|
||||
/// Texto del mensaje.
|
||||
text: L10n,
|
||||
text: Lc,
|
||||
}
|
||||
|
||||
impl StatusMessage {
|
||||
/// Crea un nuevo mensaje de usuario con el nivel y texto indicados.
|
||||
pub fn new(level: MessageLevel, text: L10n) -> Self {
|
||||
pub fn new(level: MessageLevel, text: Lc) -> Self {
|
||||
StatusMessage { level, text }
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue