Skip to content

Commit c3ffedb

Browse files
authored
Merge pull request #8260 from MicrosoftDocs/Tracet51-patch-external-images
Update rich-text-editor-control.md
2 parents 85c1d83 + 27858e1 commit c3ffedb

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

powerapps-docs/maker/model-driven-apps/rich-text-editor-control.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use the rich text editor control in Power Apps | MicrosoftDocs
33
description: "The rich text editor control provides the app user a WYSIWYG editing area for formatting text"
44
ms.custom: ""
5-
ms.date: 02/28/2023
5+
ms.date: 06/05/2023
66
ms.reviewer: "matp"
77
ms.suite: ""
88
ms.tgt_pltfrm: ""
@@ -91,7 +91,7 @@ Consider the following when using the rich text editor:
9191

9292
- Rich text fields will store HTML tags, which are required for formatting along with user entered data. When setting the maximum size for your field, make sure to assign a large enough size for both the HTML tags and user-entered data.
9393

94-
- By default, the rich text editor will upload images to the Azure Blob storage store and they won’t be stored as part of the field. Images will be stored in the same field as base64 when the submitter doesn’t have permissions to the `msdyn_richtextfiles` entity. Base64 content is large, so you generally don't want to store images as base64.
94+
- By default, the rich text editor uploads images to the Azure Blob storage store and they won’t be stored as part of the field. Images are stored in the same field as base64 when the submitter doesn’t have permissions to the `msdyn_richtextfiles` entity. Base64 content is large, so you generally don't want to store images as base64.
9595

9696
## How configuration is applied to the rich text editor
9797

@@ -231,8 +231,7 @@ You can configure all of the CKEditor-supported properties under this property.
231231
</td>
232232

233233
<td>
234-
235-
A list of toolbar buttons that will be loaded.
234+
A list of the loaded toolbar buttons.
236235
</td>
237236
<td>
238237

@@ -279,7 +278,7 @@ You can configure all of the CKEditor-supported properties under this property.
279278

280279
<td>
281280

282-
Comma-separated list of plug-ins to be used in an editor instance. The actual plug-ins that are loaded might still be affected by two other settings: *extraPlugins* and *removePlugins*. <br></br> Updating this setting might remove the plug-ins from the toolbar. If you set this property to an empty string, the editor will load without the toolbar. <br></br> If you want to add one or more plug-ins to the toolbar, we recommend that you use *extraPlugins*. If you want to remove one or more from the default list, use *removePlugins*.
281+
Comma-separated list of plug-ins to be used in an editor instance. The actual plug-ins that are loaded might still be affected by two other settings: *extraPlugins* and *removePlugins*. <br></br> Updating this setting might remove the plug-ins from the toolbar. If you set this property to an empty string, the editor loads without the toolbar. <br></br> If you want to add one or more plug-ins to the toolbar, we recommend that you use *extraPlugins*. If you want to remove one or more from the default list, use *removePlugins*.
283282
</td>
284283
<td>
285284

@@ -294,7 +293,7 @@ You can configure all of the CKEditor-supported properties under this property.
294293

295294
<td>
296295

297-
A comma-separated list of other plug-ins to be loaded. This setting makes it easier to add new plug-ins without touching the plugins setting. <br></br> There are many plug-ins that are required for other plug-ins to work. For example, the dialog plug-in is required for the link plug-in. The rich text editor automatically adds those, and you can't override them by updating this property. This setting will simply append new plug-ins to the previous list. <br></br> If you want to remove any of the presets, we recommend that you use the *removePlugins* property.
296+
A comma-separated list of other plug-ins to be loaded. This setting makes it easier to add new plug-ins without touching the plugins setting. <br></br> There are many plug-ins that are required for other plug-ins to work. For example, the dialog plug-in is required for the link plug-in. The rich text editor automatically adds those, and you can't override them by updating this property. This setting appends new plug-ins to the previous list. <br></br> If you want to remove any of the presets, we recommend that you use the *removePlugins* property.
298297
</td>
299298
<td>
300299

@@ -450,7 +449,7 @@ Default:
450449
</td>
451450

452451
<td>
453-
By default, content sanitization is disabled to allow successful copying and pasting of rich text content from external sources. When enabled, the content sanitization will remove some of the custom attributes or tags. This configuration applies only to edit mode. Read-only or disabled state rendering will always be sanitized.
452+
By default, content sanitization is disabled to allow successful copying and pasting of rich text content from external sources. When enabled, the content sanitization removes some of the custom attributes or tags. This configuration applies only to edit mode. Read-only or disabled state rendering is always sanitized.
454453

455454
</td>
456455
<td>
@@ -465,7 +464,11 @@ Default:
465464
</td>
466465

467466
<td>
468-
By default, images will be uploaded using the client API. As soon as an image is added to the editor, it will be uploaded to the platform. To store images as base64 strings directly in the column configured to use the rich text editor control set this value to **true**.
467+
By default, images are uploaded using the client API. When as an image is added to the editor, it is uploaded to the platform. To store images as base64 strings directly in the column configured to use the rich text editor control set this value to true.
468+
469+
> [!TIP]
470+
> If images are viewed externally, such as through email, we recommend that you not use default image processing. Default image processing uploads images to the `attachmentEntity` defined in the configuration, and an external user might lack privileges to view the content. Instead, an alternative upload, base64 strings can be used with ```"disableDefaultImageProcessing": true```.
471+
469472
</td>
470473
<td>
471474

@@ -481,7 +484,7 @@ Default:
481484

482485
<td>
483486

484-
Setting this property to true will disable images. This property will have highest priority. This means that when this property is set to true, irrespective of the imageEntity property value, images will be disabled. By default, images are enabled.
487+
Setting this property to true disables images. This property has highest priority. This means that when this property is set to true, irrespective of the imageEntity property value, images are disabled. By default, images are enabled.
485488
</td>
486489
<td>
487490

@@ -955,7 +958,7 @@ Set this ```Individual configuration settings``` property in your configuration
955958

956959
:::image type="content" source="media/rte-plain-text-surface.png" alt-text="Creating a plain text surface makes the strips html.":::
957960

958-
### Remove the context menu so right-clicking will work with the default browser's spell check
961+
### Remove the context menu so right-clicking works with the default browser's spell check
959962

960963
Enabling this functionality removes the contextual right-click editing capability.
961964

@@ -967,7 +970,7 @@ Set this ```defaultSupportedProps``` property in your configuration file. Each v
967970
968971
```
969972

970-
:::image type="content" source="media/rte-right-click-config.png" alt-text="Remove the context menu so right-clicking will work with the default browser spell check.":::
973+
:::image type="content" source="media/rte-right-click-config.png" alt-text="Remove the context menu so right-clicking works with the default browser spell check.":::
971974

972975
## Use the default web resource for organization-wide changes
973976

@@ -1031,7 +1034,7 @@ The following table describes the different formatting features and functionalit
10311034
|![Align Left.](media/align-left.png "Align Left")| Align Left | Ctrl+L | Align your content with the left margin. (Commonly used for body text to make it easier to read.) |
10321035
|![Align Center.](media/align-center.png "Align Center")| Align Center | Ctrl+E | Center your content on the page. (Commonly used for a formal appearance.) |
10331036
|![Align Right.](media/align-right.png "Align Right")| Align Right | Ctrl+R | Align your content with the right margin. (Commonly used for a formal appearance.) |
1034-
|![Link.](media/format-link.png "Link")| Link | | Create a link in your document for quick access to web pages and files.<br /><br />Pasted or typed URL text is converted into a link. For example, "http://myexample.com" will become "<a href="http://myexample.com">http://myexample.com</a>".<br /><br /> In the **Link** dialog box, choose the type of link you'd like to insert.<br /><br />The **Link Info** tab allows you to choose the link type as well as set the link protocol and URL.<br /><br />The **Target** tab is only available for the URL link type. It specifies the ___location where the link will open after you select it.<br /> |
1037+
|![Link.](media/format-link.png "Link")| Link | | Create a link in your document for quick access to web pages and files.<br /><br />Pasted or typed URL text is converted into a link. For example, "http://myexample.com" becomes "<a href="http://myexample.com">http://myexample.com</a>".<br /><br /> In the **Link** dialog box, choose the type of link you'd like to insert.<br /><br />The **Link Info** tab allows you to choose the link type as well as set the link protocol and URL.<br /><br />The **Target** tab is only available for the URL link type. It specifies the ___location where the link opens after you select it.<br /> |
10351038
|![Remove Link.](media/remove-link.png "Unlink")| Unlink | | Delete a link in your email or document.<br /><br />When you place the cursor on a link, the **Unlink** button on the toolbar becomes active. Select the button to remove the link and make it plain text. |
10361039
|![Superscript.](media/format-superscript.png "Superscript")| Superscript | | Type small letters just above the line of text. |
10371040
|![Subscript.](media/format-subscript.png "Subscript")| Subscript | | Type small letters just below the line of text. |

0 commit comments

Comments
 (0)