manuelcillero/pagetop
manuelcillero/pagetop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

📝 [component] Amplía documentación de preparación

Browse source 
Añade un párrafo explicando la mejor manera de que `prepare_component()`
pueda ser útil a los programadores que sobrescriban su comportamiento.
This commit is contained in:
Manuel Cillero 2025-08-24 10:04:51 +02:00
parent 7ebd7b0e49
commit 282b903eaf
1 changed files with 6 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/core/component/definition.rs
View file

@ -51,12 +51,17 @@ pub trait Component: AnyInfo + ComponentRender + Send + Sync {
#[allow(unused_variables)] #[allow(unused_variables)]
fn setup_before_prepare(&mut self, cx: &mut Context) {} fn setup_before_prepare(&mut self, cx: &mut Context) {}
/// Devuelve una representación estructurada del componente lista para renderizar. /// Devuelve una representación estructurada del componente preparada para el renderizado.
/// ///
/// Este método forma parte del ciclo de vida de los componentes y se invoca automáticamente /// Este método forma parte del ciclo de vida de los componentes y se invoca automáticamente
/// durante el proceso de construcción del documento. Puede sobrescribirse para generar /// durante el proceso de construcción del documento. Puede sobrescribirse para generar
/// dinámicamente el contenido HTML con acceso al contexto de renderizado. /// dinámicamente el contenido HTML con acceso al contexto de renderizado.
/// ///
/// Este método debe ser capaz de preparar el renderizado del componente con los métodos del
/// propio componente y el contexto proporcionado, no debería hacerlo accediendo directamente a
/// los campos de la estructura del componente. Es una forma de garantizar que los programadores
/// podrán sobrescribir este método sin preocuparse por los detalles internos del componente.
///
/// Por defecto, devuelve [`PrepareMarkup::None`]. /// Por defecto, devuelve [`PrepareMarkup::None`].
#[allow(unused_variables)] #[allow(unused_variables)]
fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup { fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup {