Skip to content

Commit b0f0125

Browse files
authored
Merge pull request #6876 from syncfusion-content/985007-checklist-D
985007: UG documentation for Checklist feature in the Rich Text Editor - Blazor
2 parents 1e9434e + 7132cc9 commit b0f0125

File tree

2 files changed

+37
-0
lines changed

2 files changed

+37
-0
lines changed
49.1 KB
Loading

blazor/rich-text-editor/tools/styling-tools.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -459,6 +459,43 @@ This feature allows users to change the appearance of the numbered and bulleted
459459

460460
<!-- {% previewsample "https://blazorplayground.syncfusion.com/embed/hZrgDQihUWLCLrIB?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %} -->
461461

462+
### Checklist
463+
464+
The `Checklist` feature lets you create interactive task lists with clickable checkboxes. You can configure checkbox behavior, customize the visual appearance, manage item states, and enable keyboard interactions. This makes it perfect for project management, note-taking, and task tracking within your content. You can easily toggle between checked and unchecked states, giving you an intuitive way to manage the completion status of your list items—making it a simple and effective to-do list solution.
465+
466+
#### Inserting a checklist
467+
You can embed interactive task lists directly within the Rich Text Editor. Here’s how you can insert a checklist:
468+
- **Using the toolbar**: Click the checklist button in the editor toolbar, usually represented by a checkbox icon.
469+
- **Using the shortcut**: Press `Ctrl+Shift+9` (or `Cmd+Shift+9` on macOS) to insert a checklist at your cursor’s position.
470+
- **Converting existing lists**: Select an existing bullet or numbered list and click the checklist button to convert it into an interactive checklist.
471+
- **Toggling checklist items**: You can toggle the state of checklist items between checked and unchecked by clicking the checkbox. If you prefer using the keyboard, press `Ctrl+Enter` (or `Cmd+Enter` on macOS) to toggle the check marks based on your selection or cursor position in the editor.
472+
473+
#### Configuring checklist
474+
To enable the checklist feature in your editor, add the `Checklist` toolbar item to the [RichTextEditorToolbarSettings.Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorToolbarSettings.Items) property. This feature supports customizable behavior and can be easily integrated into your Rich Text Editor toolbar for quick access.
475+
476+
Here’s an example of how you can configure the checklist in your Rich Text Editor:
477+
478+
{% tabs %}
479+
{% highlight razor %}
480+
481+
@using Syncfusion.Blazor.RichTextEditor
482+
483+
<SfRichTextEditor>
484+
<RichTextEditorToolbarSettings Items="@Items" />
485+
<p>The Rich Text Editor component is the WYSIWYG ('what you see is what you get') editor that provides the best user experience to create and update content. Users can format their content using standard toolbar commands.</p>
486+
</SfRichTextEditor>
487+
@code {
488+
private List<ToolbarItemModel> Items = new List<ToolbarItemModel>()
489+
{
490+
new ToolbarItemModel() { Command = ToolbarCommand.Checklist }
491+
};
492+
}
493+
494+
{% endhighlight %}
495+
{% endtabs %}
496+
497+
![Blazor RichTextEditor Checklist](../images/checklist.png)
498+
462499
## Formatting code blocks
463500

464501
Configure code block formatting as a separate toolbar button by adding the `InsertCode` Command within the [RichTextEditorToolbarSettings.Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorToolbarSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorToolbarSettings_Items) property. The `InsertCode` button has a toggle state to apply code block formatting to the editor and remove code block formatting from the editor.

0 commit comments

Comments
 (0)