From 0ac7329a79e0b7e8a1d32b1eee4dd0bdd484a7e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Simon=20Andr=C3=A9?= Date: Wed, 6 Mar 2024 16:26:07 +0100 Subject: [PATCH] Rewrite loading paragraph --- src/LiveComponent/doc/index.rst | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/src/LiveComponent/doc/index.rst b/src/LiveComponent/doc/index.rst index 03d12999042..76e33dc5a0a 100644 --- a/src/LiveComponent/doc/index.rst +++ b/src/LiveComponent/doc/index.rst @@ -2259,21 +2259,17 @@ Deferring / Lazy Loading Components ----------------------------------- When a page loads, all components are rendered immediately. If a component is -heavy to render, you can defer its rendering after the page has loaded. - -Moreover, some components are not needed until the user scrolls to them (like -components at the bottom of a long page like comments, related products, etc.). -In this case, you can load them "lazily" when they are in the viewport. - -By loading a component asynchronously, the page will load faster and the user -will be able to interact with it sooner, improving both the user experience -and the overall performance of your application. +heavy to render, you can defer its rendering until after the page has loaded. +This is done by making an Ajax call to load the component's real content either +as soon as the page loads (``defer``) or when the component becomes visible +(``lazy``). .. note:: Behind the scenes, your component *is* created & mounted during the initial - page load, but its template isn't rendered. So keep your heavy work to methods in - your component (e.g. ``getProducts()``) that are only called when rendering. + page load, but its template isn't rendered. So keep your heavy work to + methods in your component (e.g. ``getProducts()``) that are only called + from the component's template. Loading "defer" (Ajax on Load) ~~~~~~~~~~~~~~~