ClassTelerikTabStrip
The class for the Telerik Tab Strip component. Children: TabStripTab tags.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class TelerikTabStrip : BaseComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable
Inheritance: objectComponentBaseBaseComponentTelerikTabStrip
Implements:
Inherited Members
Constructors
TelerikTabStrip()
Declaration
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
[Parameter]
public string ActiveTabId { get; set; }
Property Value
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
[Parameter]
public EventCallback<string> ActiveTabIdChanged { get; set; }
Property Value
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
[Parameter]
public int ActiveTabIndex { get; set; }
Property Value
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
[Parameter]
public EventCallback<int> ActiveTabIndexChanged { get; set; }
Property Value
ChildContent
The content of the TabStrip. Children: TabStripTab tags.
Declaration
[Parameter]
public RenderFragment ChildContent { get; set; }
Property Value
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.
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.
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
[Parameter]
public bool PersistTabContent { get; set; }
Property Value
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
[Parameter]
public TabStripScrollButtonsPosition ScrollButtonsPosition { get; set; }
Property Value
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
[Parameter]
public TabStripScrollButtonsVisibility ScrollButtonsVisibility { get; set; }
Property Value
Scrollable
Enables horizontal scrolling when tabs exceed the available width.
Works with ScrollButtonsPosition and ScrollButtonsVisibility to control scroll button behavior. Default value is false.
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.
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
[Parameter]
public TabStripTabAlignment TabAlignment { get; set; }
Property Value
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
[Parameter]
public TabPosition TabPosition { get; set; }
Property Value
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.
Methods
BuildRenderTree(RenderTreeBuilder)
Declaration
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Parameters
__builder
Overrides
Dispose()
Declaration
public override void Dispose()
Overrides
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
public void Refresh()
SetParametersAsync(ParameterView)
Declaration
public override Task SetParametersAsync(ParameterView parameters)
Parameters
parameters
Returns
Overrides