You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: blazor/rich-text-editor/mail-merge.md
+17-14Lines changed: 17 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,11 +7,11 @@ control: RichTextEditor
7
7
documentation: ug
8
8
---
9
9
10
-
# Mail Merge in Blazor Rich Text Editor
10
+
# Mail merge in Blazor Rich Text Editor Control
11
11
12
-
The Mail Merge feature in Blazor Rich Text Editor enables developers to create dynamic, personalized documents by inserting placeholders (merge fields) into the editor content. These placeholders are later replaced with actual data at runtime, making it ideal for generating letters, invoices, and bulk communication templates.
12
+
The Mail merge feature in Blazor Rich Text Editor enables developers to create dynamic, personalized documents by inserting placeholders (merge fields) into the editor content. These placeholders are later replaced with actual data at runtime, making it ideal for generating letters, invoices, and bulk communication templates.
13
13
14
-
## Rendering Custom Toolbar Items
14
+
## Rendering custom toolbar items
15
15
16
16
Custom toolbar items are added using the [RichTextEditorCustomToolbarItems](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorCustomToolbarItems.html) tag. Each item is defined with:
17
17
@@ -46,11 +46,11 @@ Custom toolbar items are added using the [RichTextEditorCustomToolbarItems](http
46
46
{% endhighlight %}
47
47
{% endtabs %}
48
48
49
-
## Populating and Using Insert Field Dropdown
49
+
## Populating and using insert field dropdown
50
50
51
51
The `Insert Field` dropdown in the Rich Text Editor is designed to let users quickly insert predefined merge fields into the editor content. This dropdown is powered by the `SfDropDownButton` control, which uses its [Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SplitButtons.SfDropDownButton.html#Syncfusion_Blazor_SplitButtons_SfDropDownButton_Items) property to bind a collection of menu items.
52
52
53
-
### How the Items Property Works
53
+
### How the items property works
54
54
55
55
- The `Items` property accepts a list of [DropDownMenuItem](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SplitButtons.DropDownMenuItem.html) objects.
56
56
- Each item in this list represents a merge field and contains a [Text](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SplitButtons.DropDownMenuItem.html#Syncfusion_Blazor_SplitButtons_DropDownMenuItem_Text) property, which is displayed in the dropdown.
@@ -97,15 +97,15 @@ When the user selects an item from the dropdown:
@@ -130,7 +132,7 @@ Mention control enhances usability by enabling inline field suggestions:
130
132
131
133
This feature is ideal for users who prefer keyboard-driven workflows.
132
134
133
-
## Maintaining Cursor Position During Dropdown Operations
135
+
## Maintaining cursor position during dropdown operations
134
136
135
137
When the `Insert Field` dropdown opens, the editor loses its current selection because focus shifts to the popup. To ensure the placeholder is inserted at the correct position:
136
138
@@ -156,7 +158,7 @@ When the `Insert Field` dropdown opens, the editor loses its current selection b
156
158
}
157
159
```
158
160
159
-
## Handling Editor Mode Changes with OnActionComplete
161
+
## Handling editor mode changes with OnActionComplete
160
162
161
163
The [OnActionComplete](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorEvents.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorEvents_OnActionComplete) event fires after specific actions in the RichTextEditor, such as switching between Source Code and Preview modes.
162
164
@@ -183,7 +185,7 @@ The [OnActionComplete](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.R
183
185
184
186
**Why is this important?** This prevents users from triggering merge operations or inserting fields while editing raw HTML, which could cause unexpected behavior.
185
187
186
-
## Executing Merge Data Action
188
+
## Executing merge data action
187
189
188
190
When the `Merge Data` button is clicked:
189
191
@@ -202,9 +204,10 @@ When the `Merge Data` button is clicked:
0 commit comments