✨ 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

@ -80,7 +80,31 @@ pub enum CoreRegions {
/// Región principal de **contenido**, de nombre `"content"`.
///
/// Es la región donde se renderiza el contenido principal del documento. En general será la
/// región mínima imprescindible para que una página tenga sentido.
/// región mínima imprescindible para que una página tenga sentido, y la única que cualquier
/// plantilla debe incluir.
///
/// [`Region`] le añade por defecto un componente [`Messages`] al inicio, para mostrar al
/// usuario los mensajes acumulados en el [`Context`] (ver [`Context::push_message()`]),
/// incluidos los que llegan de la página anterior (ver [`ResponseExt::with_message()`]). Las
/// aplicaciones no tienen que añadirlo.
///
/// Para poder mostrar todos los mensajes, este componente [`Messages`] se renderiza al final,
/// cuando ya se han renderizado los demás componentes de la página y se han acumulado sus
/// mensajes. Aun así, se muestra en su sitio, al inicio de la región.
///
/// Cada componente [`Messages`] retira los mensajes que muestra, para que no se repitan. Si la
/// página incluye otro (por ejemplo, junto a un formulario), éste muestra los acumulados hasta
/// el momento de renderizarse, esté donde esté, y el del inicio de la región sólo los que se
/// añadan después; si no queda ninguno, no muestra nada. Un [`Messages`] aplazado (ver
/// [`Messages::with_deferred()`]) colocado antes de esta región se renderiza antes que éste y
/// se queda con todos.
///
/// [`Region`]: crate::base::component::layout::Region
/// [`Messages`]: crate::base::component::Messages
/// [`Messages::with_deferred()`]: crate::base::component::Messages::with_deferred
/// [`Context`]: crate::core::component::Context
/// [`Context::push_message()`]: crate::core::component::Context::push_message
/// [`ResponseExt::with_message()`]: crate::response::ResponseExt::with_message
#[default]
Content,