Class

TelerikTabStrip

Declaration

public TelerikTabStrip()

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

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

The content of the TabStrip. Children: TabStripTab tags.

Declaration

[Parameter]
public RenderFragment ChildContent { get; set; }

Property Value

Specifies whether users can reorder tabs via drag-and-drop interaction.

Declaration

[Parameter]
public bool EnableTabReorder { get; set; }

Property Value

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

[Parameter]
public string Height { get; set; }

Property Value

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

[Parameter]
public string Id { get; set; }

Property Value

Raises after initialization whenever the TabStrip state changes, for example when the active tab changes. Use this event to get the latest state upon changes due to user interaction. This event is not raised for the initial state (handled by OnStateInit).

Declaration

[Parameter]
public EventCallback<TabStripStateEventArgs> OnStateChanged { get; set; }

Property Value

Raises when the TabStrip initializes its state, before it starts sending regular state change notifications. Use this event to inspect, customize, or restore the initial state (for example, the active tab) represented by the TabStripStateEventArgs argument.

Declaration

[Parameter]
public EventCallback<TabStripStateEventArgs> OnStateInit { get; set; }

Property Value

Occurs when a tab is reordered through drag-and-drop interaction. Provides the tab ID and its new zero-based index position after reordering.

Declaration

[Parameter]
public EventCallback<TabStripTabReorderEventArgs> OnTabReorder { get; set; }

Property Value

Configures the behavior of tabs when they exceed the available space in the tab list area.

Declaration

[Parameter]
public TabStripOverflowMode OverflowMode { get; set; }

Property Value

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

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

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

Declaration

public bool ScrollButtonsVisible { get; }

Property Value

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

Declaration

[Obsolete("The parameter is deprecated. Use OverflowMode instead with TabStripOverflowMode.Scroll value.")]
[Parameter]
public bool Scrollable { get; set; }

Property Value

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

[Parameter]
public string Size { get; set; }

Property Value

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

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

Template rendered after the tab list, inside the TabStrip container. Use this template to add custom content such as action buttons, dropdowns, or additional navigation elements related to the tabs.

Declaration

[Parameter]
public RenderFragment TabStripSuffixTemplate { get; set; }

Property Value

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

[Parameter]
public string Width { get; set; }

Property Value

Declaration

protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters

Overrides ComponentBase.BuildRenderTree(RenderTreeBuilder)

Declaration

public override void Dispose()

Overrides BaseComponent.Dispose()

Gets the current state of the TabStrip, including the active tab, the order of tabs, and the visibility and pinned settings for each tab.

Declaration

public TabStripState GetState()

Returns

Remarks

Declaration

protected override Task OnAfterRenderAsync(bool firstRender)

Parameters

Returns

Overrides BaseComponent.OnAfterRenderAsync(bool)

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()

Declaration

public override Task SetParametersAsync(ParameterView parameters)

Parameters

Returns

Overrides ComponentBase.SetParametersAsync(ParameterView)

Applies a previously captured TabStrip state to restore the active tab, tab order, and the visibility and pinned settings of each tab.

Declaration

public Task SetState(TabStripState state)

Parameters

Returns

Remarks