Skip to content

Commit fc84e07

Browse files
945108: Staging Failure Resolved
1 parent 5a6f2a3 commit fc84e07

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

blazor/rich-text-editor/mail-merge.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@ control: RichTextEditor
77
documentation: ug
88
---
99

10-
# Mail Merge in Blazor Rich Text Editor
10+
# Mail merge in Blazor Rich Text Editor Control
1111

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.
1313

14-
## Rendering Custom Toolbar Items
14+
## Rendering custom toolbar items
1515

1616
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:
1717

@@ -46,11 +46,11 @@ Custom toolbar items are added using the [RichTextEditorCustomToolbarItems](http
4646
{% endhighlight %}
4747
{% endtabs %}
4848

49-
## Populating and Using Insert Field Dropdown
49+
## Populating and using insert field dropdown
5050

5151
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.
5252

53-
### How the Items Property Works
53+
### How the items property works
5454

5555
- The `Items` property accepts a list of [DropDownMenuItem](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SplitButtons.DropDownMenuItem.html) objects.
5656
- 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.
@@ -105,7 +105,7 @@ When the user selects an item from the dropdown:
105105
}
106106
```
107107

108-
## Role of Mention Control in Mail Merge
108+
## Role of Mention control in mail merge
109109

110110
Mention control enhances usability by enabling inline field suggestions:
111111

@@ -118,7 +118,9 @@ Mention control enhances usability by enabling inline field suggestions:
118118

119119
<SfMention DataSource="_mergeData" TItem="MergeData" Target="#_mailMergeEditor" MentionChar="_mentionChar" AllowSpaces="true" PopupWidth='250px' PopupHeight='200px' @ref="mentionObj">
120120
<DisplayTemplate>
121-
<span>{{ "{% raw %}{{@((context as MergeData).Value)}}{% endraw %}" }}</span>
121+
{% raw %}
122+
<span>@((context as MergeData).Value)</span>
123+
{% endraw %}
122124
</DisplayTemplate>
123125
<ChildContent>
124126
<MentionFieldSettings Text="Text"></MentionFieldSettings>
@@ -130,7 +132,7 @@ Mention control enhances usability by enabling inline field suggestions:
130132

131133
This feature is ideal for users who prefer keyboard-driven workflows.
132134

133-
## Maintaining Cursor Position During Dropdown Operations
135+
## Maintaining cursor position during dropdown operations
134136

135137
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:
136138

@@ -156,7 +158,7 @@ When the `Insert Field` dropdown opens, the editor loses its current selection b
156158
}
157159
```
158160

159-
## Handling Editor Mode Changes with OnActionComplete
161+
## Handling editor mode changes with OnActionComplete
160162

161163
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.
162164

@@ -183,7 +185,7 @@ The [OnActionComplete](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.R
183185

184186
**Why is this important?** This prevents users from triggering merge operations or inserting fields while editing raw HTML, which could cause unexpected behavior.
185187

186-
## Executing Merge Data Action
188+
## Executing merge data action
187189

188190
When the `Merge Data` button is clicked:
189191

@@ -223,6 +225,6 @@ This ensures all placeholders are dynamically replaced without manual editing.
223225

224226
![Blazor RichTextEditor Mail Merge](./images/blazor-richtexteditor-mail-merge.png)
225227

226-
## Related Resources
228+
## Related resources
227229

228230
[Mention Control Guide](https://blazor.syncfusion.com/documentation/mention/getting-started-webapp)

0 commit comments

Comments
 (0)