New to Telerik UI for Blazor? Download free 30-day trial

Using TelerikRootComponent with Per Page/Component Interactivity

.NET 8.0 introduced new render modes for Blazor web apps. The default render mode is static, while Telerik Blazor components require interactive render mode. This article explains how to use the TelerikRootComponent in static apps with specific interactive Razor components.


The TelerikRootComponent must reside in an interactive layout or component in order to pass cascading values to all other Telerik Blazor components. The TelerikRootComponent placement in the app depends on the selected Interactivity location during app creation.

In apps with Global interactivity location, it's best to add the TelerikRootComponent to a layout.

In apps with Per page/component interactivity, the layout files are static. There are three options to use the TelerikRootComponent in this case:

The sections below provide additional information for each of the three options. Review this .NET 8 Blazor Web App sample project on GitHub, which also demonstrates all three options.

Add TelerikRootComponent to Interactive Pages

In this scenario, add a TelerikRootComponent to all interactive .razor pages, which host Telerik Blazor components. The TelerikRootComponent will not wrap all the page content, so a possible side effect may be wrong popup position. Component interactivity is inherited, so nested components will not need to be explicitly interactive.

Here are the detailed steps:

1. Create a TelerikContainer.razor file and configure the <TelerikRootComponent> in it. The TelerikContainer component is not required, but it allows you to reuse a single TelerikRootComponent with the same settings across the whole app.


<TelerikRootComponent IconType="@IconType.Svg"

@code {
    public RenderFragment? ChildContent { get; set; }

2. Enable interactive render mode for the .razor page, which will hold Telerik Blazor components, for example, Home.razor.


@page "/"

@rendermode InteractiveServer

3. Add the TelerikContainer component to Home.razor and add Telerik Blazor components as child content. Make sure that <TelerikContainer> is recognized as a Razor component. Add a @using statement to achieve this, for example, if the two .razor files are in different folders.


@page "/"

@rendermode InteractiveServer


    <TelerikDatePicker @bind-Value="@DatePickerValue" Width="200px" />


@code {
    private DateTime DatePickerValue { get; set; } = DateTime.Today;

When the TelerikRootComponent is added to a .razor file, you cannot reference the DialogFactory and use predefined dialogs in the same .razor file. The DialogFactory will be available to child components of the TelerikRootComponent. However, a workaround exists.

Change the App Render Mode at Runtime

In this scenario, add a TelerikRootComponent to a layout as if the application has Global interactivity location. Then, enable global interactivity at runtime when the user navigates to a page (component) with Telerik components inside. To do this, set the @rendermode conditionally in App.razor. Blazor Web Apps with identity use the same approach to disable interactivity in the Account section.

Change render mode at runtime in App.razor

<!DOCTYPE html>
<html lang="en">

    @ ... @
    <HeadOutlet @rendermode="@RenderModeForPage" />

    <Routes @rendermode="@RenderModeForPage" />
    @ ... @


@code {
    private HttpContext HttpContext { get; set; } = default!;

    private IComponentRenderMode? RenderModeForPage =>
            ? InteractiveServer
            : null;

Use Empty Layout

In this scenario, use a regular layout (MainLayout.razor) for static pages and another empty layout (for example, EmptyLayout.razor) for interactive pages with Telerik components. The contents of MainLayout.razor must be copied to a non-layout .razor page, which uses the empty layout. Here are the detailed steps, which refer to a .NET 8 Blazor Web App sample project on GitHub:

  1. Create a new layout file EmptyLayout.razor in the same folder as MainLayout.razor.
  2. Copy the contents for MainLayout.razor to a non-layout .razor file, for example, Shared/LayoutContainer.razor.
  3. Copy MainLayout.razor.css as Shared/LayoutContainer.razor.css.
  4. Replace @Body with @ChildContent in the copied layout content (LayoutContainer.razor).
  5. Reference EmptyLayout.razor in a Razor component with Telerik Blazor components inside.
  6. Wrap all Telerik components in a <LayoutContainer> component.

This code duplication requires more effort to maintain, but avoids possible issues with popup position. The approach is applicable to Blazor Web Apps with Server render mode. Apps with WebAssembly or Auto render mode, and Per page/component interactivity, have their layout files and interactive .razor components in separate projects, which limits the ability to switch layouts.

See Also

In this article