✨ 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:
parent
a110dd0482
commit
c9fdc7afc7
18 changed files with 935 additions and 49 deletions
|
|
@ -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,
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue