From e8c047bd8df877e2178a4ac027eff2bff93bec75 Mon Sep 17 00:00:00 2001 From: SkyZeroZx <73321943+SkyZeroZx@users.noreply.github.com> Date: Tue, 24 Mar 2026 13:13:05 -0500 Subject: [PATCH] docs: update defer section to Markdown and fix absolute URL to relative in adev (cherry picked from commit 098553bfe4d9af678843d25b4333a44275f725de) --- .../2-loading-error-placeholder/README.md | 30 ++++--------------- .../steps/3-defer-triggers/README.md | 22 +++----------- 2 files changed, 9 insertions(+), 43 deletions(-) diff --git a/adev/src/content/tutorials/deferrable-views/steps/2-loading-error-placeholder/README.md b/adev/src/content/tutorials/deferrable-views/steps/2-loading-error-placeholder/README.md index 40d584c770b..00e164d9d6e 100644 --- a/adev/src/content/tutorials/deferrable-views/steps/2-loading-error-placeholder/README.md +++ b/adev/src/content/tutorials/deferrable-views/steps/2-loading-error-placeholder/README.md @@ -2,31 +2,11 @@ Deferrable views let you define content to be shown in different loading states. -
- - - - - - - - - - - - - -
@placeholder - By default, defer blocks do not render any content before they are triggered. The @placeholder is an optional block that declares content to show before the deferred content loads. Angular replaces the placeholder with the deferred content after loading completes. While this block is optional, the Angular team recommends always including a placeholder. - - Learn more in the full deferrable views documentation - -
@loading - This optional block allows you to declare content to be shown during the loading of any deferred dependencies. -
@error - This block allows you to declare content which is shown if deferred loading fails. -
-
+| Block | Description | +| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `@placeholder` | By default, defer blocks do not render any content before they are triggered. The `@placeholder` is an optional block that declares content to show before the deferred content loads. Angular replaces the placeholder with the deferred content after loading completes. While this block is optional, the Angular team recommends always including a placeholder. [Learn more in the full deferrable views documentation](guide/templates/defer) | +| `@loading` | This optional block allows you to declare content to be shown during the loading of any deferred dependencies. | +| `@error` | This block allows you to declare content which is shown if deferred loading fails. | The contents of all the above sub-blocks are eagerly loaded. Additionally, some features require a `@placeholder` block. diff --git a/adev/src/content/tutorials/deferrable-views/steps/3-defer-triggers/README.md b/adev/src/content/tutorials/deferrable-views/steps/3-defer-triggers/README.md index a9689e27e72..66be85fd711 100644 --- a/adev/src/content/tutorials/deferrable-views/steps/3-defer-triggers/README.md +++ b/adev/src/content/tutorials/deferrable-views/steps/3-defer-triggers/README.md @@ -6,24 +6,10 @@ By default, deferred content loads when the browser is idle. You can, however, c Deferrable views offer two types of loading trigger: -
- - - - - - - - - -
on - A trigger condition using a trigger from the list of built-in triggers.
- For example: @defer (on viewport) -
when - A condition as an expression which is evaluated for truthiness. When the expression is truthy, the placeholder is swapped with the lazily loaded content.
- For example: @defer (when customizedCondition) -
-
+| Trigger | Description | +| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `on` | A trigger condition using a trigger from the list of built-in triggers.
For example: `@defer (on viewport)` | +| `when` | A condition as an expression which is evaluated for truthiness. When the expression is truthy, the placeholder is swapped with the lazily loaded content.
For example: `@defer (when customizedCondition)` | If the `when` condition evaluates to `false`, the `defer` block is not reverted back to the placeholder. The swap is a one-time operation.