Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions components/textbox/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ You can control [various attributes](#textbox-parameters) of the `input` element
}
````

> 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.

## Appearance

The TextBox component provides settings to control its appearance. [Read more about the Blazor TextBox appearance settings](slug:textbox-appearance).
Expand Down
11 changes: 8 additions & 3 deletions getting-started/web-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ This article explains how to use the Telerik UI for Blazor components in a Blazo

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

> 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.

## Prerequisites

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

1. Click **Create**.

> 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.
### Interactive Render Mode

> 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.
> 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.
>
> The `Account` section in the Blazor Web App template with identity is static by design. Most Telerik Blazor components cannot work in this section.

Expand Down Expand Up @@ -88,9 +93,9 @@ Add the `@using` directives below in the `~/_Imports.razor` file in all projects

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

@[template](/_contentTemplates/common/get-started.md#root-component-main-layout)
> 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.

> 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.
@[template](/_contentTemplates/common/get-started.md#root-component-main-layout)

### 5.4. Register the Telerik Blazor Service

Expand Down
2 changes: 1 addition & 1 deletion getting-started/what-you-need.md
Original file line number Diff line number Diff line change
Expand Up @@ -235,7 +235,7 @@ The `TelerikRootComponent` placement depends on the interactivity location of th
> * .NET 8 or 9 Blazor Web Apps with **Global** interactivity location
> * Blazor Server, WebAssembly and Hybrid apps in all .NET versions
>
> 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).
> 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).

### Optimal TelerikRootComponent Usage

Expand Down