Implementing Toolbar in .NET MAUI
Guide users on implementing the Syncfusion .NET MAUI Toolbar (SfToolbar) control - a customizable UI component that provides quick access to actions or commands through buttons, icons, or menus.
When to Use This Skill
Use this skill when users need to:
- Add a toolbar to their .NET MAUI application for quick access to commands
- Configure toolbar items with icons, text, or custom views
- Implement text formatting toolbars (bold, italic, underline, alignment)
- Create document editing toolbars with overflow handling
- Add navigation toolbars with horizontal or vertical layouts
- Configure selection modes (single, multiple, toggle)
- Handle toolbar events (taps, selections, interactions)
- Customize toolbar appearance (colors, styles, corner radius)
- Implement overlay toolbars for contextual actions
- Apply modern glass effects to toolbars
- Support keyboard navigation in toolbars
- Add tooltips to toolbar items
Component Overview
The Syncfusion .NET MAUI Toolbar (SfToolbar) is a feature-rich control that offers:
- Flexible item display: Icons, text, or custom views
- Multiple orientations: Horizontal and vertical layouts
- Overflow handling: Scroll, navigation buttons, more button, multi-row, extended row
- Selection modes: Single, single deselect, multiple selection
- Rich customization: Colors, styles, fonts, corner radius
- Event support: Taps, long press, touch interactions, selection changes
- Overlay toolbars: Contextual toolbars that appear on demand
- Modern effects: Liquid glass effect for sleek UI
- Accessibility: Tooltips, keyboard navigation, ARIA support
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
When to read: Installation, first-time setup, basic toolbar implementation
Topics covered:
- Installing Syncfusion.Maui.Toolbar NuGet package
- Registering Syncfusion core handler in MauiProgram.cs
- Creating your first toolbar with XAML and C#
- Adding basic toolbar items
- Configuring icons with FontImageSource
- Material icons font setup
Toolbar Items and Display
📄 Read: references/toolbar-items.md
When to read: Configuring toolbar items, icons, text, custom views, separators, alignment
Topics covered:
- Icon-only toolbar items
- Text-only toolbar items
- Icon with text combinations
- Icon sizing and text positioning
- Custom item views (buttons, checkboxes, entries)
- Separator items for visual organization
- Item sizing and spacing
- Leading, trailing, and center alignment
- Equal spacing configuration
- Clear selection programmatically
- Item naming for identification
Layout and Overflow
📄 Read: references/layout-and-overflow.md
When to read: Setting toolbar orientation, handling overflow items, configuring scroll/navigation modes
Topics covered:
- Horizontal toolbar layout
- Vertical toolbar layout
- Scroll mode for overflow items
- Navigation buttons for stepping through items
- More button with dropdown menu
- More button positioning (auto, left, right, top, bottom)
- Multi-row support for wrapping items
- Extended row with expand/collapse button
- Canceling default dropdown view
- Width and height considerations
Selection and Interaction
📄 Read: references/selection-and-interaction.md
When to read: Configuring selection behavior, enabling tooltips, handling user interactions
Topics covered:
- Single selection mode
- Single deselect mode (toggle selection)
- Multiple selection mode
- Enabling and disabling toolbar items
- Tooltip text configuration
- Tooltip customization (background, text style, position)
- Keyboard navigation support
- IsEnabled state management
- User interaction patterns
Events and Commands
📄 Read: references/events-and-commands.md
When to read: Handling toolbar events, implementing MVVM commands, responding to user actions
Topics covered:
- Tapped event and TappedCommand
- ItemTouchInteraction event for pointer actions
- ItemLongPressed event for long press gestures
- MoreButtonTapped event for overflow button
- MoreItemsChanged event for overflow items
- SelectionChanged event for selection tracking
- MVVM command patterns with ViewModel integration
- Event arguments and parameters
- Command execution and CanExecute
Customization
📄 Read: references/customization.md
When to read: Styling toolbar items, customizing buttons, changing colors, applying corner radius
Topics covered:
- Toolbar item customization (IsEnabled, TextStyle, Color)
- SelectionHighlightColor for selected items
- Separator customization (stroke color, thickness)
- Navigation button customization (colors, backgrounds)
- Navigation button DataTemplate customization
- More button customization (icon color, background)
- Divider line customization
- Toolbar corner radius
- Selection corner radius for selected items
- Theme integration
Advanced Features
📄 Read: references/advanced-features.md
When to read: Implementing overlay toolbars, applying glass effects, advanced styling
Topics covered:
- Overlay toolbar implementation
- Back icon customization in overlay
- BackIconAlignment (Start/End positioning)
- BackIconTemplate for custom back icons
- BackIconToolTipText configuration
- Liquid glass effect setup
- Transparent background for glass effect
- Toolbar grouping layout with glass effect
- Group spacing with separator stroke thickness
- Platform support (macOS 26+, iOS 26+, .NET 10)
1---2name: syncfusion-maui-toolbar3description: Implements Syncfusion .NET MAUI Toolbar (SfToolbar) for navigation bars and command bars. Use when working with toolbars, toolbar items, navigation bars, toolbar buttons, or action toolbars in .NET MAUI applications. This skill covers toolbar item configuration, icons, text, overflow behavior, orientation, selection modes, and toolbar customization.4---5
6# Implementing Toolbar in .NET MAUI
7
8Guide users on implementing the Syncfusion .NET MAUI Toolbar (SfToolbar) control - a customizable UI component that provides quick access to actions or commands through buttons, icons, or menus.
9
10## When to Use This Skill
11
12Use this skill when users need to:
13
14- **Add a toolbar** to their .NET MAUI application for quick access to commands
15- **Configure toolbar items** with icons, text, or custom views
16- **Implement text formatting toolbars** (bold, italic, underline, alignment)
17- **Create document editing toolbars** with overflow handling
18- **Add navigation toolbars** with horizontal or vertical layouts
19- **Configure selection modes** (single, multiple, toggle)
20- **Handle toolbar events** (taps, selections, interactions)
21- **Customize toolbar appearance** (colors, styles, corner radius)
22- **Implement overlay toolbars** for contextual actions
23- **Apply modern glass effects** to toolbars
24- **Support keyboard navigation** in toolbars
25- **Add tooltips** to toolbar items
26
27## Component Overview
28
29The Syncfusion .NET MAUI Toolbar (SfToolbar) is a feature-rich control that offers:
30
31- **Flexible item display**: Icons, text, or custom views
32- **Multiple orientations**: Horizontal and vertical layouts
33- **Overflow handling**: Scroll, navigation buttons, more button, multi-row, extended row
34- **Selection modes**: Single, single deselect, multiple selection
35- **Rich customization**: Colors, styles, fonts, corner radius
36- **Event support**: Taps, long press, touch interactions, selection changes
37- **Overlay toolbars**: Contextual toolbars that appear on demand
38- **Modern effects**: Liquid glass effect for sleek UI
39- **Accessibility**: Tooltips, keyboard navigation, ARIA support
40
41## Documentation and Navigation Guide
42
43### Getting Started
44📄 **Read:** [references/getting-started.md](references/getting-started.md)
45
46**When to read:** Installation, first-time setup, basic toolbar implementation
47
48Topics covered:
49- Installing Syncfusion.Maui.Toolbar NuGet package
50- Registering Syncfusion core handler in MauiProgram.cs
51- Creating your first toolbar with XAML and C#
52- Adding basic toolbar items
53- Configuring icons with FontImageSource
54- Material icons font setup
55
56### Toolbar Items and Display
57📄 **Read:** [references/toolbar-items.md](references/toolbar-items.md)
58
59**When to read:** Configuring toolbar items, icons, text, custom views, separators, alignment
60
61Topics covered:
62- Icon-only toolbar items
63- Text-only toolbar items
64- Icon with text combinations
65- Icon sizing and text positioning
66- Custom item views (buttons, checkboxes, entries)
67- Separator items for visual organization
68- Item sizing and spacing
69- Leading, trailing, and center alignment
70- Equal spacing configuration
71- Clear selection programmatically
72- Item naming for identification
73
74### Layout and Overflow
75📄 **Read:** [references/layout-and-overflow.md](references/layout-and-overflow.md)
76
77**When to read:** Setting toolbar orientation, handling overflow items, configuring scroll/navigation modes
78
79Topics covered:
80- Horizontal toolbar layout
81- Vertical toolbar layout
82- Scroll mode for overflow items
83- Navigation buttons for stepping through items
84- More button with dropdown menu
85- More button positioning (auto, left, right, top, bottom)
86- Multi-row support for wrapping items
87- Extended row with expand/collapse button
88- Canceling default dropdown view
89- Width and height considerations
90
91### Selection and Interaction
92📄 **Read:** [references/selection-and-interaction.md](references/selection-and-interaction.md)
93
94**When to read:** Configuring selection behavior, enabling tooltips, handling user interactions
95
96Topics covered:
97- Single selection mode
98- Single deselect mode (toggle selection)
99- Multiple selection mode
100- Enabling and disabling toolbar items
101- Tooltip text configuration
102- Tooltip customization (background, text style, position)
103- Keyboard navigation support
104- IsEnabled state management
105- User interaction patterns
106
107### Events and Commands
108📄 **Read:** [references/events-and-commands.md](references/events-and-commands.md)
109
110**When to read:** Handling toolbar events, implementing MVVM commands, responding to user actions
111
112Topics covered:
113- Tapped event and TappedCommand
114- ItemTouchInteraction event for pointer actions
115- ItemLongPressed event for long press gestures
116- MoreButtonTapped event for overflow button
117- MoreItemsChanged event for overflow items
118- SelectionChanged event for selection tracking
119- MVVM command patterns with ViewModel integration
120- Event arguments and parameters
121- Command execution and CanExecute
122
123### Customization
124📄 **Read:** [references/customization.md](references/customization.md)
125
126**When to read:** Styling toolbar items, customizing buttons, changing colors, applying corner radius
127
128Topics covered:
129- Toolbar item customization (IsEnabled, TextStyle, Color)
130- SelectionHighlightColor for selected items
131- Separator customization (stroke color, thickness)
132- Navigation button customization (colors, backgrounds)
133- Navigation button DataTemplate customization
134- More button customization (icon color, background)
135- Divider line customization
136- Toolbar corner radius
137- Selection corner radius for selected items
138- Theme integration
139
140### Advanced Features
141📄 **Read:** [references/advanced-features.md](references/advanced-features.md)
142
143**When to read:** Implementing overlay toolbars, applying glass effects, advanced styling
144
145Topics covered:
146- Overlay toolbar implementation
147- Back icon customization in overlay
148- BackIconAlignment (Start/End positioning)
149- BackIconTemplate for custom back icons
150- BackIconToolTipText configuration
151- Liquid glass effect setup
152- Transparent background for glass effect
153- Toolbar grouping layout with glass effect
154- Group spacing with separator stroke thickness
155- Platform support (macOS 26+, iOS 26+, .NET 10)
156
gabrielmoreira