# rich-text-editor-toolbar

> Rich text editor demonstrates toolbar customization to add, remove, and reorder items.

**Framework:** maui  **Component:** RichTextEditor  **Variant:** toolbar

## Get this item

**If you are an agent, fetch the JSON.** Source is inlined, so one request is enough and no tooling is required:

```
GET https://ai.syncfusion.com/r/maui/rich-text-editor-toolbar.json
```

**Install Package(s)**

```bash
dotnet add package Syncfusion.Maui.RichTextEditor
```

**Notes**

- Syncfusion release: 2026 Volume 3 (v35.1.37)
- The Syncfusion package is licensed. The composition in this file is source you own and edit. See https://ai.syncfusion.com/licensing.md

## Source files

### src/components/rich-text-editor-toolbar/RichTextEditor.xaml

```xaml
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:rte="clr-namespace:Syncfusion.Maui.RichTextEditor;assembly=Syncfusion.Maui.RichTextEditor"
             xmlns:model="clr-namespace:MAUI.Controls.RichTextEditor.Toolbar"
             x:Class="MAUI.Controls.RichTextEditor.Toolbar.RichTextEditorView"
             x:DataType="model:RichTextEditorViewModel"
             Title="Rich Text Editor - Toolbar Collections">
    <Grid Padding="12" ColumnDefinitions="*,320" ColumnSpacing="12">

        <!-- Rich Text Editor -->
        <Border Grid.Column="0"
                Stroke="LightGrey"
                StrokeShape="RoundRectangle 12"
                StrokeThickness="1"
                Padding="0">
            <Grid RowDefinitions="Auto,*">
                <Label Grid.Row="0"
                       Text="RichTextEditor Toolbar Management"
                       FontSize="16"
                       FontAttributes="Bold"
                       Padding="12,10" />
                <rte:SfRichTextEditor x:Name="RichTextEditor"
                                      Grid.Row="1"
                                      TValue="HTML"
                                      Value="{Binding MailContent, Mode=TwoWay}"
                                      ToolbarItems="{Binding ToolbarItems}" />
            </Grid>
        </Border>

        <!-- Control Panel -->
        <Grid Grid.Column="1" RowDefinitions="*,*" RowSpacing="12">

            <!-- Add / Remove Items Section -->
            <Border Grid.Row="0"
                    Stroke="LightGrey"
                    StrokeShape="RoundRectangle 12"
                    StrokeThickness="1"
                    Padding="12">
                <Grid RowDefinitions="Auto,*" RowSpacing="8">
                    <Label Grid.Row="0"
                           Text="Toolbar Item Controls"
                           FontSize="16"
                           FontAttributes="Bold" />
                    <ScrollView Grid.Row="1">
                        <VerticalStackLayout Spacing="6">
                            <Label Text="Add / Remove Toolbar Items:"
                                   FontSize="13"
                                   FontAttributes="Bold" />
                            <Grid ColumnDefinitions="*,*"
                                  RowDefinitions="Auto,Auto,Auto,Auto,Auto,Auto,Auto"
                                  ColumnSpacing="8"
                                  RowSpacing="4">
                                <CheckBox x:Name="ChkStrikethrough" Grid.Row="0" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="0" Grid.Column="0" Text="Strikethrough" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkFontSize" Grid.Row="0" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="0" Grid.Column="1" Text="FontSize" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkSubScript" Grid.Row="1" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="1" Grid.Column="0" Text="SubScript" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkSuperScript" Grid.Row="1" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="1" Grid.Column="1" Text="SuperScript" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkFontFamily" Grid.Row="2" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="2" Grid.Column="0" Text="FontFamily" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkTextColor" Grid.Row="2" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="2" Grid.Column="1" Text="TextColor" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkHighlightColor" Grid.Row="3" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="3" Grid.Column="0" Text="HighlightColor" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkAlignment" Grid.Row="3" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="3" Grid.Column="1" Text="Alignment" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkIncreaseIndent" Grid.Row="4" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="4" Grid.Column="0" Text="IncreaseIndent" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkDecreaseIndent" Grid.Row="4" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="4" Grid.Column="1" Text="DecreaseIndent" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkHyperlink" Grid.Row="5" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="5" Grid.Column="0" Text="Hyperlink" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkImage" Grid.Row="5" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="5" Grid.Column="1" Text="Image" Margin="32,0,0,0" VerticalOptions="Center" />

                                <CheckBox x:Name="ChkTable" Grid.Row="6" Grid.Column="0" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="6" Grid.Column="0" Text="Table" Margin="32,0,0,0" VerticalOptions="Center" />
                                <CheckBox x:Name="ChkUndoRedo" Grid.Row="6" Grid.Column="1" CheckedChanged="OnToolbarItemCheckedChanged" />
                                <Label Grid.Row="6" Grid.Column="1" Text="Undo/Redo" Margin="32,0,0,0" VerticalOptions="Center" />
                            </Grid>
                        </VerticalStackLayout>
                    </ScrollView>
                </Grid>
            </Border>

            <!-- Collection Operations Section -->
            <Border Grid.Row="1"
                    Stroke="LightGrey"
                    StrokeShape="RoundRectangle 12"
                    StrokeThickness="1"
                    Padding="12">
                <ScrollView>
                    <VerticalStackLayout Spacing="12">
                        <Label Text="Collection Operations:"
                               FontSize="14"
                               FontAttributes="Bold" />

                        <Grid ColumnDefinitions="*,*" ColumnSpacing="8">
                            <Button Grid.Column="0"
                                    Text="Clear All Items"
                                    Clicked="OnClearAllClicked"
                                    BackgroundColor="#FF6B6B" />
                            <Button Grid.Column="1"
                                    Text="Reset to Default"
                                    Clicked="OnResetToDefaultClicked"
                                    BackgroundColor="#4ECDC4" />
                        </Grid>

                        <Label x:Name="ItemCountLabel"
                               HorizontalOptions="Center"
                               FontSize="13" />

                        <BoxView HeightRequest="1" Color="LightGray" />

                        <Label Text="Reorder Toolbar Items:"
                               FontSize="14"
                               FontAttributes="Bold" />

                        <Picker x:Name="PickerToolbarItems"
                                Title="Select Item to Move"
                                SelectedIndexChanged="OnPickerSelectedIndexChanged" />

                        <Grid ColumnDefinitions="*,*" ColumnSpacing="8">
                            <Button Grid.Column="0"
                                    x:Name="BtnMoveLeft"
                                    Text="Move Left ←"
                                    Clicked="OnMoveLeftClicked"
                                    IsEnabled="False" />
                            <Button Grid.Column="1"
                                    x:Name="BtnMoveRight"
                                    Text="Move Right →"
                                    Clicked="OnMoveRightClicked"
                                    IsEnabled="False" />
                        </Grid>
                    </VerticalStackLayout>
                </ScrollView>
            </Border>
        </Grid>
    </Grid>
</ContentPage>

```

### src/components/rich-text-editor-toolbar/RichTextEditor.xaml.cs

```cs
using Syncfusion.Maui.RichTextEditor;

namespace MAUI.Controls.RichTextEditor.Toolbar
{
    public partial class RichTextEditorView : ContentPage
    {
        private readonly RichTextEditorViewModel viewModel;

        public RichTextEditorView(RichTextEditorViewModel viewModel)
        {
            InitializeComponent();
            this.viewModel = viewModel;
            BindingContext = viewModel;
            UpdateItemCount();
            UpdatePickerItems();
        }

        /// <summary>
        /// Handles checkbox state changes to add or remove toolbar items.
        /// </summary>
        private void OnToolbarItemCheckedChanged(object? sender, CheckedChangedEventArgs e)
        {
            if (sender is not CheckBox checkBox)
                return;

            RichTextToolbarOptions itemType = GetItemType(checkBox);

            if (e.Value)
            {
                if (checkBox == ChkUndoRedo)
                {
                    AddToolbarItem(RichTextToolbarOptions.Undo);
                    AddToolbarItem(RichTextToolbarOptions.Redo);
                }
                else
                {
                    AddToolbarItem(itemType);
                }
            }
            else
            {
                if (checkBox == ChkUndoRedo)
                {
                    RemoveToolbarItem(RichTextToolbarOptions.Undo);
                    RemoveToolbarItem(RichTextToolbarOptions.Redo);
                }
                else
                {
                    RemoveToolbarItem(itemType);
                }
            }

            UpdateItemCount();
            UpdatePickerItems();
        }

        private RichTextToolbarOptions GetItemType(CheckBox checkBox) => checkBox switch
        {
            var c when c == ChkStrikethrough => RichTextToolbarOptions.Strikethrough,
            var c when c == ChkSubScript => RichTextToolbarOptions.SubScript,
            var c when c == ChkSuperScript => RichTextToolbarOptions.SuperScript,
            var c when c == ChkFontFamily => RichTextToolbarOptions.FontFamily,
            var c when c == ChkFontSize => RichTextToolbarOptions.FontSize,
            var c when c == ChkTextColor => RichTextToolbarOptions.TextColor,
            var c when c == ChkHighlightColor => RichTextToolbarOptions.HighlightColor,
            var c when c == ChkAlignment => RichTextToolbarOptions.Alignment,
            var c when c == ChkIncreaseIndent => RichTextToolbarOptions.IncreaseIndent,
            var c when c == ChkDecreaseIndent => RichTextToolbarOptions.DecreaseIndent,
            var c when c == ChkHyperlink => RichTextToolbarOptions.Hyperlink,
            var c when c == ChkImage => RichTextToolbarOptions.Image,
            var c when c == ChkTable => RichTextToolbarOptions.Table,
            _ => RichTextToolbarOptions.Bold
        };

        /// <summary>
        /// Adds a toolbar item to the collection.
        /// </summary>
        private void AddToolbarItem(RichTextToolbarOptions itemType)
        {
            if (!viewModel.ToolbarItems.Any(item => item.Type == itemType))
            {
                viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = itemType });
            }
        }

        /// <summary>
        /// Removes a toolbar item from the collection.
        /// </summary>
        private void RemoveToolbarItem(RichTextToolbarOptions itemType)
        {
            var itemToRemove = viewModel.ToolbarItems.FirstOrDefault(item => item.Type == itemType);
            if (itemToRemove != null)
            {
                viewModel.ToolbarItems.Remove(itemToRemove);
            }
        }

        /// <summary>
        /// Clears all toolbar items and unchecks every checkbox.
        /// </summary>
        private void OnClearAllClicked(object? sender, EventArgs e)
        {
            viewModel.ToolbarItems.Clear();

            ChkStrikethrough.IsChecked = false;
            ChkSubScript.IsChecked = false;
            ChkSuperScript.IsChecked = false;
            ChkFontFamily.IsChecked = false;
            ChkFontSize.IsChecked = false;
            ChkTextColor.IsChecked = false;
            ChkHighlightColor.IsChecked = false;
            ChkAlignment.IsChecked = false;
            ChkIncreaseIndent.IsChecked = false;
            ChkDecreaseIndent.IsChecked = false;
            ChkHyperlink.IsChecked = false;
            ChkImage.IsChecked = false;
            ChkTable.IsChecked = false;
            ChkUndoRedo.IsChecked = false;

            UpdateItemCount();
            UpdatePickerItems();
        }

        /// <summary>
        /// Resets the toolbar back to the default set of items.
        /// </summary>
        private void OnResetToDefaultClicked(object? sender, EventArgs e)
        {
            viewModel.ToolbarItems.Clear();

            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.Bold });
            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.Italic });
            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.Underline });
            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.Separator });
            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.NumberList });
            viewModel.ToolbarItems.Add(new RichTextToolbarItem { Type = RichTextToolbarOptions.BulletList });

            ChkStrikethrough.IsChecked = false;
            ChkSubScript.IsChecked = false;
            ChkSuperScript.IsChecked = false;
            ChkFontFamily.IsChecked = false;
            ChkFontSize.IsChecked = false;
            ChkTextColor.IsChecked = false;
            ChkHighlightColor.IsChecked = false;
            ChkAlignment.IsChecked = false;
            ChkIncreaseIndent.IsChecked = false;
            ChkDecreaseIndent.IsChecked = false;
            ChkHyperlink.IsChecked = false;
            ChkImage.IsChecked = false;
            ChkTable.IsChecked = false;
            ChkUndoRedo.IsChecked = false;

            UpdateItemCount();
            UpdatePickerItems();
        }

        /// <summary>
        /// Updates the item count label.
        /// </summary>
        private void UpdateItemCount()
        {
            ItemCountLabel.Text = $"Current Item Count: {viewModel.ToolbarItems.Count}";
        }

        /// <summary>
        /// Refreshes the picker with the current toolbar items.
        /// </summary>
        private void UpdatePickerItems()
        {
            PickerToolbarItems.Items.Clear();

            for (int i = 0; i < viewModel.ToolbarItems.Count; i++)
            {
                var item = viewModel.ToolbarItems[i];
                PickerToolbarItems.Items.Add($"{i + 1}. {item.Type}");
            }

            if (PickerToolbarItems.Items.Count > 0)
            {
                PickerToolbarItems.SelectedIndex = -1;
            }

            BtnMoveLeft.IsEnabled = false;
            BtnMoveRight.IsEnabled = false;
        }

        /// <summary>
        /// Enables / disables the move buttons based on the selected index.
        /// </summary>
        private void OnPickerSelectedIndexChanged(object? sender, EventArgs e)
        {
            if (PickerToolbarItems.SelectedIndex >= 0)
            {
                BtnMoveLeft.IsEnabled = PickerToolbarItems.SelectedIndex > 0;
                BtnMoveRight.IsEnabled = PickerToolbarItems.SelectedIndex < viewModel.ToolbarItems.Count - 1;
            }
            else
            {
                BtnMoveLeft.IsEnabled = false;
                BtnMoveRight.IsEnabled = false;
            }
        }

        /// <summary>
        /// Moves the selected toolbar item one position to the left.
        /// </summary>
        private void OnMoveLeftClicked(object? sender, EventArgs e)
        {
            int selectedIndex = PickerToolbarItems.SelectedIndex;

            if (selectedIndex > 0)
            {
                var item = viewModel.ToolbarItems[selectedIndex];
                viewModel.ToolbarItems.RemoveAt(selectedIndex);
                viewModel.ToolbarItems.Insert(selectedIndex - 1, item);

                UpdatePickerItems();
                PickerToolbarItems.SelectedIndex = selectedIndex - 1;
            }
        }

        /// <summary>
        /// Moves the selected toolbar item one position to the right.
        /// </summary>
        private void OnMoveRightClicked(object? sender, EventArgs e)
        {
            int selectedIndex = PickerToolbarItems.SelectedIndex;

            if (selectedIndex >= 0 && selectedIndex < viewModel.ToolbarItems.Count - 1)
            {
                var item = viewModel.ToolbarItems[selectedIndex];
                viewModel.ToolbarItems.RemoveAt(selectedIndex);
                viewModel.ToolbarItems.Insert(selectedIndex + 1, item);

                UpdatePickerItems();
                PickerToolbarItems.SelectedIndex = selectedIndex + 1;
            }
        }
    }
}

```
