Skip to content

Commit 5c548c4

Browse files
dimodidimodi
authored andcommitted
docs(TextBox,Common): Highlight interactivity requirements
1 parent 2392330 commit 5c548c4

File tree

3 files changed

+11
-4
lines changed

3 files changed

+11
-4
lines changed

components/textbox/overview.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,8 @@ You can control [various attributes](#textbox-parameters) of the `input` element
3131
}
3232
````
3333

34+
> In a [Blazor Web App project template](https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure#blazor-web-app), use the TextBox component only in [interactive render mode](slug:getting-started/web-app#interactive-render-mode). Static server-side rendering (static SSR) is not supported.
35+
3436
## Appearance
3537

3638
The TextBox component provides settings to control its appearance. [Read more about the Blazor TextBox appearance settings](slug:textbox-appearance).

getting-started/web-app.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ This article explains how to use the Telerik UI for Blazor components in a Blazo
1515

1616
@[template](/_contentTemplates/common/get-started.md#prerequisites-tip)
1717

18+
> Telerik UI for Blazor [requires interactive render mode](#interactive-render-mode). Using [**Global** Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#apply-a-render-mode-to-the-entire-app) is highly recommended.
19+
1820
## Prerequisites
1921

2022
@[template](/_contentTemplates/common/get-started.md#prerequisites-download)
@@ -37,7 +39,10 @@ This article explains how to use the Telerik UI for Blazor components in a Blazo
3739

3840
1. Click **Create**.
3941

40-
> Each component in a Blazor Web App utilizes a render mode to define its hosting model, determine its rendering location, and specify whether it is interactive. Most Telerik Blazor components require interactivity. They will not respond to user actions and the Blazor framework will not refresh their UI in [Static server-side rendering mode (static SSR)](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#static-server-side-rendering-static-ssr). Telerik Blazor components with JavaScript rendering (Barcodes, Charts, Gauges, Maps, and QR Codes) will not render in static SSR at all.
42+
### Interactive Render Mode
43+
44+
> Telerik UI for Blazor requires interactive render mode. Using [**Global** Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#apply-a-render-mode-to-the-entire-app) is highly recommended.
45+
> The Telerik Blazor components will not respond to user actions and the Blazor framework will not refresh their UI in [Static server-side rendering mode (static SSR)](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#static-server-side-rendering-static-ssr). Telerik Blazor components with JavaScript rendering (Barcodes, Charts, Gauges, Maps, and QR Codes) will not render in static SSR at all.
4146
>
4247
> The `Account` section in the Blazor Web App template with identity is static by design. Most Telerik Blazor components cannot work in this section.
4348
@@ -88,9 +93,9 @@ Add the `@using` directives below in the `~/_Imports.razor` file in all projects
8893

8994
Use a single [`TelerikRootComponent`](slug:rootcomponent-overview) component as a top-level component in the app.
9095

91-
@[template](/_contentTemplates/common/get-started.md#root-component-main-layout)
96+
> The `TelerikRootComponent` requires [interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes). Layout components are interactive only in applications with **Global** Interactivity location. This section applies only to apps with **Global** interactivity. If your app is using **Per page/component** interactivity, then check [Using TelerikRootComponent in apps with per component interactivity](slug:rootcomponent-percomponent) instead.
9297
93-
> The `TelerikRootComponent` requires an [interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes). Layout components are interactive only in applications with **Global** Interactivity location. This section 4.3 applies only to apps with **Global** interactivity. If your app is using **Per page/component** interactivity, then check [Using TelerikRootComponent in apps with per component interactivity](slug:rootcomponent-percomponent) instead.
98+
@[template](/_contentTemplates/common/get-started.md#root-component-main-layout)
9499

95100
### 5.4. Register the Telerik Blazor Service
96101

getting-started/what-you-need.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ The `TelerikRootComponent` placement depends on the interactivity location of th
235235
> * .NET 8 or 9 Blazor Web Apps with **Global** interactivity location
236236
> * Blazor Server, WebAssembly and Hybrid apps in all .NET versions
237237
>
238-
> If you have a Blazor Web App with **Per page/component** interactivity location, then the correct `TelerikRootComponent` usage is different. The component still needs to wrap all other Telerik components, but it cannot reside in a static layout file, because the [other Telerik component will not detect it](slug:common-kb-component-requires-telerikrootcomponent). Refer to section [Interactivity Considerations](slug:rootcomponent-overview#interactivity-considerations) and article [Using TelerikRootComponent with Per Page/Component Interactivity](slug:rootcomponent-percomponent).
238+
> If you have a Blazor Web App with **Per page/component** interactivity location, then the correct `TelerikRootComponent` usage is different. The component still needs to wrap all other Telerik components, but it cannot reside in a static layout file, because the [other Telerik components will not detect it](slug:common-kb-component-requires-telerikrootcomponent). Refer to section [Interactivity Considerations](slug:rootcomponent-overview#interactivity-considerations) and article [Using TelerikRootComponent with Per Page/Component Interactivity](slug:rootcomponent-percomponent).
239239
240240
### Optimal TelerikRootComponent Usage
241241

0 commit comments

Comments
 (0)