Class
TelerikTabStrip

The class for the Telerik Tab Strip component. Children: TabStripTab tags.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Syntax:

cs-api-definition
public class TelerikTabStrip : BaseComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseBaseComponentTelerikTabStrip

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members BaseComponent.ShouldRender()BaseComponent.OnInitializedAsync()BaseComponent.InitLocalizer()BaseComponent.ThrowIfParameterIsNull(object, string)BaseComponent.HaveOptionsChanged(IDictionary<string, object>, IDictionary<string, object>)BaseComponent.GetClassString(params string[])BaseComponent.InvokeAsync<T>(string, params object[])BaseComponent.InvokeAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidAsync(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidComponentMethodAsync(string, params object[])BaseComponent.InvokeComponentVoidMethodAsync(string, object)BaseComponent.InvokeDisposeAsync()BaseComponent.StateHasChanged()BaseComponent.RootComponentBaseComponent.ClassComponentBase.OnInitialized()ComponentBase.OnParametersSet()ComponentBase.OnParametersSetAsync()ComponentBase.OnAfterRender(bool)ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)

Constructors

TelerikTabStrip()

Declaration

cs-api-definition
public TelerikTabStrip()

Properties

ActiveTabId

Sets the unique identifier of the active tab. Cannot be used together with ActiveTabIndex - choose one approach for tab activation. Throws ArgumentException when both are provided.

Declaration

cs-api-definition
[Parameter]
public string ActiveTabId { get; set; }

Property Value

string

ActiveTabIdChanged

Occurs when the active tab changes through user interaction or programmatic updates. Use with ActiveTabId for two-way binding (bind-ActiveTabId) to track and control tab selection by unique identifier.

Declaration

cs-api-definition
[Parameter]
public EventCallback<string> ActiveTabIdChanged { get; set; }

Property Value

EventCallback<string>

ActiveTabIndex

Sets the zero-based index of the active tab. Cannot be used together with ActiveTabId - choose one approach for tab activation. Throws ArgumentException when both are provided.

Declaration

cs-api-definition
[Parameter]
public int ActiveTabIndex { get; set; }

Property Value

int

ActiveTabIndexChanged

Occurs when the active tab changes through user interaction or programmatic updates. Use with ActiveTabIndex for two-way binding (bind-ActiveTabIndex) to track and control tab selection by index.

Declaration

cs-api-definition
[Parameter]
public EventCallback<int> ActiveTabIndexChanged { get; set; }

Property Value

EventCallback<int>

ChildContent

The content of the TabStrip. Children: TabStripTab tags.

Declaration

cs-api-definition
[Parameter]
public RenderFragment ChildContent { get; set; }

Property Value

RenderFragment

Height

Sets the component height using any valid CSS unit (e.g., "400px", "75vh", "25em"). Controls the total TabStrip area including tabs and content regions.

Declaration

cs-api-definition
[Parameter]
public string Height { get; set; }

Property Value

string

Id

Sets a unique identifier for the TabStrip component instance. Useful for CSS targeting, automation testing, and accessibility scenarios where specific TabStrip identification is required.

Declaration

cs-api-definition
[Parameter]
public string Id { get; set; }

Property Value

string

PersistTabContent

Preserves tab content in memory when switching between tabs, avoiding content recreation. Improves user experience for forms and complex content but increases memory usage with many tabs. Default value is false.

Declaration

cs-api-definition
[Parameter]
public bool PersistTabContent { get; set; }

Property Value

bool

ScrollButtonsPosition

Controls where scroll buttons appear when Scrollable is enabled. Use Split (default) for buttons on both sides, Start for buttons before tabs, or End for buttons after tabs.

Declaration

cs-api-definition
[Parameter]
public TabStripScrollButtonsPosition ScrollButtonsPosition { get; set; }

Property Value

TabStripScrollButtonsPosition

ScrollButtonsVisibility

Determines when scroll buttons are visible for scrollable TabStrips. Use Auto (default) to show buttons only when needed, Visible to always show buttons, or Hidden for mouse-only scrolling.

Declaration

cs-api-definition
[Parameter]
public TabStripScrollButtonsVisibility ScrollButtonsVisibility { get; set; }

Property Value

TabStripScrollButtonsVisibility

ScrollButtonsVisible

Declaration

cs-api-definition
public bool ScrollButtonsVisible { get; }

Property Value

bool

Scrollable

Enables horizontal scrolling when tabs exceed the available width. Works with ScrollButtonsPosition and ScrollButtonsVisibility to control scroll button behavior. Default value is false.

Declaration

cs-api-definition
[Parameter]
public bool Scrollable { get; set; }

Property Value

bool

Size

Controls the visual size of tabs and related elements. Use "small", "medium" (default), or "large" to match your application's design scale and improve touch accessibility.

Declaration

cs-api-definition
[Parameter]
public string Size { get; set; }

Property Value

string

TabAlignment

Controls how tabs are aligned within the tab list area. Use Start (default) for left-aligned tabs, Center for centered tabs, or Stretched to expand tabs equally.

Declaration

cs-api-definition
[Parameter]
public TabStripTabAlignment TabAlignment { get; set; }

Property Value

TabStripTabAlignment

TabPosition

Controls the placement of the tab list relative to the content area. Set to Top (default) for tabs above content, Bottom for tabs below content, or Left/Right for vertical tab layouts.

Declaration

cs-api-definition
[Parameter]
public TabPosition TabPosition { get; set; }

Property Value

TabPosition

Width

Sets the component width using any valid CSS unit (e.g., "300px", "50%", "20em"). Affects the overall TabStrip container and influences tab scrolling behavior when combined with Scrollable.

Declaration

cs-api-definition
[Parameter]
public string Width { get; set; }

Property Value

string

Methods

BuildRenderTree(RenderTreeBuilder)

Declaration

cs-api-definition
protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters

__builder

RenderTreeBuilder

Overrides ComponentBase.BuildRenderTree(RenderTreeBuilder)

Dispose()

Declaration

cs-api-definition
public override void Dispose()

Overrides BaseComponent.Dispose()

OnAfterRenderAsync(bool)

Declaration

cs-api-definition
protected override Task OnAfterRenderAsync(bool firstRender)

Parameters

firstRender

bool

Returns

Task

Overrides BaseComponent.OnAfterRenderAsync(bool)

Refresh()

Forces the TabStrip to re-render its content and update its visual state. Call this method when external data changes require the TabStrip to refresh its appearance or when tabs are dynamically modified.

Declaration

cs-api-definition
public void Refresh()

SetParametersAsync(ParameterView)

Declaration

cs-api-definition
public override Task SetParametersAsync(ParameterView parameters)

Parameters

parameters

ParameterView

Returns

Task

Overrides ComponentBase.SetParametersAsync(ParameterView)