Blazor Editor - Toolbar

Editor Toolbar

Setup The Blazor Application

Follow the Getting Started guide to set up your Blazor Application with Smart UI.

Setup the Blazor Smart.Editor

Follow the Get Started with Smart.Editor guide to set up the component.

Toolbar

Smart.Editor has a Toolbar that contains command button items that when clicked execute an action.
Actions can insert/delete content or apply various styles and formatting to the current text selection as well as creating lists, tables, inserting images and so on.
You can also define custom toolbar items.

There are two types of Toolbars inside the Editor:

  • Toolbar - the main toolbar of the Editor. Always visible and positioned right above the content section.
    Toolbar
  • Inline Toolbar - an additional toolbar that appears when text is selected or a specific text or node is clicked, for example: text, link, image, table.
    The inline toolbar main purpose is for Images and Tables where it offers additional actions to be applied to the selection target.
    Toolbar inline
    You can read more about it in the Editor Inline Toolbar Guide.

Smart.Editor allows you to customize the tools displayed to the user in the Toolbar.
To do that you need to use the ToolbarItems property of the Editor. It is of type IEnumerable<IEditorToolbarItem> where the toolbar items can be chosen from the default ones, modified or new custom items.
You can read in details about them in the Editor Toolbar Items Guide.

Editor Toolbar View Mode

Editor's Toolbar can display the items as a drop down, a scrollable container or on multiple levels. This is determined by the ToolbarViewMode property. By default the toolbar's view mode is toggle.
The available values for ToolbarViewMode are:

  • Toggle - The Toolbar can be toggled in order to display the additional items.
    <Editor ToolbarItems="@items" ToolbarViewMode="ToolbarViewMode.Toggle" />
    Toolbar View Mode Toggle
  • MultiRow - The Toolbar items are positioned on multiple levels depending on the space available.
    <Editor ToolbarItems="@items" ToolbarViewMode="ToolbarViewMode.MultiRow" />
    Toolbar View Mode MultiRow
  • Scroll - The Toolbar represent a scrollable contain and the user can scroll through the items via a scroll bar.
    <Editor ToolbarItems="@items" ToolbarViewMode="ToolbarViewMode.Scroll" />
    Toolbar View Mode Scroll

Editor Toolbar Sticky

When the height of the Editor is bigger than the page viewport size the toolbar might not be visible when the user has scrolled to the bottom.
The ToolbarSticky(bool) property allows to make the Toolbar stick to the top of the page regardless of the scroll top position. That way the toolbar items are easy to reach at any time.
<Editor ToolbarItems="@items" ToolbarSticky />
Toolbar Sticky