Skip to content

Commit a287635

Browse files
983303: Updated iframe.md, image.md, import-and-export.md, import-export.md, inline-mode.md
1 parent 02b209f commit a287635

File tree

5 files changed

+60
-60
lines changed

5 files changed

+60
-60
lines changed

blazor/rich-text-editor/iframe.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
layout: post
3-
title: IFrame Rendering in Blazor RichTextEditor | Syncfusion
4-
description: Checkout and learn here all about IFrame Rendering in Syncfusion Blazor RichTextEditor component and more.
3+
title: IFrame Rendering in Blazor Rich Text Editor | Syncfusion
4+
description: Checkout and learn here all about IFrame Rendering in Syncfusion Blazor Rich Text Editor component and more.
55
platform: Blazor
66
control: RichTextEditor
77
documentation: ug
88
---
99

10-
# Iframe Editable in Blazor RichTextEditor
10+
# Iframe Editable in Blazor Rich Text Editor
1111

12-
When the `RichTextEditorIframeSettings` option is set to [RichTextEditorIframeSettings.enabled](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Enable), the editor creates the iframe element as the content area on component initialization, which is used to display and edit the content. The editor only displays the body tag of an `<iframe>` document in the content area.
12+
When the `RichTextEditorIframeSettings` option is set to [RichTextEditorIframeSettings.Enable ](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Enable), the editor creates an iframe element as the content area during initialization, which is then used to display and edit the content. In iframe mode, the editor displays only the body tag of the iframe document within the content area.
1313

14-
Basically, in an iframe mode, you have the entire document but only the editor content, and you can also use styles and scripts only for the particular editor.
14+
In iframe mode, the editor content is hosted in an isolated document. Only the editor's content is shown, and styles or scripts can be applied specifically to that editor without affecting the rest of the page.
1515

1616
{% tabs %}
1717
{% highlight cshtml %}
@@ -26,11 +26,11 @@ Basically, in an iframe mode, you have the entire document but only the editor c
2626
{% endhighlight %}
2727
{% endtabs %}
2828

29-
![Blazor RichTextEditor with iframe](./images/blazor-richtexteditor-iframe.png)
29+
![Blazor Rich Text Editor with iframe](./images/blazor-richtexteditor-iframe.png)
3030

3131
## IFrame attributes
3232

33-
You can add an additional attribute to the body tag of an `<iframe>` element by using the [RichTextEditorIframeSettings.Attributes](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Attributes) property. This property contains name or value pairs in string format. It is used to override the default appearance of the content area.
33+
Add additional attributes to the body element of the iframe document using the[RichTextEditorIframeSettings.Attributes](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Attributes) property. This property accepts namevalue pairs in string format and can be used to override the default appearance of the content area.
3434

3535
{% tabs %}
3636
{% highlight cshtml %}
@@ -40,13 +40,13 @@ You can add an additional attribute to the body tag of an `<iframe>` element by
4040
{% endhighlight %}
4141
{% endtabs %}
4242

43-
![Blazor RichTextEditor with iframe attribute](./images/blazor-richtexteditor-iframe-attribute.png)
43+
![Blazor Rich Text Editor with iframe attribute](./images/blazor-richtexteditor-iframe-attribute.png)
4444

4545
## Adding external CSS/Script file
4646

47-
The editor offers to add an external CSS file to style the `<iframe>` element. Using the [RichTextEditorIframeSettings.Resources](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Resources) property, you can easily change the appearance of the editor's content by using an external CSS file.
47+
The editor supports adding external CSS files to style the iframe document by using the [RichTextEditorIframeSettings.Resources](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorIFrameSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorIFrameSettings_Resources) property. This allows changing the appearance of the editor content with an external stylesheet.
4848

49-
Similarly, add the external script file to the `<iframe>` element using the `RichTextEditorIframeSettings.Resources` property, and it will provide the additional functionalities to the Rich Text Editor.
49+
Similarly, add external script files to the iframe document using the same `RichTextEditorIframeSettings.Resources` property to provide additional functionality for the Rich Text Editor.
5050

5151
{% tabs %}
5252
{% highlight cshtml %}
@@ -72,6 +72,6 @@ Similarly, add the external script file to the `<iframe>` element using the `Ric
7272
{% endhighlight %}
7373
{% endtabs %}
7474

75-
![Blazor RichTextEditor with external css/script](./images/blazor-richtexteditor-iframe-external-CSS-script.png)
75+
![Blazor Rich Text Editor with external CSS and script](./images/blazor-richtexteditor-iframe-external-CSS-script.png)
7676

77-
N> You can refer to our [Blazor Rich Text Editor](https://www.syncfusion.com/blazor-components/blazor-rich-text-editor) feature tour page for its groundbreaking feature representations. You can also explore our [Blazor Rich Text Editor](https://blazor.syncfusion.com/demos/rich-text-editor/overview?theme=bootstrap5) example to knows how to render and configure the rich text editor tools.
77+
N> Visit the [Blazor Rich Text Editor](https://www.syncfusion.com/blazor-components/blazor-rich-text-editor) ffeature tour for an overview of its capabilities. Explore the [Blazor Rich Text Editor](https://blazor.syncfusion.com/demos/rich-text-editor/overview?theme=bootstrap5) demo to learn how to render and configure the editor tools.

blazor/rich-text-editor/image.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,36 @@
11
---
22
layout: post
3-
title: Image in Blazor RichTextEditor Component | Syncfusion
4-
description: Checkout and learn here all about Image in Syncfusion Blazor RichTextEditor component and much more.
3+
title: Image in Blazor Rich Text Editor Component | Syncfusion
4+
description: Checkout and learn here all about Image in Syncfusion Blazor Rich Text Editor component and much more.
55
platform: Blazor
66
control: RichTextEditor
77
documentation: ug
88
---
99

10-
# Image in Blazor RichTextEditor Component
10+
# Image in Blazor Rich Text Editor Component
1111

12-
Rich Text Editor allows inserting images from online sources and local computer where you want to insert the image in your content. For inserting the image to the Rich Text Editor, the following list of options have been provided in the `RichTextEditorImageSettings`.
12+
The Rich Text Editor supports inserting images from online sources and the local computer wherever images are needed in the content. To configure image behavior, use the options in [RichTextEditorImageSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorImageSettings.html).
1313

1414
| Options | Description |
1515
|----------------|---------|
16-
| AllowedTypes | Specifies the extensions of the image types allowed to insert on bowering and passing the extensions with List<string>. For example, private List<string> AllowedTypes = new List<string> { ".jpg",".png", ".gif" };|
16+
| AllowedTypes | Specifies the extensions of the image types allowed to insert on bowering and passing the extensions with List<string>. For example, private List<string> AllowedTypes = new List<string> `{ ".jpg", ".png", ".gif" };`|
1717
| Display | Sets the default display for an image when it is inserted into the Rich Text Editor. Possible options are: `Inline` and `Break`.|
18-
| Width | Sets the default width of the image when it is inserted in the Rich Text Editor.|
19-
| Height | Sets the default height of the image when it is inserted in the Rich Text Editor.|
20-
| SaveUrl | Provides URL to map the action result method to save the image.|
21-
| Path | Specifies the location to store the image. It is of string type and it appends to the name of the file or folder where you want to store the image. For example, "api/Images/"|
22-
| EnableResize | Enables resizing for image element.|
23-
| MinWidth | Defines the minimum Width of the image.|
24-
| MaxWidth | Defines the maximum Width of the image.|
25-
| MinHeight | Defines the minimum Height of the image.|
26-
| MaxHeight | Defines the maximum Height of the image.|
27-
| ResizeByPercent | Image resizing should be done by percentage calculation.|
18+
| Width | Sets the default width of an inserted image. |
19+
| Height | Sets the default height of an inserted image. |
20+
| SaveUrl | Specifies the URL of the controller action that handles image upload. |
21+
| Path | Specifies the location to store the image. It is of string type and it appends to the name of the file or folder where you want to store the image. For example, `"api/Images/"`|
22+
| EnableResize | Enables resizing for images. |
23+
| MinWidth | Sets the minimum width of the image. |
24+
| MaxWidth | Sets the maximum width of the image. |
25+
| MinHeight | Sets the minimum height of the image. |
26+
| MaxHeight | Sets the maximum height of the image. |
27+
| ResizeByPercent | Enables image resizing by percentage. |
2828

2929
## Upload options
3030

31-
Through the `browse` option in the Image dialog, select the image from the local machine and insert into the Rich Text Editor content.
31+
Use the `browse` option in the Image dialog to select an image from the local machine and insert into the Rich Text Editor content.
3232

33-
If the path field is not specified in the `RichTextEditorImageSettings`, the image will be converted into base64 and blob url for the image will be created then generated url will be set as `src` property of `<img>` tag as below.
33+
If the [Path](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorImageSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorImageSettings_Path) field is not specified in the [RichTextEditorImageSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorImageSettings.html), the image will be converted into base64 and blob url for the image will be created then generated url will be set as `src` property of `<img>` tag as below.
3434

3535
The image has been loaded from the local machine and it will be saved in the given location.
3636

@@ -135,43 +135,43 @@ namespace ImageUpload.Controllers
135135

136136
```
137137

138-
![Blazor RichTextEditor with Image](./images/blazor-richtexteditor-with-image.png)
138+
![Blazor Rich Text Editor with Image](./images/blazor-richtexteditor-with-image.png)
139139

140140
## Image delete
141141

142142
To remove an image from the Rich Text Editor content, select the image and click "Remove" tool from quick toolbar. It will delete the image from the Rich Text Editor content.
143143

144144
After selecting the image from the local machine, the URL for the image will be generated, from there also you can remove the image from the service location by clicking the cross icon as in the following image.
145145

146-
![Removing Image in Blazor RichTextEditor Content](./images/blazor-richtexteditor-remove-image.png)
146+
![Removing Image in Blazor Rich Text Editor Content](./images/blazor-richtexteditor-remove-image.png)
147147

148148
## Insert from web
149149

150150
To insert an image from online source like Google, Ping, and more, enable images tool on the editor’s toolbar. By default, the images tool opens an image dialog that allows to insert an image from online source.
151151

152-
![Inserting Image in Blazor RichTextEditor Content](./images/blazor-richtexteditor-insert-image.png)
152+
![Inserting Image in Blazor Rich Text Editor Content](./images/blazor-richtexteditor-insert-image.png)
153153

154154
## Dimension
155155

156156
Sets the default width and height of the image when it is inserted in the Rich Text Editor using `Width` and `Height` of `RichTextEditorImageSettings`.
157157

158-
Through the `QuickToolbar` also you can change the width and height using `Change Size` option. After clicking the option, the image size will open as below. In that specify the width and height of the image in pixel.
158+
The image size can also be changed through the `QuickToolbar` using the `Change Size` option. After clicking the option, a dialog opens where width and height can be specified in pixels.
159159

160-
![Changing Image Dimension in Blazor RichTextEditor](./images/blazor-richtexteditor-image-size.png)
160+
![Changing Image Dimension in Blazor Rich Text Editor](./images/blazor-richtexteditor-image-size.png)
161161

162-
## Caption and Alt Text
162+
## Caption and alt text
163163

164-
Image caption and alternative text can be specified for the inserted image in the Rich Text Editor using the `RichTextEditorQuickToolbarSettings` options such as Image Caption and Alternative Text.
164+
Specify image captions and alternative text using `RichTextEditorQuickToolbarSettings` options such as Image Caption and Alternative Text.
165165

166-
Through the Alternative Text option, set the alternative text for the image, when the image is not uploaded successfully into the Rich Text Editor.
166+
Use the Alternative Text option to set alt text that displays when the image fails to load.
167167

168-
By clicking the Image Caption, the image will get wrapped in an image element with a caption. Then, you can type caption content inside the Rich Text Editor.
168+
Clicking Image Caption wraps the image with a caption element, allowing caption text to be entered in the editor.
169169

170170
## Display position
171171

172172
Sets the default display for an image when it is inserted in the Rich Text Editor using `Display` field in`RichTextEditorImageSettings`.
173173

174-
N> It has two possible options: `Inline` and `Break`.
174+
N> Available options: Inline and Break.
175175

176176
```cshtml
177177
@@ -189,15 +189,15 @@ N> It has two possible options: `Inline` and `Break`.
189189

190190
## Image with link
191191

192-
The hyperlink itself can be an image in Rich Text Editor. If the image given as hyperlink, the remove, edit, and open links will be added to the quick toolbar of image as below. For further details about link, refer to the [link documentation](./link).
192+
An image can be used as a hyperlink. When an image is linked, the quick toolbar includes Remove Link, Edit Link, and Open Link options. For more details, see the[link documentation](./link).
193193

194-
![Blazor RichTextEditor Image with Link](./images/blazor-richtexteditor-image-link.png)
194+
![Blazor Rich Text Editor Image with Link](./images/blazor-richtexteditor-image-link.png)
195195

196196
## Resize
197197

198-
Rich Text Editor has a built-in image inserting support. The resize points will be appearing on each corner of image when focus. So, users can resize the image using mouse points or thumb through the resize points easily. Also, the resize calculation will be done based on aspect ratio.
198+
The Rich Text Editor includes built-in support for image resizing. Resize handles appear on the image’s corners when focused, allowing users to resize with the mouse or touch easily. Resizing preserves the aspect ratio.
199199

200-
![Image Resizing in Blazor RichTextEditor](./images/blazor-richtexteditor-image-resize.png)
200+
![Image Resizing in Blazor Rich Text Editor](./images/blazor-richtexteditor-image-resize.png)
201201

202202
N> You can refer to our [Blazor Rich Text Editor](https://www.syncfusion.com/blazor-components/blazor-rich-text-editor) feature tour page for its groundbreaking feature representations. You can also explore our [Blazor Rich Text Editor](https://blazor.syncfusion.com/demos/rich-text-editor/overview?theme=bootstrap5) example to know how to render and configure the rich text editor tools.
203203

blazor/rich-text-editor/import-and-export.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ documentation: ug
1111

1212
## Import from Microsoft Word
1313

14-
The Rich Text Editor allows you to import content from Word documents, preserving the original formatting and structure, including headings, lists, tables, and text styles. This ensures that documents are accurately represented within the editor for seamless editing and enhancement
14+
The Rich Text Editor allows you to import content from Word documents, preserving the original formatting and structure, including headings, lists, tables, and text styles. This ensures accurate representation of documents within the editor, enabling seamless editing.
1515

1616
To integrate an `ImportWord` option into the Rich Text Editor toolbar using the [RichTextEditorToolbarSettings.Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorToolbarSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorToolbarSettings_Items) property.
1717

@@ -75,7 +75,7 @@ The following code block provides a detailed explanation of the API endpoint use
7575

7676
```
7777

78-
The `ImportWord` functionality is integrated within the `ActionBegin` and `ActionComplete` events. If the cancel property is set to true in the `ActionBegin` event argument, the execution of the `ImportWord` functionality can be prevented.
78+
The `ImportWord` feature integrates with `ActionBegin` and `ActionComplete` events. Setting the `cancel` property to `true` in `ActionBegin` prevents execution.
7979

8080
The following example illustrates how to set up the `ImportWord` in the Rich Text Editor to facilitate content importation from Word documents:
8181

@@ -205,7 +205,7 @@ The following example illustrates how to set up the `ImportWord` in the Rich Tex
205205

206206
The Rich Text Editor's export functionality allows users to convert their edited content into PDF or Word documents with a single click, preserving all text styles, images, tables, and other formatting elements.
207207

208-
You can add `ExportWord` and `ExportPdf` tools to the Rich Text Editor toolbar using the[RichTextEditorToolbarSettings.Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorToolbarSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorToolbarSettings_Items) property.
208+
You can add `ExportWord` and `ExportPdf` tools to the Rich Text Editor toolbar using the [RichTextEditorToolbarSettings.Items](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.RichTextEditor.RichTextEditorToolbarSettings.html#Syncfusion_Blazor_RichTextEditor_RichTextEditorToolbarSettings_Items) property.
209209

210210
To enable the `ExportWord` and `ExportPdf` functionality, the `ServiceUrl` property must be correctly configured within the `RichTextEditorExportWord` and `RichTextEditorExportPdf`. These API endpoints handle the export process and manage the server-side generation of Word and PDF files, respectively.
211211

@@ -224,7 +224,7 @@ The following code block provides a detailed explanation of the API endpoint use
224224
public ActionResult ExportToPdf([FromBody] ExportParam args)
225225
{
226226
string htmlString = args.html;
227-
if (htmlString == null && htmlString == "")
227+
if (string.IsNullOrEmpty(htmlString)
228228
{
229229
return null;
230230
}
@@ -251,7 +251,7 @@ The following code block provides a detailed explanation of the API endpoint use
251251
public FileStreamResult ExportToDocx([FromBody] ExportParam args)
252252
{
253253
string htmlString = args.html;
254-
if (htmlString == null && htmlString == "")
254+
if (string.IsNullOrEmpty(htmlString)
255255
{
256256
return null;
257257
}

0 commit comments

Comments
 (0)