✨ Mensajes flash y Messages automático en Content

- Componentes aplazados: `Component::is_deferred()` deja una marca
  `<!-- placeholder ... -->` y `Page::render()` los renderiza al final
  del `<body>`, en su sitio. Si no generan nada, la marca se queda.
- `Region` empieza `Content` con un `Messages` aplazado, que recoge
  todos los mensajes de la página. Las aplicaciones ya no tienen que
  añadirlo.
- `Messages` retira los mensajes que muestra y admite `with_deferred()`.
- `ResponseExt::with_message()` deja mensajes para la página siguiente
  en una cookie técnica de vida corta, que sólo se crea si se usa.
- Basic y Bootsier ocultan las regiones vacías con `.region:empty`.
This commit is contained in:
Manuel Cillero 2026-11-02 13:20:36 +01:00
parent a110dd0482
commit c9fdc7afc7
18 changed files with 935 additions and 49 deletions

View file

@ -190,28 +190,40 @@ impl Page {
///
/// El proceso de renderizado de la página sigue esta secuencia:
///
/// 1. Ejecuta
/// [`Theme::before_render_page_body()`](crate::core::theme::Theme::before_render_page_body)
/// para que el tema pueda ejecutar acciones específicas antes de renderizar el `<body>`.
/// 1. Ejecuta [`Theme::before_render_page_body()`] para que el tema pueda ejecutar acciones
/// específicas antes de renderizar el `<body>`.
/// 2. Despacha [`action::page::BeforeRenderBody`] para que otras extensiones puedan realizar
/// ajustes previos sobre la página.
/// 3. **Construye el contenido del `<body>`**:
/// - Renderiza la región reservada superior ([`ReservedRegions::PageTop`]).
/// - Llama a [`Theme::render_page_body()`](crate::core::theme::Theme::render_page_body) para
/// renderizar las regiones del cuerpo principal de la página.
/// - Llama a [`Theme::render_page_body()`] para renderizar las regiones del cuerpo principal
/// de la página.
/// - Renderiza la región reservada inferior ([`ReservedRegions::PageBottom`]).
/// 4. Ejecuta
/// [`Theme::after_render_page_body()`](crate::core::theme::Theme::after_render_page_body)
/// para que el tema pueda aplicar ajustes finales.
///
/// Los componentes que se aplazan ([`Component::is_deferred()`]), como el componente
/// [`Messages`] que encabeza la región [`CoreRegions::Content`], dejan de momento una marca
/// en su lugar.
/// 4. Ejecuta [`Theme::after_render_page_body()`] para que el tema pueda aplicar ajustes
/// finales.
/// 5. Despacha [`action::page::AfterRenderBody`] para permitir que otras extensiones realicen
/// sus últimos ajustes tras generar el `<body>`.
/// 6. Renderiza el `<head>` llamando a
/// [`Theme::render_page_head()`](crate::core::theme::Theme::render_page_head).
/// 7. Obtiene el idioma y la dirección del texto a partir de
/// [`Context::langid()`](crate::core::component::Context::langid) e inserta los atributos
/// `lang` y `dir` en la etiqueta `<html>`.
/// 8. Compone el documento HTML completo (`<!DOCTYPE html>`, `<html>`, `<head>`, `<body>`) y
/// 6. Renderiza los componentes aplazados y sustituye sus marcas por el resultado; si alguno no
/// genera nada, su marca se queda. Así muestran también lo que se haya acumulado en el
/// contexto en los pasos anteriores (por ejemplo, los mensajes para el usuario).
/// 7. Renderiza el `<head>` llamando a [`Theme::render_page_head()`].
/// 8. Obtiene el idioma y la dirección del texto a partir de [`Context::langid()`] e inserta
/// los atributos `lang` y `dir` en la etiqueta `<html>`.
/// 9. Compone el documento HTML completo (`<!DOCTYPE html>`, `<html>`, `<head>`, `<body>`) y
/// devuelve un [`Result`] con el [`Markup`] final.
///
/// [`Theme::before_render_page_body()`]: crate::core::theme::Theme::before_render_page_body
/// [`Theme::render_page_body()`]: crate::core::theme::Theme::render_page_body
/// [`Theme::after_render_page_body()`]: crate::core::theme::Theme::after_render_page_body
/// [`Theme::render_page_head()`]: crate::core::theme::Theme::render_page_head
/// [`CoreRegions::Content`]: crate::core::theme::CoreRegions::Content
/// [`Component::is_deferred()`]: crate::core::component::Component::is_deferred
/// [`Context::langid()`]: crate::core::component::Context::langid
/// [`Messages`]: crate::base::component::Messages
pub async fn render(&mut self) -> Result<Markup, ErrorPage> {
// Acciones específicas del tema antes de renderizar el <body>.
self.context.theme().before_render_page_body(self);
@ -219,7 +231,8 @@ impl Page {
// Acciones de las extensiones antes de renderizar el <body>.
action::page::BeforeRenderBody::dispatch(self);
// Renderiza el <body>.
// Renderiza el <body>, aplazando los componentes que lo pidan.
self.context.start_deferring();
let body = html! {
(layout::Region::of(&ReservedRegions::PageTop).render(&mut self.context).await)
(self.context.theme().render_page_body(self).await)
@ -232,6 +245,9 @@ impl Page {
// Acciones de las extensiones después de renderizar el <body>.
action::page::AfterRenderBody::dispatch(self);
// Renderiza los componentes aplazados, antes del <head> para que lleguen sus recursos.
let body = self.context.render_deferred(body).await;
// Renderiza el <head>.
let head = self.context.theme().render_page_head(self).await;