將富文本編輯器控制項新增至模型導向應用程式

富文本編輯器控制項是在盛行的 CKEditor 上組建的 HTML 型輕量級編輯器。它可讓您在模型導向應用程式中建立、貼上和編輯格式化的文字。要在編輯器中格式化文字，您可以使用編輯器工具列、插入 HTML 標籤，或將其他應用程式（如瀏覽器或 Word）格式化文字貼上。

您可以自訂編輯器的外觀、功能和行為。

新式文本編輯器增強功能

現代文字編輯器設計上與 Microsoft 應用程式如 Outlook、Word 和 OneNote 的熟悉且直覺的介面保持一致。此體驗預設為現代設計，包含深色模式、高對比主題，以及全新 Copilot 功能，提升文字編輯能力。

備註

自 2025 年 4 月起，富文字編輯器的傳統版本已被取代。如果你在升級或使用現代富文字編輯器時遇到問題，請聯絡 Microsoft 客服。
如果您自訂舊版的 RTF 編輯器，則可能需要在新式 RTF 編輯器中重新建立自訂。

將 RTF 文字編輯器控制項新增至表單上的文字欄

登入Power Apps。
在左側瀏覽窗格中選擇解決方案。
開啟一個解決方案，然後開啟解決方案中的一個資料表。
在資料體驗區中，選擇表單，然後開啟包含要新增 RTF 文字編輯器的文字欄的表單。
在表單設計工具畫布上，選擇一個現有的文字欄。或者，選取新增資料表欄位來建立新的文字欄位，輸入顯示名稱，選取文字>RTF作為資料類型，然後選取儲存。

備註

如果要將 RTF 文字編輯器控制項新增至已存在的資料欄，則必須先將該欄的資料類型變更為文字 (如果還不是文字欄)，然後選擇使用 RTF 文字選項的格式。
在欄屬性窗格中，展開元件清單，選擇 + 元件，然後選擇 RTF 文字編輯器控制項。
在新增富文本編輯器控制項窗格中，選取網頁、電話和平板電腦，以允許在任何裝置上執行的應用程式使用編輯器。

如果您想要自訂編輯器，請在靜態值方塊中輸入其設定檔的相對 URL，這是包含您想要變更之屬性的 JavaScript Web 資源。如果您將此欄位留空，則編輯器會使用其預設設定。
選取完成。 RTF 文字欄已新增至表單。
選取儲存並發佈以套用變更至表單。

將富文本編輯器控制項新增至文字行

您也可以為使用 RTF 文字編輯器控制項的資料表建立一欄。以下步驟將示範如何建立文字欄位，之後可以加入模型驅動應用程式的表單。

登入Power Apps。
在左側瀏覽窗格中選擇解決方案。
在解決方案中打開解決方案和表格。
在結構描述區域中，選擇資料欄，然後開啟一個文字欄。

如果資料表不包含文字欄，請選擇新欄並輸入欄的名稱。
在右側窗格中，選擇格式，然後選擇RTF 文字。
儲存這個欄位。

自訂富文本編輯器控制項

下列自訂可在經典富文本編輯器體驗中找到。

Power Apps 允許你更改富文字編輯器控制項的屬性，以自訂其外觀、功能與行為。若要自訂控制項的特定執行個體，請在個別 JSON 格式的設定檔中指定屬性及其值。若要自訂控制項的全域設定，請變更預設設定檔中的屬性。

自訂的等級

你可以套用最多三個層次或階層的設定來自訂富文字編輯器：

在最基本的層級中，控制項的每個執行個體都會從檔案 RTEGlobalConfiguration_Readonly.json 取得其設定。檔案是唯讀的，因此您不能直接變更這些屬性。

備註

RTEGlobalConfiguration.json 不適用於電子郵件、知識文章、電子郵件範本和簽名。
在下一個層級，控制項的每個執行個體都會從檔案 RTEGlobalConfiguration.json (如果有的話) 中的屬性取得其設定。此設定的分層會在前一個之上，因此，此檔案中的屬性會取代唯讀檔案中相同名稱的屬性。
最後，在最高層級中，控制項的特定執行個體會從特定的設定檔 (如果有的話) 取得其設定。此設定的分層會在前一個之上，因此，此檔案中的屬性會取代前兩個層級較低檔案中相同名稱的屬性。

系統不會將所有屬性替換為更高層級設定中的屬性。這些 extraPlugins 屬性會合併，讓預設設定中能使用多種外部及現成的外掛程式。此合併操作允許你根據設定檔中特定控制項實例啟用或停用外掛。

自訂富文本編輯器的特定執行個體

在 Visual Studio Code 或其他文字編輯器中，建立一個檔案並賦予有意義的名稱。

檔案 RTEGlobalConfiguration.json 包含富文本編輯器的預設或全域設定。例如，假設您在聯絡人表單中自訂控制項，您可以將檔案命名為 RTEContactFormConfiguration.json 之類的名稱。
將以下程式碼片段複製並貼上到檔案中：

{
"defaultSupportedProps": {
  "propertyName": "value",
  "propertyName": "value",
  "propertyName": "value"
},
"propertyName": "value",
"propertyName": "value",
}

最後一個 propertyName:value 對未以逗號結尾。

用您想要變更的富文本編輯器控制項屬性取代 propertyName 和 value。字串值必須括在引號中。

我們提供給您一些範例設定，但您可以定義其他設定以滿足您的需求。
在Power Apps中，用你在步驟1建立的JSON檔案，建立一個JavaScript （JS）類型的網頁資源。
將 RTF 編輯器控制項新增到表單上的文字欄位，在新增 RTF 編輯器控制項面板中>靜態值，輸入 JavaScript Web 資源的相對 URL。

雖然您可以輸入 Web 資源的絕對 URL，但我們建議您輸入相對 URL。因此，如果您將 web 資源當成解決方案匯入至不同的環境，web 資源仍然可以運作，但前提是相對路徑要相同。

例如，如果 web 資源的 URL 是 https://yourorg.crm.dynamics.com/WebResources/rtecontactform，則相對 URL 為 /WebResources/rtecontactform。
選取完成。
選取儲存並發佈以套用變更至表單。

全域自訂富文本編輯器

可編輯的全域設定檔 RTEGlobalConfiguration.json 是您可以套用的第二層自訂。根據預設，此檔案為空白。這表示富文本編輯器的所有執行個體都使用唯讀檔案 RTEGlobalConfiguration_Readonly.json 中的屬性，除非您為控制項的特定執行個體建立設定檔。

如果您的業務需求需要您在所有地方自訂控制項，請在 RTEGlobalConfiguration.json 檔案中指定您需要的值。請使用唯讀檔案做為範例，以確保您以正確的格式輸入屬性值對。

用 Copilot 在編輯器裡精煉文字

Copilot 採用自然語言處理演算法來協助提升書面內容。你可以將 Copilot 添加到富文字編輯器中，然後獲得改進文法、清晰度或整體品質的建議。學習如何在富文字編輯器中使用Copilot。

富文本編輯器屬性

決定富文本編輯器執行個體之「介面外觀」的 JSON 檔案包含兩組屬性：

defaultSupportedProps 區段包含外掛程式屬性，決定控制項的功能。您無需受限於 CKEditor 與其外掛程式的屬性。您也可以為您新增或建立的外掛程式設定屬性值。
個別屬性區段包含用來決定控制項外觀的屬性。

範例設定檔

以下程式碼示範了一個 JSON 檔案範例，其中包含 defaultSupportedProps 屬性與個別設定屬性。如果屬性具有預設值，則會顯示預設值。如果屬性不具有預設值，則會顯示範例值以示範語法。屬性會在下面兩個表格中描述。

{
    "defaultSupportedProps": {
        "height": 185,
        "stickyStyle": {
            "font-size": "12pt",
            "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
        },
        "enterMode": 1,
        "stickyStyles_defaultTag": "div",
        "font_defaultLabel": "Segoe UI",
        "fontSize_defaultLabel":"12",
        "toolbarLocation": "top",
        "toolbar": [
        [ "CopyFormatting" ],
        [ "Font" ],
        [ "FontSize" ],
        [ "Bold" ],
        [ "Italic" ],
        [ "Underline" ],
        [ "BGColor" ],
        [ "TextColor" ],
        [ "BulletedList" ],
        [ "NumberedList" ],
        [ "Outdent" ],
        [ "Indent" ],
        [ "Blockquote" ],
        [ "JustifyLeft" ],
        [ "JustifyCenter" ],
        [ "JustifyRight" ],
        [ "Link" ],
        [ "Unlink" ],
        [ "Subscript" ],
        [ "Superscript" ],
        [ "Strike" ],
        [ "Image" ],
        [ "BidiLtr" ],
        [ "BidiRtl" ],
        [ "Undo" ],
        [ "Redo" ],
        [ "RemoveFormat" ],
        [ "Table" ]
        ],
        "extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filebrowser,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,notification,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools,uploadfile,uploadimage,uploadwidget",
        "toolbarcollapser_enableResizer": false,
        "placeholder":"",
        "linkTargets": ["notSet", "_blank"],
        "stylesSet": "default",
        "fontSize_sizes": "8/8px;9/9px;10/10px;11/11px;12/12px;14/14px;16/16px;18/18px;20/20px;22/22px;24/24px;26/26px;28/28px;36/36px;48/48px;72/72px",
        "font_names": "Angsana New/'Angsana New', 'Leelawadee UI', Sathu, serif;Arial/Arial, Helvetica, sans-serif;Arial Black/'Arial Black', Arial, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;Calibri/Calibri, Helvetica, sans-serif;Cambria/Cambria, Georgia, serif;Candara/Candara, Optima, sans-serif;Century Gothic/'Century Gothic', sans-serif;Comic Sans MS/'Comic Sans MS';Consolas/Consolas, Courier, monospace;Constantia/Constantia, 'Hoefler Text', serif;Corbel/Corbel, Skia, sans-serif;Cordia New/'Cordia New', 'Leelawadee UI', Silom, sans-serif;Courier New/'Courier New';DaunPenh/DaunPenh, 'Leelawadee UI', 'Khmer MN', sans-serif;Franklin Gothic Book/'Franklin Gothic Book', 'Avenir Next Condensed', sans-serif;Franklin Gothic Demi/'Franklin Gothic Demi', 'Avenir Next Condensed Demi Bold', sans-serif;Franklin Gothic Medium/'Franklin Gothic Medium', 'Avenir Next Condensed Medium', sans-serif;Garamond/Garamond, Georgia, serif;Gautami/Gautami, 'Nirmala UI', 'Telugu MN', sans-serif;Georgia/Georgia, serif;Impact/Impact, Charcoal, sans-serif;Iskoola Pota/'Iskoola Pota', 'Nirmala UI', 'Sinhala MN', sans-serif;Kalinga/Kalinga, 'Nirmala UI', 'Oriya MN', sans-serif;Kartika/Kartika, 'Nirmala UI', 'Malayalam MN', sans-serif;Latha/Latha, 'Nirmala UI', 'Tamil MN', sans-serif;Leelawadee UI/'Leelawadee UI', Thonburi, sans-serif;Lucida Console/'Lucida Console', Monaco, monospace;Lucida Handwriting/'Lucida Handwriting', 'Apple Chancery', cursive;Lucida Sans Unicode/'Lucida Sans Unicode';Mangal/Mangal, 'Nirmala UI', 'Devanagari Sangam MN', sans-serif;Nirmala UI/'Nirmala UI', sans-serif;Nyala/Nyala, Kefa, sans-serif;Palatino Linotype/'Palatino Linotype', 'Book Antiqua', Palatino, serif;Raavi/Raavi, 'Nirmala UI', 'Gurmukhi MN', sans-serif;Segoe UI/'Segoe UI', 'Helvetica Neue', sans-serif;Shruti/Shruti, 'Nirmala UI', 'Gujarati Sangam MN', sans-serif;Sitka Heading/'Sitka Heading', Cochin, serif;Sitka Text/'Sitka Text', Cochin, serif;Sylfaen/Sylfaen, Mshtakan, Menlo, serif;TW Cen MT/'TW Cen MT', 'Century Gothic', sans-serif;Tahoma/Tahoma, Geneva, sans-serif;Times New Roman/'Times New Roman', Times, serif;Times/Times, 'Times New Roman', serif;Trebuchet MS/'Trebuchet MS';Tunga/Tunga, 'Nirmala UI', 'Kannada MN', sans-serif;Verdana/Verdana, Geneva, sans-serif;Vrinda/Vrinda, 'Nirmala UI', 'Bangla MN', sans-serif;メイリオ/Meiryo, メイリオ, 'Hiragino Sans', sans-serif;仿宋/FangSong, 仿宋, STFangsong, serif;微軟正黑體/'Microsoft JhengHei', 微軟正黑體, 'Apple LiGothic', sans-serif;微软雅黑/'Microsoft YaHei', 微软雅黑, STHeiti, sans-serif;新宋体/NSimSun, 新宋体, SimSun, 宋体, SimSun-ExtB, 宋体-ExtB, STSong, serif;新細明體/PMingLiU, 新細明體, PMingLiU-ExtB, 新細明體-ExtB, 'Apple LiSung', serif;楷体/KaiTi, 楷体, STKaiti, serif;標楷體/DFKai-SB, 標楷體, BiauKai, serif;游ゴシック/'Yu Gothic', 游ゴシック, YuGothic, sans-serif;游明朝/'Yu Mincho', 游明朝, YuMincho, serif;隶书/SimLi, 隶书, 'Baoli SC', serif;黑体/SimHei, 黑体, STHeiti, sans-serif;굴림/Gulim, 굴림, 'Nanum Gothic', sans-serif;궁서/Gungsuh, 궁서, GungSeo, serif;돋움/Dotum, 돋움, AppleGothic, sans-serif;맑은 고딕/'Malgun Gothic', '맑은 고딕', AppleGothic, sans-serif;바탕/Batang, 바탕, AppleMyungjo, serif;바탕체/BatangChe, 바탕체, AppleMyungjo, serif;ＭＳ Ｐゴシック/'MS PGothic', 'ＭＳ Ｐゴシック', 'MS Gothic','ＭＳ ゴシック', 'Hiragino Kaku Gothic ProN', sans-serif;ＭＳ Ｐ明朝/'MS PMincho', 'ＭＳ Ｐ明朝', 'MS Mincho', 'ＭＳ 明朝', 'Hiragino Mincho ProN', serif",
        "copyFormatting_allowRules": "b s u i em strong span p div td th ol ul li(*)[*]{*}"
    },
    "readOnlySettings": {
    "height": 500,
    "showFullScreenExpander": true
    },
    "sanitizerAllowlist": {
    "attributes": [],
    "cssProperties": [],
    "domains": [],
    "protocols": [],
    "tags": []
    },
    "disableContentSanitization": true,
    "disableOnLoadEditModeSanitization": true,
    "disableDefaultImageProcessing": true,
    "showFullScreenExpander": false,
    "showAsTabControl": false,
    "showHtml": false
}

defaultSupportedProps

下表描述最常使用的屬性，但是您可以設定所有 CKEditor 支援的屬性。富文本編輯器控制項使用 CKEditor 4。

屬性	描述	預設值
height	以畫素為單位，設定內容區域的初始高度。	「185」
stickyStyle	設定編輯器字型和字型大小。	請參閱 defaultSupportedProps
stickyStyles_defaultTag	在編輯器內容區域中的文字周圍建立包裝函式。它的初始設定為「div」，但是您可以將它變更為「p」或任何替代標記。	「div」
font_defaultLabel	設定工具列中顯示的字體標籤。標籤只適用於外觀，不具功能性。 `stickyStyle` 屬性會決定編輯器的字型和字型大小。	“Segoe 用戶界面”
fontSize_defaultLabel	設定工具列中顯示的字體大小標籤。標籤只適用於外觀，不具功能性。 `stickyStyle` 屬性會決定編輯器的字型和字型大小。	「9」
toolbarLocation	在編輯器內容區域中設定工具列的位置。支援的值為「top」和「bottom」。	「bottom」
工具列	列出要顯示的工具列按鈕。	請參閱 defaultSupportedProps
plugins	列出編輯器可使用的預設外掛程式。如果 `extraPlugins` 與 `removePlugins` 有給定值，此清單中的外掛程式可能會與載入的外掛程式不同。若您將此屬性設定為空白字串，則會載入編輯器，但不會載入工具列。	請參閱 defaultSupportedProps
extraPlugins	將外掛程式附加到 `plugins` 清單以載入更多外掛程式。許多外掛程式都需要其他外掛程式才能運作。富文本編輯器會自動新增這些屬性，而您無法使用此屬性來覆寫它們。請改用 `removePlugins`。	請參閱 defaultSupportedProps
removePlugins	列出不載入的外掛程式。使用它可變更載入的外掛程式，但不會變更 `plugins` 與 `extraPlugins` 清單。	請參閱 defaultSupportedProps
superimageImageMaxSize	設定使用 superimage 外掛程式時，內嵌圖像允許的最大尺寸 (以 MB 為單位)。	「5」
linkTargets	允許您設定使用者建立連結時，可使用的連結目標選項： - "notSet"：未設定目標 - "frame"：會在指定的框架中開啟文件 - popupWindow"：在彈出式視窗中開啟文件 - "_blank"：在新視窗或索引標籤中開啟文件 - "_top"：在視窗的完整本文中開啟文件 - "_self"：在已啟動連結的相同視窗或索引標籤中開啟文件 - "_parent"：會在上層框架中開啟文件	"notSet"、"_blank"

個別屬性

下表描述您可以用來自訂富文本編輯器控制項的更多屬性。

屬性	描述	預設值
attachmentEntity	若要使用表格而不是預設，在上傳的檔案上執行更多安全性，請設定此屬性並指定不同的表格。語法： "name": "tableName", "fileAttributeName": "attributeNameofBlobReference"	請參閱 defaultSupportedProps
disableContentSanitization	內容清理會從富文本內容移除某些自訂屬性或標籤。預設會停用，以允許從外部來源複製和貼上富文本內容。此屬性僅會套用至編輯模式。當編輯器控制項為唯讀或停用時，內容始終是清理過的。	True
disableDefaultImageProcessing	根據預設，在編輯器中插入的圖像會上傳至設定中定義的 `attachmentEntity`。外部使用者可能無權查看表格中的內容。而是將此屬性設為 true，以將圖像作為 base64 字串直接儲存在設定為使用富文本編輯器控制項的行中。	假的
disableImages	判斷圖像是否可以插入到編輯器中。此屬性具有最高優先順序。當此屬性設為 true 時，不論 `imageEntity` 屬性值如何，都會停用圖像。	假的
imageEntity	若要使用表格而不是預設在圖像上強化更多安全性，請設定此屬性並指定不同的表格。語法："imageEntityName": "tableName", "imageFileAttributeName": "attributeNameofBlobReference"	請參閱 defaultSupportedProps
readOnlySettings	這些屬性會決定行在唯讀或停用狀態下查看時的行為。您可以指定任何支援的屬性。	無；請參閱defaultSupportedProps 中的範例
sanitizerAllowlist	列出其他可在編輯器中顯示的內容類型。	請參閱 defaultSupportedProps
showAsTabControl	允許您在內容區域上方顯示更多命令。必須設為 True，才能使用下列屬性：`showFullScreenExpander`、`showHtml`、`showPreview`、`showPreviewHeaderWarning`	假的
showFullScreenExpander	判斷編輯器是否可在全螢幕模式中使用。 `showAsTabControl` 必須設定為 true。	假的
showHtml	允許使用者直接顯示和編輯 HTML 內容。 `showAsTabControl` 必須設定為 true。	假的
showPreview	允許使用者預覽呈現為 HTML 的編輯器內容。 `showAsTabControl` 必須設定為 true。	假的
showPreviewHeaderWarning	允許您顯示或隱藏預覽內容時顯示的警告訊息。 `showAsTabControl` 和 `showPreview` 必須設定為 true。	假的
allowSameOriginSandbox	允許將編輯器中的內容視為與呈現應用程式有相同的來源。請慎用此屬性。只使用信任的外部內容。當此屬性設為 true 時，任何外部內容都可以存取內部資源。	假的

範例設定

以下樣本設定在經典體驗中建立富文本編輯器的特定自訂。您可以直接使用它們或將它們當作起點來自訂富文本編輯器的特定執行個體或全域。

將預設字型設定為 11 點 Calibri

在您的 defaultSupportedProps 屬性在設定檔中設定這些屬性。除最後一個值之外的每個值後面都必須跟逗號 (,)。

"font_defaultLabel": "Calibri",
"fontSize_defaultLabel": "11",
"stickyStyle": {
  "font-size": "11pt",
  "font-family": "Calibri/Calibri, Helvetica, sans-serif;"
},

讓 Enter 鍵插入新行，而不是段落塊

預設情況下，按下 Enter 鍵會建立一個 <p> HTML 段落標籤。 HTML 使用段落區塊來分組資訊，就像 Word 文件中的段落一樣。瀏覽器可能會以稍微不同的方式呈現 <p> 標籤，所以為了保持視覺上的一致性，你可能會想使用新行或 <br\> 換行標籤。

在您的defaultSupportedProps屬性中，在設定檔中進行設定。請在此值後面加上逗點 (,)，除非它是檔案中的最後一個屬性。

"enterMode": 2,

允許編輯器使用全螢幕

請在您的設定檔中設定這些個別屬性。除最後一個值之外的每個值後面都必須跟逗號 (,)。

"showFullScreenExpander": true,

富文本編輯器的螢幕截圖，其中突出顯示全螢幕展開控制項。

允許查看和編輯 HTML 內容

若要允許使用者直接查看和編輯其內容的 HTML，請顯示 HTML 索引標籤。

請在您的設定檔中設定這些個別屬性。除最後一個值之外的每個值後面都必須跟逗號 (,)。

"showAsTabControl": true,
"showHtml": true,

富文本編輯器的螢幕截圖，其中突出顯示 HTML 索引標籤。

根據預設，編輯器工具列包含所有可用的格式化工具。若要提供簡化的工具列，請使用 toolbar 屬性，並指定使用者可用來設定其內容格式的工具。

在您的defaultSupportedProps屬性中，在設定檔中進行設定。請在此值後面加上逗點 (,)，除非它是檔案中的最後一個屬性。

"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ],

富文本編輯器的螢幕截圖，其中突出顯示簡化的工具列。

若要完全移除工具列，請將 toolbar 的值設為「[]」(兩個方括弧)。

新增新的字體清單，並將 20 點 Brush Script MT 設定為預設字體

在您的 defaultSupportedProps 屬性在設定檔中設定這些屬性。除最後一個值之外的每個值後面都必須跟逗號 (,)。

"font_names": "Brush Script MT/'Brush Script MT', cursive;Calibri/Calibri, Helvetica, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;"
"font_defaultLabel": "Brush Script MT"
"fontSize_sizes": "8/8pt;12/12pt;20/20pt;32/32pt"
"fontSize_defaultLabel": "20"
"stickyStyle": {
  "font-size": "20pt",
  "font-family": "'Brush Script MT', cursive"
},

富文本編輯器的螢幕截圖，其中將 Brush Script MT 設為預設字型且包含新字型清單。

在您的defaultSupportedProps屬性中，在設定檔中進行設定。請在此值後面加上逗點 (,)，除非它是檔案中的最後一個屬性。

"toolbarLocation": "top",

以 30 畫素的高度啟動編輯器，然後增長到符合內容大小

在您的 defaultSupportedProps 屬性在設定檔中設定這些屬性。除最後一個值之外的每個值後面都必須跟逗號 (,)。

"autoGrow_onStartup": false,
"autoGrow_maxHeight": 8000,
"autoGrow_minHeight": 30,
"height": 30,

說明在富文本區域鍵入內容或貼上圖像會增加它以適合內容的螢幕截圖。

將編輯器的高度固定為 500 畫素

在您的 defaultSupportedProps 屬性在設定檔中設定這些屬性。除了最後一個值外，每個值後面都必須加上逗號。

"removePlugins": [ "autogrow" ],
"height": 500,

螢幕截圖顯示在固定高度下，當足夠的內容新增至富文本區域時，會出現捲軸。

若要使用瀏覽器的預設上下文功能表取代編輯器控制項的上下文功能表，請移除 contextmenu 外掛程式。

在您的defaultSupportedProps屬性中，在設定檔中進行設定。請在此值後面加上逗點 (,)，除非它是檔案中的最後一個屬性。

"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

下表描述預設在富文本編輯器中可用的格式化工具。

Name	捷徑索引標籤	描述
複製格式設定	Ctrl+Shift+C、Ctrl+Shift+V	將特定區段的外觀套用至另一個區段。
字型大小	Ctrl+Shift+F	選取字型。應用程式會考慮您選為預設字型的字型。如果未選擇字型，預設字型為 Segoe UI。當您選擇格式化的內容時，將顯示套用於該內容的字體的名稱。如果您的選擇包含多種字體，則會顯示套用於選取的第一種字體。
字型大小	Ctrl+Shift+P	改變你的文字大小。應用程式會考慮您選為預設字型大小的字型大小。如果您未選取，則 12 是預設字型大小。當您選擇格式化的內容時，將顯示套用於該內容的字體大小。如果您的選擇包含多個尺寸，則會顯示第一個套用於選擇的尺寸。
粗體	Ctrl+B	請將文字加粗。
斜體	Ctrl+I	將文字設為斜體。
底線	Ctrl+U 鍵	請在文字下劃線。
背景顏色		以鮮明色彩來亮顯文字，使文字突出。
文字顏色		變更文字的色彩。
插入/移除項目符號清單		建立項目符號清單。
插入/移除編號清單		建立一個編號清單。
減少縮排		把段落移得更靠近邊緣。
增加縮排		將段落移離邊緣更遠。
區塊引述		套用區塊層級引文格式到您的內容。
靠左對齊	Ctrl+L	將內容對齊左邊界。
置中對齊	Ctrl+E	使內容在頁面上居中。
靠右對齊	Ctrl+R	將內容與右邊界對齊。
連結		在文件中建立連結，以便快速存取網頁和其他雲端資源。在顯示文字方塊中輸入或貼上錨點文字，然後在 URL 方塊中輸入或貼上 URL。 (非必要) 若連結是連至非網頁，請選取連結類型和通訊協定。若要指定 URL 類型連結打開的位置，請選取目標索引標籤，然後選取目標。貼上或輸入的 URL 文字會自動轉換成連結。例如，`http://myexample.com` 變成 `<a href="http://myexample.com">http://myexample.com</a>`。
取消連結		從錨點移除連結，讓它變成純文字。
上標		略高於文字行輸入小型字母。
下標		略低於文字行輸入小型字母。
刪除線		在文字上畫一條線，將其刪去。
影像		若要插入圖像，請將它從剪貼簿貼至內容區域中，或將圖像檔案從資料夾拖曳到內容區域。拖曳映像的任何角落以調整大小。控制項支援 .png、.jpg.和 .gif 圖像。若要對圖像的來源、外觀和行為有更多的控制權，請選取圖像按鈕。瀏覽至本機資料夾中的圖像檔或輸入其 URL。如果圖像儲存於外部伺服器，請輸入絕對路徑。如果圖像位於本機伺服器，您可以輸入相對路徑。 (非必要) 輸入要調整圖像大小的特定高度和寬度，然後選取一個對齊方式。您也應該輸入替代文字，為使用螢幕閱讀器的人員描述圖像。如果圖像也是網頁或其他雲端資源的連結，請在目標 URL方塊中輸入資源的 URL，並視需要選取連結要打開的目標。
文字方向從左至右		邊更文字方向為從左至右。此設定為預設值。
文字方向從右至左		將雙向語言內容的文字變更為從右至左。
復原		還原上次對內容所做的變更。
重做		復原上次復原的動作，或重新套用上次對內容所做的變更。
移除格式		從選取文字中移除所有格式。
資料表		插入包含您選取之列數和行數的表格。若要更好地控制資料表的大小和外觀，請選擇資料表按鈕>更多並變更其屬性。您也可以在表格上點擊滑鼠右鍵，以查看和變更其屬性。若要變更行寬，請拖曳其邊框。您可以選取一或多個儲存格、列或行，然後套用特定格式、新增連結至選取的文字，並剪下、複製和貼上至整個列或行。
個人化設定		設定預設字型和字型大小。
協助工具說明	Alt+0	在富文本編輯器中，打開您可以使用的鍵盤快速鍵清單。
展開工具列		當視窗太窄而無法顯示整個工具列時，請選取展開，將工具列展開至第二列。

提示

若要使用瀏覽器內建的拼寫檢查工具，請在想要檢查的文字上點擊滑鼠右鍵，同時按住 Ctrl 鍵。不然，也可以在提供所選元素之上下文格式的 (上下文) 功能表上點擊滑鼠右鍵。
瀏覽器內建拼字檢查器的替代方案是 Microsoft 編輯器瀏覽器擴充功能。 Microsoft 編輯器能夠與富文字編輯器控制項無縫結合，啟用後提供快速且簡便的內嵌文法檢查和拼字檢查功能。

離線使用富文本編輯器

當您離線工作時，可以使用富文本編輯器控制項，但有些您過去常用的特色功能和功能並不包含在內。當您離線工作時，無法使用透過編輯器預設設定上傳的圖像。

富文本編輯器離線時，可以使用下列外掛程式：

ajax、autogrow、basicstyles、bidi、blockquote、button、confighelper、contextmenu、dialog、dialogui、editorplaceholder、enterkey、entities、fakeobjects、 floatingspace、floatpanel、format、horizontalrule、htmlwriter、indent、indentblock、indentlist、 justify、lineutils、list、listblock、maximize、menu、menubutton、notification、notificationaggregator、panel、panelbutton、popup、preview、removeformat、resize、richcombo、selectall、showborders、 sourcearea、specialchar、stylescombo、tab、textmatch、textwatcher、toolbar、undo、widgetselection、wysiwygarea 和 xml

富文本編輯器離線時，可以使用下列格式化工具：

粗體、斜體、底線、項目符號和編號清單、減少和增加縮排、塊引用、向左對齊、置中、向右對齊、刪除線、雙向文字、復原和取消復原，以及移除格式設定

使用 RTF 文字編輯器的最佳做法

富文本欄位會儲存格式化所需的 HTML 標籤以及使用者輸入的資料。當您設定富文本欄位的最大尺寸時，請務必同時允許 HTML 標籤和使用者的資料。
若要取得最佳效能，請將您的 HTML 內容保持在 1 MB 或以下。當尺寸較大時，您可能會注意到載入和編輯的回應時間較慢。
在預設設定中，圖像不會對效能造成負面影響，因為它們是與 HTML 內容分開儲存。但是，當上傳的的使用者不具備 msdyn_richtextfiles 表格的權限時，圖像會在文字行中儲存為 base64 內容。 Base64 內容很大，因此一般不會希望將圖像儲存為行內容的一部分。
根據預設，如果您具備系統管理員或基本使用者資訊安全角色，則可用使用者個人化功能。如果您沒有這些角色中的任何一個，則必須具有在 msdyn_customcontrolextendedsettings 表格上建立、讀取和寫入的權限，這樣使用者個人化外掛程式才能使用。
在預設的 RTF 文字編輯器設定中，如果將影像檔案拖放到 RTF 文字編輯器中，它會將內嵌影像上傳到 msdyn_richtextfiles 表中。為了讓適當的使用者能夠查看內嵌影像，請確保對 msdyn_richtextfiles 套用正確的權限。

RTF 文字編輯器限制

使用 RTF 文字編輯器時，請考慮本節列出的限制。如有功能可用性問題，請聯絡 Microsoft Customer Support。

這很重要

新式富文字編輯器是一種全新的體驗。若要使功能正常運作，您必須移除傳統版本。否則，您的範本可能無法正確顯示。

RTF 文字編輯器的限制包括以下內容：

你不能使用來自任何外部來源的富文本編輯器內容，例如 Microsoft Word、Excel 等等。
富文字編輯器支援以下附件檔案類型：.aac、.avi、.csv、.doc、.docx、.gif、.html、.jpeg、.mid、.midi、.mp3、.mp4、.mpeg、.msg、.pdf、.png、.ppt、.pptx、.svg、.txt、.vsd、.wav、.xls、.xlsm 及 .xlsx。您可以在進階設定中設定允許的檔案副檔名，路徑為管理>一般>設定附件被阻擋的檔案副檔名，並移除您想允許的副檔名。
這個富文字編輯器不支援非 Microsoft 的外掛程式。

電子郵件範本和簽名：

如果您在電子郵件範本的呈現方式上遇到問題，我們建議您在新式編輯器中重新建立它。
巢狀的 HTML 結構 (例如深度嵌套的 <div> 或 <table> 元素) 可能會導致 RTF 文字編輯器中出現渲染問題。我們建議您透過刪除不必要的巢狀 <div> 或 <table> 標籤來簡化 HTML 結構，以確保跨用戶端的一致呈現。

HTML 標籤

下列 HTML 標籤不再受支援，或由 RTF 編輯器中的新式替代方案取代。

Tag	描述	現代富文本編輯器的替代選擇
<首字母縮略詞>	定義首字母縮寫	<縮寫>
<小程式>	嵌入Java小程式	<物體>
<基本字體>	設定預設字型大小和顏色	CSS
<大>	放大文字	CSS 字體大小
<眨眼>	使文字閃爍	CSS 動畫
<中心>	中心內容	CSS 文字對齊
<導演>	目錄清單	<ul>
<字體>	樣式字體	CSS
<框>	定義框架	<iframe>
<框架組>	群組框架	<iframe>
<is索引>	單線輸入	<表單>
<跑馬燈>	捲動文字	CSS 動畫
<菜單>	菜單列表	<UL>
<無框架>	不支援框架的替代方案	不需要
<純文字>	顯示純文字	<前置>
<s>	刪除線文字	<del>、CSS
<打>	刪除線文字	<del>，<s>
<TT>	電傳打字文字	<程式碼>、CSS
<u>	帶底線的文字	CSS文字裝飾
<XMP>	預先格式化的文字	<前置>

HTML 屬性

下列 HTML 屬性不再受支援，或由 RTF 編輯器中的新式替代方案取代。

屬性	受影響的標籤	現代富文本編輯器的替代選擇
對應儲存	多	CSS 文字對齊，浮點
alink， vlink，鏈接	<正文>	CSS ：連結，：訪問
背景	<主體>， <表格>	CSS 背景圖片
背景顏色	多	CSS 背景顏色
邊界	<img>， <表格>
高度、寬度	<body>， <td>	CSS 高度、寬度
hspace、vspace	<圖像>
語言	<腳本>	type=“文字/JavaScript”
無包裝	<TD>	CSS 白空格：nowrap
類型（在 Li<、>UL< 上>）	清單	CSS 清單樣式類型

常見問題

為什麼打字的字元顯示得很慢？

如果編輯器中有大量內容，回應時間就會增加。若要取得最佳效能，請將您的 HTML 內容保持在 1 MB 或以下。拼字或文法檢查也會降低輸入速度。

為什麼我的內容直到編輯重新整理後才能呈現？

當自訂程式碼將內容注入 RTF 文字編輯器而不觸發控制項的重新渲染時，就會發生此行為。除非明確通知，否則 RTF 文字編輯器不會自動偵測外部更新。

要解決此問題，您可以執行以下動作之一：

使用事件接聽器 (例如，formContext.data.entity.addOnSave) 在註入內容後觸發重新整理。
使用 formContext.ui.refreshRibbon () 或類似的 API 強制更新。

範例:

window.top.addEventListener('rteEditorReady', (event) => {
    const { parentEntity } = event.detail;

    if (parentEntity?.typeName === 'email' &&
        parentEntity?.fieldName === 'description') {

        const descriptionAttr = Xrm.Page.getAttribute("description");
        if (descriptionAttr) {
            descriptionAttr.setValue(emailSignature);
        }
    }
}, { once: true });

在這個例子中，當 rteEditorReady 事件觸發後，事件監聽器會自動移除。此方法確保監聽器只執行一次，有助於防止記憶體洩漏及不必要的資源使用。

為何我無法上傳圖像？為何無法載入圖像預覽？

如果圖片檔案名稱 (包括路徑) 很長，則檔案可能會上傳失敗，或無法顯示預覽。請試著縮短檔案名稱，或將它移至路徑較短的位置，然後再次上傳。

為什麼我在文字中看到 HTML？

如果您在未設置為富文本格式的欄位中使用富文本編輯控制項，內容將出現在底層的 HTML 中，而不是已格式化的文本。

HTML 內容的大小限制為何？

若要取得最佳效能，請將您的 HTML 內容保持在 1 MB 或以下。當尺寸較大時，您可能會注意到載入和編輯的回應時間較慢。

HTML 出現在編輯器內容區域的螢幕截圖。

若要解決此問題，請確定資料行的格式是設定為富文字。

我超過了字元限制，但字元數卻少於限制。為什麼？

資料庫會儲存整個 HTML 格式，不僅僅是字元，而這會佔用額外的空間。

為什麼我看不到現代的豐富文本編輯器？

現代 RTF 文字編輯器控制項屬於模型導向應用程式新外觀的一部分，除非打開應用程式設定，否則不會出現。如果未啟用該設定，您可能會看到舊版本的編輯器。

模型導向應用程式新外觀的應用程式設定

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-04-07

將富文本編輯器控制項新增至模型導向應用程式

新式文本編輯器增強功能

將 RTF 文字編輯器控制項新增至表單上的文字欄

將富文本編輯器控制項新增至文字行

自訂富文本編輯器控制項

自訂的等級

自訂富文本編輯器的特定執行個體

全域自訂富文本編輯器

用 Copilot 在編輯器裡精煉文字

富文本編輯器屬性

範例設定檔

defaultSupportedProps

個別屬性

範例設定

將預設字型設定為 11 點 Calibri

讓 Enter 鍵插入新行，而不是段落塊

允許編輯器使用全螢幕

允許查看和編輯 HTML 內容

顯示簡化的工具列或完全移除工具列

新增新的字體清單，並將 20 點 Brush Script MT 設定為預設字體

將工具列置於 RTF 文字編輯器的頂端

以 30 畫素的高度啟動編輯器，然後增長到符合內容大小

將編輯器的高度固定為 500 畫素

建立上下文 (點擊滑鼠右鍵) 功能表使用瀏覽器的預設上下文功能表

富文本編輯器工具列

離線使用富文本編輯器

使用 RTF 文字編輯器的最佳做法

RTF 文字編輯器限制

HTML 標籤

HTML 屬性

常見問題

為什麼打字的字元顯示得很慢？

為什麼我的內容直到編輯重新整理後才能呈現？

為何我無法上傳圖像？ 為何無法載入圖像預覽？

為什麼我在文字中看到 HTML？

HTML 內容的大小限制為何？

我超過了字元限制，但字元數卻少於限制。 為什麼？

為什麼我看不到現代的豐富文本編輯器？

相關資訊

意見反應

其他資源

為何我無法上傳圖像？為何無法載入圖像預覽？

我超過了字元限制，但字元數卻少於限制。為什麼？