Imported from syncfusion/blazor-ui-components-skills (skills/syncfusion-blazor-buttons/SKILL.md). Install upstream with npx skills add syncfusion/blazor-ui-components-skills --skill syncfusion-blazor-buttons. Copyright stays with the author.

Syncfusion Blazor Buttons Components

Name: syncfusion-blazor-buttons
Author: syncfusion

When to Use This Skill
Components Overview
Common Setup and Installation
Documentation and Navigation Guide
Common Patterns Across Components
Shared Configuration
Common Use Cases

Components Overview

The Syncfusion.Blazor.Buttons package provides 11 comprehensive button components:

Core Buttons

Button (SfButton) - Standard button with multiple types, styles, icons, and states
ButtonGroup (SfButtonGroup) - Grouped button controls with selection modes
CheckBox (SfCheckBox) - Tri-state checkbox with checked, unchecked, and indeterminate states
RadioButton (SfRadioButton) - Radio button for mutually exclusive selections
ToggleSwitch (SfSwitch) - On/off toggle switch control

Interactive Buttons

DropdownMenu (SfDropDownButton) - Button with dropdown menu options
SplitButton (SfSplitButton) - Button with primary action and dropdown menu
ProgressButton (SfProgressButton) - Button with built-in progress indication

Floating Actions

FloatingActionButton (SfFab) - Circular floating action button
SpeedDial (SfSpeedDial) - FAB with expandable action items (linear/radial)

Chip Components

Chip (SfChip) - Compact elements for tags, filters, selections, and actions

Package: Syncfusion.Blazor.Buttons and Syncfusion.Blazor.SplitButtons

Common Setup and Installation

All button components share the same installation and setup process:

NuGet Packages

Install the required packages based on component type:

# For Button, Chip, FAB, ToggleSwitch
dotnet add package Syncfusion.Blazor.Buttons

# For DropdownMenu, SplitButton, ProgressButton, ButtonGroup, SpeedDial
dotnet add package Syncfusion.Blazor.SplitButtons

# Required theme package
dotnet add package Syncfusion.Blazor.Themes

Setup Steps (Common for All)

1. Add Namespaces (~/_Imports.razor):

@using Syncfusion.Blazor
@using Syncfusion.Blazor.Buttons
@using Syncfusion.Blazor.SplitButtons

2. Register Service (~/Program.cs):

using Syncfusion.Blazor;
builder.Services.AddSyncfusionBlazor();

3. Add Theme and Script (~/index.html or ~/App.razor):

<head>
    <link href="_content/Syncfusion.Blazor.Themes/bootstrap5.css" rel="stylesheet" />
    <script src="_content/Syncfusion.Blazor.Core/scripts/syncfusion-blazor.min.js"></script>
</head>

Documentation and Navigation Guide

Button Component

📄 Read: references/button-features.md

Getting started and installation
Basic button implementation
Button types (flat, outline, round, primary, toggle)
Button styles (primary, success, info, warning, danger, link)
Icons and icon positioning
Button sizes (small, normal)
Repeat buttons
Tooltips
HTML attribute support
Native event handling

📄 Read: references/button-styling.md

CSS class customization
Appearance customization
Block buttons
Rounded corners
RTL (right-to-left) support
Theme integration
Color schemes and variations
Responsive design patterns

📄 Read: references/button-advanced-features.md

Accessibility (WCAG compliance, keyboard navigation, ARIA attributes)
Screen reader support
Disabled state handling
Toggle button functionality
Server vs Web App implementation differences
Performance optimization
Best practices and common pitfalls

RadioButton Component

📄 Read: references/radio-button-features.md

Getting started and installation
Basic radio button implementation
Radio button grouping with Name property
Label configuration and positioning
State and value management
Two-way data binding (@bind-Checked)
Value property for identification
Pre-selecting default values
Form integration patterns

📄 Read: references/radio-button-styling.md

CssClass for custom styling
HtmlAttributes dictionary usage
EnableRtl for right-to-left layouts
Disabled state configuration
EnablePersistence for state storage
Custom CSS class patterns
Theme customization techniques
Responsive design approaches

📄 Read: references/radio-button-advanced-features.md

ValueChange event handler
ChangeArgs event data structure
CheckedChanged callback implementation
Created lifecycle event
Event handling patterns
ARIA attributes for accessibility
Keyboard navigation support
Best practices and common patterns

CheckBox Component

📄 Read: references/checkbox-features.md

Getting started and installation
Basic checkbox implementation
Checkbox states (checked, unchecked, disabled)
Label configuration
Change event handling
Two-way data binding (@bind-Checked)
Multiple checkboxes and checkbox groups
Indeterminate (tristate) state

📄 Read: references/checkbox-styling.md

CSS class customization
Appearance customization
Theme integration (Bootstrap5, Material, Fabric, Tailwind)
Color variations (primary, success, warning, danger)
Size customization
RTL (right-to-left) support
Disabled appearance
Label styling and spacing

📄 Read: references/checkbox-advanced-features.md

Disabled state handling and conditional disabling
Accessibility (WCAG, ARIA attributes, screen readers)
Keyboard navigation (Tab, Space)
Form integration and validation
State management patterns
Best practices and common patterns

Button Group Component

📄 Read: references/button-group-features.md

Getting started and installation
Basic button group implementation
Horizontal and vertical orientation
Selection modes (single, multiple, none)
Nesting button groups
Native event handling
Item configuration and data binding

📄 Read: references/button-group-styling.md

Appearance customization
Button types and styles within groups
Icons in button groups
Size variations
Custom CSS classes
Theme integration

📄 Read: references/button-group-advanced-features.md

Accessibility features
Keyboard navigation
Selection state management
Event handling patterns
Best practices for button groups

Chip Component

📄 Read: references/chip-features.md

Getting started and installation
Basic chip implementation
Chip types (input, filter, choice, action)
Icon integration
Delete functionality
Selection handling
Events (click, delete, created, beforeItemRender)
Dynamic chip collections
Rendering from data sources

📄 Read: references/chip-styling.md

Appearance customization
Color variations
Size options
Custom CSS classes
Icon and avatar styling
Theme integration
Responsive design

📄 Read: references/chip-advanced-features.md

Accessibility support
Keyboard navigation
Custom template support
State management patterns
Event handling
Best practices

Dropdown Menu Component

📄 Read: references/dropdown-menu-features.md

Getting started and installation
Basic dropdown menu implementation
Popup items configuration (text, ID, icon, separator)
Icons in menu items
Item click events
Opening and closing behavior
Position customization
Dynamically adding/removing items
Grouped popups with ListView integration
Dialog opening on item click
DropdownList vs DropdownButton comparison

📄 Read: references/dropdown-menu-styling.md

Appearance customization
Caret icon customization
Hiding dropdown arrow
Icon and width customization
Popup width customization
Rounded corners
RTL support
Animation effects
Template customization
Theme integration

📄 Read: references/dropdown-menu-advanced-features.md

Accessibility features
Disabled state handling
Native event handling
Keyboard navigation
Focus management
Best practices and patterns

Floating Action Button (FAB) Component

📄 Read: references/fab-features.md

Getting started and installation
Basic FAB implementation
Position options (TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight)
Icons configuration
Content customization
Target element binding
Click event handling
Show/hide behavior
Visibility control

📄 Read: references/fab-styling.md

Appearance styles (primary, success, info, warning, danger)
Size variations (small, medium, large)
Icon positioning
Color customization
CSS class customization
Disabled appearance
Theme integration

📄 Read: references/fab-advanced-features.md

Accessibility support
Keyboard navigation
Event handling patterns
State management
Best practices for FAB usage

Progress Button Component

📄 Read: references/progress-button-features.md

Getting started and installation
Basic progress button implementation
Spinner types and positions (left, right, top, bottom, center)
Progress states (Begin, Progress, End, Fail)
Duration configuration
Content customization during progress
Events (OnBegin, Progress, End, Fail)
Stopping progress programmatically
Hiding spinner
Progress tracking

📄 Read: references/progress-button-styling.md

Appearance customization
Button types and icons
CSS class customization for progress states
Progress indicator styling
Spinner customization
Content changes during progress
Theme integration

📄 Read: references/progress-button-advanced-features.md

Accessibility features
Trace events for debugging
Native event handling
State management patterns
Error handling
Best practices for progress buttons

Speed Dial Component

📄 Read: references/speeddial-features.md

Getting started and installation
Basic SpeedDial implementation
Display modes (Linear, Radial)
Action items configuration
Position options (9 positions)
Open and close behavior
Item click events
Open modes (Hover, Click)
Direction options (Up, Down, Left, Right, Auto)
Radial settings (offset, direction, startAngle, endAngle)
Icon configuration (open/close icons)

📄 Read: references/speeddial-styling.md

Appearance customization
Icons (open icon, close icon, item icons)
Color variations
Item templates
CSS class customization
Animation effects
Theme integration

📄 Read: references/speeddial-advanced-features.md

Accessibility support
Keyboard navigation
Event handling (all events)
State management patterns
Modal backdrop
Best practices

Split Button Component

📄 Read: references/split-button-features.md

Getting started and installation
Basic split button implementation
Dropdown menu items configuration
Primary button action
Item selection events
Icons in items
Separator support
Opening and closing behavior
Event handling

📄 Read: references/split-button-styling.md

Appearance customization
Button styles
Icons and icon positioning
Size variations
Custom CSS classes
RTL support
Theme integration

📄 Read: references/split-button-advanced-features.md

Accessibility features
Disabled state handling
Keyboard navigation
Native event handling
Best practices

Toggle Switch Component

📄 Read: references/toggle-switch-features.md

Getting started and installation
Basic toggle switch implementation
Checked and unchecked states
Two-way data binding (@bind-Checked)
On/Off label configuration
Change events
Value binding
Name attribute for forms
Default state configuration

📄 Read: references/toggle-switch-styling.md

Appearance customization
Size variations
Label customization (OnLabel, OffLabel)
Color schemes
Custom CSS classes
RTL support
Material theme considerations (no text support)
Theme integration

📄 Read: references/toggle-switch-advanced-features.md

Accessibility support
Keyboard navigation
Disabled state handling
Form integration
State management patterns
Best practices

Common Patterns Across Components

Event Handling Pattern

All button components support standard Blazor event handling:

<SfButton OnClick="HandleClick">Click Me</SfButton>

@code {
    private void HandleClick()
    {
        // Handle button click
    }
}

Styling Pattern

All components support CSS class customization:

<SfButton CssClass="e-primary custom-button">Styled Button</SfButton>

Icon Integration Pattern

Most components support icon CSS classes:

<SfButton IconCss="e-icons e-plus-icon">Add Item</SfButton>

Disabled State Pattern

All interactive components support disabled state:

<SfButton Disabled="@isDisabled">Button</SfButton>

RTL Support Pattern

All components support right-to-left rendering:

<SfButton EnableRtl="true">RTL Button</SfButton>

Shared Configuration

Theme Options

All button components support Syncfusion themes:

Bootstrap5 (default): bootstrap5.css
Material: material.css
Fabric: fabric.css
Tailwind: tailwind.css
Fluent: fluent.css

Common CSS Classes

Standard CSS utility classes work across components:

e-primary: Primary action styling
e-success: Success/positive action
e-info: Informational action
e-warning: Warning/caution action
e-danger: Danger/negative action
e-link: Hyperlink styling
e-small: Small size variant
e-flat: Flat style (no background)
e-outline: Outline style (border only)
e-round: Circular/rounded style

Accessibility Features

All components include:

ARIA attributes
Keyboard navigation support
Screen reader compatibility
Focus indicators
WCAG 2.1 compliance

Common Use Cases

Standard Actions

Use Button for primary, secondary, and tertiary actions in forms, dialogs, and pages.

Multi-Selection

Use CheckBox for multiple independent selections, list items, and preferences.

Exclusive Selection

Use RadioButton for single selection from multiple options, preferences, settings, and survey questions.

Grouped Actions

Use ButtonGroup for related actions like text alignment, view modes, or filter options.

Tags and Filters

Use Chip for tags, contact lists, filter selections, and removable items.

Menu Actions

Use DropdownMenu for contextual menus with multiple options.

Dual Actions

Use SplitButton when you need a primary action with additional options.

Long Operations

Use ProgressButton for operations that take time (file upload, form submission, API calls).

Primary Page Actions

Use FloatingActionButton for the primary action on mobile or dashboard pages.

Multiple Quick Actions

Use SpeedDial when you need multiple related actions accessible from a single FAB.

On/Off States

Use ToggleSwitch for binary settings, feature toggles, and preferences.

Quick Start Examples

Basic Button

<SfButton CssClass="e-primary">Primary Action</SfButton>

Basic CheckBox

<SfCheckBox TChecked="bool" Label="Accept Terms"></SfCheckBox>

CheckBox with Two-Way Binding

<SfCheckBox @bind-Checked="isEnabled" Label="Enable Feature"></SfCheckBox>

@code {
    private bool isEnabled = false;
}

Multiple Checkboxes

<SfCheckBox TChecked="bool"  Label="Option 1"></SfCheckBox>
<SfCheckBox TChecked="bool" Label="Option 2"></SfCheckBox>
<SfCheckBox TChecked="bool" Label="Option 3"></SfCheckBox>

Tristate CheckBox

<SfCheckBox EnableTriState="true" Checked="null" Label="Select All" TChecked="bool?"></SfCheckBox>

Basic RadioButton

<SfRadioButton Label="Option 1" Name="group" Value="option1" @bind-Checked="@selected"></SfRadioButton>
<SfRadioButton Label="Option 2" Name="group" Value="option2" @bind-Checked="@selected"></SfRadioButton>
<SfRadioButton Label="Option 3" Name="group" Value="option3" @bind-Checked="@selected"></SfRadioButton>

@code {
    private string selected = "option1";
}

RadioButton Group

<h4>Choose Your Plan</h4>
<SfRadioButton Label="Free" Name="plan" Value="free" @bind-Checked="@plan"></SfRadioButton>
<SfRadioButton Label="Pro" Name="plan" Value="pro" @bind-Checked="@plan"></SfRadioButton>
<SfRadioButton Label="Enterprise" Name="plan" Value="enterprise" @bind-Checked="@plan"></SfRadioButton>

@code {
    private string plan = "free";
}

Button with Icon

<SfButton IconCss="e-icons e-plus-icon" CssClass="e-primary">
    Add New
</SfButton>

Toggle Switch

<SfSwitch @bind-Checked="isEnabled" OnLabel="On" OffLabel="Off"></SfSwitch>

@code {
    private bool isEnabled = true;
}

Dropdown Menu

<SfDropDownButton Content="Actions">
    <DropDownMenuItems>
        <DropDownMenuItem Text="Edit"></DropDownMenuItem>
        <DropDownMenuItem Text="Delete"></DropDownMenuItem>
    </DropDownMenuItems>
</SfDropDownButton>

Floating Action Button

<div id="target" style="min-height:200px; position:relative;">
    <SfFab Target="#target" IconCss="e-icons e-plus" Content="Add"></SfFab>
</div>

Chip Collection

<SfChip EnableDelete="true">
    <ChipItems>
        <ChipItem Text="Tag 1"></ChipItem>
        <ChipItem Text="Tag 2"></ChipItem>
        <ChipItem Text="Tag 3"></ChipItem>
    </ChipItems>
</SfChip>

Navigation Tips

For installation and basic setup, refer to any component's features file
For styling and appearance, refer to the styling files for each component
For accessibility and advanced features, refer to the advanced-features files
For specific component features, navigate to that component's documentation sections above

Support and Resources

Official Demos: https://blazor.syncfusion.com/demos/buttons/
API Documentation: https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Buttons.html
GitHub Examples: https://github.com/SyncfusionExamples/Blazor-Getting-Started-Examples/
System Requirements: https://blazor.syncfusion.com/documentation/system-requirements
Licensing: Commercial license required for production use

Remember: Always start with the appropriate component's features file for implementation guidance, then move to styling and advanced features as needed.

About