Back to all docs
API Reference / Telerik.Blazor.Components.Common / ButtonBase
New to Telerik UI for Blazor? Start a free 30-day trial

ButtonBase

Class

Definition

Namespace:Telerik.Blazor.Components.Common

Assembly:Telerik.Blazor.dll

Syntax:
C#
public class ButtonBase : BaseComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseBaseComponentButtonBase

Derived Classes: ButtonGroupButtonBaseDropDownButtonBaseCommandButtonBaseTelerikButtonTelerikFloatingActionButtonTelerikSmartPasteButtonTelerikSpeechToTextButtonTelerikToggleButton...

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members BaseComponent.ShouldRender()BaseComponent.OnInitializedAsync()BaseComponent.OnAfterRenderAsync(bool)BaseComponent.Dispose()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.InvokeVoidAsyncWithoutAwait(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.BuildRenderTree(RenderTreeBuilder)ComponentBase.OnInitialized()ComponentBase.OnParametersSet()ComponentBase.OnParametersSetAsync()ComponentBase.OnAfterRender(bool)ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)ComponentBase.SetParametersAsync(ParameterView)...

Constructors

ButtonBase()

C#
public ButtonBase()

Properties

AriaControls

[Accessibility] Sets the HTML aria-controls attribute for the button element. Example: "settings-panel" or "user-menu".

C#
[Parameter]
public string? AriaControls { get; set; }

AriaDescribedBy

[Accessibility] Sets the HTML aria-describedby attribute for the button element. Example: "save-help-text validation-message".

C#
[Parameter]
public string? AriaDescribedBy { get; set; }

AriaLabel

[Accessibility] Sets the HTML aria-label attribute for the button element. Example: "Save document" or "Close dialog".

C#
[Parameter]
public string? AriaLabel { get; set; }

AriaLabelledBy

[Accessibility] Sets the HTML aria-labelledby attribute for the button element.

C#
[Parameter]
public string? AriaLabelledBy { get; set; }

ChildContent

Defines the content displayed inside the button, such as text, HTML elements, or other components. When combined with an Icon, the content appears next to the icon. If only an icon is provided without content, the button becomes an icon-only button with additional styling. Children: Any content to display inside the button.

C#
[Parameter]
public RenderFragment? ChildContent { get; set; }

Enabled

Controls whether the button responds to user interaction. The TabIndex automatically becomes -1 when disabled to ensure proper keyboard navigation flow. Default value is true.

C#
[Parameter]
public bool Enabled { get; set; }

FillMode

Controls the button's visual density and background treatment.

C#
[Parameter]
public string? FillMode { get; set; }
Remarks:

Solid provides a filled background for primary actions. Outline shows only a border for secondary actions. Flat removes background and border for subtle actions. Link styles the button as a hyperlink.

Icon

Displays an icon inside the button using Telerik's built-in icon library or custom icons. When used without ChildContent, creates an icon-only button with specialized styling. Refer to Icons - Documentation for available icons and implementation details. Example: SvgIcon.Save, FontIcon.Plus, or custom icon objects.

C#
[Parameter]
public object? Icon { get; set; }

Id

Sets the unique HTML id attribute for the button element. Useful for CSS targeting and JavaScript selection. Example: "submitButton".

C#
[Parameter]
public virtual string? Id { get; set; }

Rounded

Controls the border radius and corner styling of the button.

C#
[Parameter]
public virtual string? Rounded { get; set; }
Remarks:

Small applies minimal rounding for compact layouts. Medium provides moderate rounding for balanced appearance. Large creates more pronounced rounded corners. Full makes circular buttons, ideal for icon-only buttons.

Size

Determines the button's dimensions including padding, font size, and overall scale.

C#
[Parameter]
public string? Size { get; set; }
Remarks:

Small creates compact buttons for dense layouts. Medium provides standard sizing for most interfaces. Large offers prominent sizing for important actions.

TabIndex

[Accessibility] Sets the keyboard navigation order for the button using the tabindex attribute. When Enabled is false, this automatically becomes -1 regardless of the set value. Default value is 0 (natural tab order).

C#
[Parameter]
public int TabIndex { get; set; }

ThemeColor

Sets the button's color scheme based on semantic meaning and visual hierarchy.

C#
[Parameter]
public virtual string? ThemeColor { get; set; }
Remarks:

Primary highlights the main call-to-action. Secondary indicates important but not primary actions. Success represents positive actions like save or confirm. Warning draws attention to potentially destructive actions. Error clearly marks dangerous operations like delete. Info provides neutral information or help actions. Base offers subtle, low-emphasis styling.

Title

Sets the HTML title attribute which appears as a tooltip when users hover over the button. Example: "Save your changes" or "Delete this item".

C#
[Parameter]
public string? Title { get; set; }
In this article
DefinitionConstructorsButtonBase()PropertiesAriaControlsAriaDescribedByAriaLabelAriaLabelledByChildContentEnabledFillModeIconIdRoundedSizeTabIndexThemeColorTitle
Not finding the help you need?
Contact Support