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

發行項
02/26/2025

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

您可以自訂編輯器的外觀、功能和行為。控制項的新式文字體驗如以下螢幕截圖所示。

模型導向應用程式中預設富文本編輯器的螢幕截圖。

目前，富文本編輯器有兩種不同的體驗：

新式文字編輯器：全新體驗，預設設定
傳統文字編輯器：原始體驗，將於 2025 年 4 月棄用

新式文本編輯器增強功能

新式文本編輯器旨在與 Microsoft 應用程式，如 Outlook、Word 和 OneNote 熟悉且直觀的介面保持一致。此體驗是預設設定的，引入了新式設計、暗模式、高對比度主題和新的副手功能，以增強您的文字編輯能力。

注意

經典富文本編輯器體驗中提供的某些功能在新式體驗中尚無法使用。此類功能包括：

設定選項，如本文中所述的經典體驗
如需更多資訊，請參閱新式文字編輯器限制

從傳統體驗啟用新式 RTF 文字編輯器體驗

新式 RTF 文字編輯器預設為啟用狀態，但如果您使用的是傳統體驗，請完成以下步驟以切換到新式 RTF 文字編輯器體驗。

在 Dynamics 365 中，按滑鼠右鍵點選要為其啟用新式富文本編輯器體驗的應用程式，然後選取在應用程式設計師中打開。 Power Apps 開啟應用程式設計師。
選取命令列中的設定。顯示設定頁面。
在左窗格中，在設定，選取功能。顯示功能頁面。
根據需要，將以下任一或所有選項的切換開關設為是：
- 啟用新式富文本編輯器控制項體驗和電子郵件說明：為電子郵件說明啟用新式富文本編輯器控制項體驗。此設定會覆寫您之前對富文本編輯器的經典 (預設) 電子郵件體驗所做的任何自訂。
- 為預設控制項啟用新式 RichTextEditor 控制項體驗：為預設的、未設定的執行個體啟用新式 RTF 文字編輯器體驗。
- 啟用備註製作的新式富文本編輯器控制項體驗：為備註啟用新式富文本編輯器控制項體驗。此設定會覆寫您之前對富文本編輯器的經典 (預設) 備註製作體驗所做的任何自訂。
選取儲存。
在應用程式設計師中，選取發佈。

從新式富文本編輯器體驗還原回經典體驗

如果您需要還原回經典富文本編輯器體驗，請按照啟用新式富文本編輯器體驗中的相同步驟操作，但取消選取您在步驟 4 中選取的選項。

新式 RTF 文字編輯器的限制

使用新式 RTF 文字編輯器時，請考慮本節列出的限制。有關功能可用性的問題，請聯絡 Microsoft 支援。

附註：

目前不支援在地語系化。
目前不支援應用程式內通知。
您不能使用任何外部來源 (如 Microsoft Word、Excel 等) 的 RTF 文字編輯器內容。
僅支援以下附件檔案類型：.aac、.avi、.csv、.doc、.docx、.pdf、.html、.jpeg、.mid、.midi、.mp3、.mp4、.mpeg、.msg、.pdf、.png、.ppt、.pptx、.svg、.txt、.vsd、.wav、.xls、.xlsm 和 .xlsx

知識管理：

預覽索引標籤目前不可用。

電子郵件範本和簽名：

如果您在電子郵件範本的呈現方式上遇到問題，我們建議您在新式編輯器中重新建立它。否則，請使用傳統編輯器。

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

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

將文字行格式化為富文本時，會自動新增預設的富文本編輯器控制項。

登入 Power Apps。
在左瀏覽窗格中，選取解決方案。
在解決方案中打開解決方案和表格。
在行和資料區域中，選取一個文字行。

如果資料表不包含文字資料行，請選擇 + (新資料行) 並輸入資料行的名稱。
在資料類型中，選擇文字右側的 >，然後根據資料行包含單行文字還是多行文字選擇適當的 RTF 文字選項。
儲存行，然後將其新增至表單。

將富文本編輯器控制項新增至表單中的文字行

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

登入 Power Apps。
在左瀏覽窗格中，選取解決方案。
在解決方案中打開解決方案和表格。
在資料體驗區域中，選取表單，然後找到包含您要新增富文本編輯器之文字行的表單。
選擇⋮>編輯>新分頁中編輯。
在表單設計師畫布上，選取、新增或建立文字行。
在資料行屬性窗格中，展開元件清單，選取 + 元件，然後選取富文本編輯器控制項。
在新增富文本編輯器控制項窗格中，選取網頁、電話和平板電腦，以允許在任何裝置上執行的應用程式使用編輯器。

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

自訂富文本編輯器控制項

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

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

自訂的等級

自訂富文本編輯器時，最多可套用三個層級或三層設定：

在最基本的層級中，控制項的每個執行個體都會從檔案 RTEGlobalConfiguration_Readonly.json 取得其設定。檔案是唯讀的，因此您不能直接變更這些屬性。
在下一個層級，控制項的每個執行個體都會從檔案 RTEGlobalConfiguration.json (如果有的話) 中的屬性取得其設定。此設定的分層會在前一個之上，因此，此檔案中的屬性會取代唯讀檔案中相同名稱的屬性。
最後，在最高層級中，控制項的特定執行個體會從特定的設定檔 (如果有的話) 取得其設定。此設定的分層會在前一個之上，因此，此檔案中的屬性會取代前兩個層級較低檔案中相同名稱的屬性。

我們必須在此稍微新增條件限制。系統不會將所有屬性替換為更高層級設定中的屬性。 extraPlugins 屬性會合併，以允許在預設設定中使用廣泛的外部及開箱即用外掛程式。這可讓您在控制項特定執行個體的設定檔中，根據需要啟用和停用外掛程式。

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

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

檔案 RTEGlobalConfiguration.json 包含富文本編輯器的預設或全域設定。例如，假設您在聯絡人表單中自訂控制項，您可以將檔案命名為 RTEContactFormConfiguration.json 之類的名稱。

在檔案中，複製並貼上下列程式碼片段：

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

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

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

我們提供給您一些範例設定，但您可以定義其他設定以滿足您的需求。
在 Power Apps中，使用您在步驟 1 建立的 JSON 檔案，建立一個 JavaScript (JS) 類型的 Web 資源。
將 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 精修編輯器中的文字

重要

此功能適用於搶先體驗的使用者。您可以選擇在您的環境中使用它進行測試和採用。
此功能僅供新組織早期使用。已經在使用該功能的現有組織可以繼續使用它，即使他們沒有選擇提前存取。
此功能適用於 Dynamics 365 Sales，包括已將潛在客戶和商機實體新增至網站地圖的自訂銷售應用程式。

Copilot 使用自然語言處理演算法，協助您改進書面內容。您可以將 Copilot 新增至富文本編輯器，然後取得建議以改進文法、清晰度或文字的整體品質。了解如何在富文本編輯器中使用 Copilot。

富文本編輯器屬性

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

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

範例設定檔

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

"defaultSupportedProps": {
  "height": 185,
  "stickyStyle": {
    "font-size": "9pt",
    "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
  },
  "stickyStyles_defaultTag": "div",
  "font_defaultLabel": "Segoe UI",
  "fontSize_defaultLabel": "9",
  "toolbarLocation": "bottom",
  "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" ]
 ],
  "plugins": [["button,toolbar,dialogui,dialog,autogrow,notification,clipboard,textmatch,fakeobjects,link,autolink,basicstyles,bidi,blockquote,panelbutton,panel,floatpanel,colorbutton,colordialog,listblock,richcombo,menu,contextmenu,copyformatting,enterkey,entities,popup,find,floatingspace,font,format,htmlwriter,horizontalrule,indent,indentblock,indentlist,justify,lineutils,openlink,list,liststyle,maximize,undo,menubutton,notificationaggregator,xml,ajax,pastetools,pastefromword,pastetext,preview,table,quicktable,removeformat,resize,selectall,showborders,sourcearea,specialchar,stylescombo,tab,tabletools,tableresize,tableselection,widgetselection,widget,wysiwygarea,textwatcher"]],
  "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",
  "removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
  "superimageImageMaxSize": 5,
  "disallowedContent": "form[action]; *[formaction]; script; *[on*]",
  "linkTargets": ["notSet", "_blank"],
},
"attachmentEntity": {
  "name": "msdyn_richtextfiles",
  "fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"externalPlugins": [
  {
    "name": "EmbedMedia",
    "path": "/WebResources/msdyncrm_/myplugins/embedmedia/"
  }
],
"imageEntity": {
  "imageEntityName": "msdyn_richtextfiles",
  "imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
  "height": 500,
  "showFullScreenExpander": true
},
"sanitizerAllowlist": {
  "attributes": [],
  "cssProperties": [],
  "domains": [],
  "protocols": [],
  "tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false,
"allowSameOriginSandbox": false

defaultSupportedProps

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

屬性	Description	Default value
高度	以畫素為單位，設定內容區域的初始高度。	「185」
stickyStyle	設定編輯器字型和字型大小。	請參閱 defaultSupportedProps
stickyStyles_defaultTag	在編輯器內容區域中的文字周圍建立包裝函式。它的初始設定為「div」，但是您可以將它變更為「p」或任何替代標記。	「div」
font_defaultLabel	設定工具列中顯示的字體標籤。標籤只適用於外觀，不具功能性。 `stickyStyle` 屬性會決定編輯器的字型和字型大小。	"Segoe UI"
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」
disallowedContent	讓您可以禁止使用者插入您不想包含在內容中的元素。您可以禁止整個元素或依照屬性、類別及樣式禁止。	請參閱 defaultSupportedProps
linkTargets	允許您設定使用者建立連結時，可使用的連結目標選項： - "notSet"：未設定目標 - "frame"：會在指定的框架中開啟文件 - popupWindow"：在彈出式視窗中開啟文件 - "_blank"：在新視窗或索引標籤中開啟文件 - "_top"：在視窗的完整本文中開啟文件 - "_self"：在已啟動連結的相同視窗或索引標籤中開啟文件 - "_parent"：會在上層框架中開啟文件	"notSet"、"_blank"

個別屬性

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

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

範例設定

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

將預設字型設定為 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,

僅貼上或建立 HTML 5 內容

雖然富文本編輯器控制項最適合 HTML 5 內容，但您可以使用 HTML 4 標記。但在某些案例中，混用 HTML 4 和 HTML 5 標記可能會造成使用上的問題。若要確保所有內容都是 HTML 5，請在 allowedContent 屬性中提供所有支援的 HTML 5 標記。編輯器控制項會把任何不符合規範的標記都轉換成它們的 HTML 5 等效項。

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

"allowedContent": "a(*)[*]{*};abbr(*)[*]{*};address(*)[*]{*};area(*)[*]{*};article(*)[*]{*};aside(*)[*]{*};audio(*)[*]{*};b(*)[*]{*};base(*)[*]{*};bdi(*)[*]{*};bdo(*)[*]{*};blockquote(*)[*]{*};body(*)[*]{*};br(*)[*]{*};button(*)[*]{*};canvas(*)[*]{*};caption(*)[*]{*};cite(*)[*]{*};code(*)[*]{*};col(*)[*]{*};colgroup(*)[*]{*};data(*)[*]{*};datalist(*)[*]{*};dd(*)[*]{*};del(*)[*]{*};details(*)[*]{*};dfn(*)[*]{*};dialog(*)[*]{*};div(*)[*]{*};dl(*)[*]{*};dt(*)[*]{*};em(*)[*]{*};embed(*)[*]{*};fieldset(*)[*]{*};figcaption(*)[*]{*};figure(*)[*]{*};footer(*)[*]{*};form(*)[*]{*};h1(*)[*]{*};h2(*)[*]{*};h3(*)[*]{*};h4(*)[*]{*};h5(*)[*]{*};h6(*)[*]{*};head(*)[*]{*};header(*)[*]{*};hr(*)[*]{*};html(*)[*]{*};i(*)[*]{*};iframe(*)[*]{*};img(*)[*]{*};input(*)[*]{*};ins(*)[*]{*};kbd(*)[*]{*};label(*)[*]{*};legend(*)[*]{*};li(*)[*]{*};link(*)[*]{*};main(*)[*]{*};map(*)[*]{*};mark(*)[*]{*};meta(*)[*]{*};meter(*)[*]{*};nav(*)[*]{*};noscript(*)[*]{*};object(*)[*]{*};ol(*)[*]{*};optgroup(*)[*]{*};option(*)[*]{*};output(*)[*]{*};p(*)[*]{*};param(*)[*]{*};picture(*)[*]{*};pre(*)[*]{*};progress(*)[*]{*};q(*)[*]{*};rp(*)[*]{*};rt(*)[*]{*};ruby(*)[*]{*};s(*)[*]{*};samp(*)[*]{*};section(*)[*]{*};select(*)[*]{*};small(*)[*]{*};source(*)[*]{*};span(*)[*]{*};strong(*)[*]{*};style(*)[*]{*};sub(*)[*]{*};summary(*)[*]{*};sup(*)[*]{*};svg(*)[*]{*};table(*)[*]{*};tbody(*)[*]{*};td(*)[*]{*};template(*)[*]{*};textarea(*)[*]{*};tfoot(*)[*]{*};th(*)[*]{*};thead(*)[*]{*};time(*)[*]{*};title(*)[*]{*};tr(*)[*]{*};track(*)[*]{*};u(*)[*]{*};ul(*)[*]{*};var(*)[*]{*};video(*)[*]{*};wbr(*)[*]{*};",

只貼上或建立純文字

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

"enterMode": 2,
"shiftEnterMode": 2,
"allowedContent": "*",
"disallowedContent": "*",
"forcePasteAsPlainText": true,
"toolbar": [],
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

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

"disableImages": true,

允許編輯器使用全螢幕

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

"showAsTabControl": true,
"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": 0,
"autoGrow_minHeight": 30,
"height": 30,

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

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

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

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

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

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

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

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

尋找富文本編輯器控制項的設定

如果您不確定富文本編輯器執行個體的設定來源為何，您可以使用瀏覽器的開發人員工具來尋找。

在 Microsoft Edge 或 Google Chrome 中，執行模型導向應用程式，並開啟包含富文本編輯器控制項的表單。
在富文本編輯器內容區域點擊滑鼠右鍵，然後選取檢查。
在檢查窗格中，選取控制台索引標籤。
在命令列的清單方塊中，選取上層 Main.aspx 頁面。

瀏覽器開發人員工具的螢幕截圖，其中突出顯示控制台索引標籤及 main.aspx 頁面。

在檢查窗格命令列上選取清除控制台圖示，然後在控制台中輸入 CKEDITOR.config.。

瀏覽器開發人員工具的螢幕截圖，其中突出顯示清除控制台圖示。

在檢查窗格主控台中，輸入 CKEDITOR.config.以顯示不同的設定。

CK 編輯器設定清單。

選取設定 (例如 autoGrow_minHeight) 來顯示目前的設定。

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

姓名	捷徑索引標籤	Description
複製格式設定	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>`。
取消連結		從錨點移除連結，讓它變成純文字。
上標		略高於文字行輸入小型字母。
下標		略低於文字行輸入小型字母。
刪除線		在文字上畫一條線，將其刪去。
Image		若要插入圖像，請將它從剪貼簿貼至內容區域中，或將圖像檔案從資料夾拖曳到內容區域。拖曳映像的任何角落以調整大小。控制項支援 .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 套用正確的權限。

常見問題

為何輸入的字元顯示緩慢？

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

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

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

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

若富文本編輯器控制項是使用於未格式化為富文本的行，則內容會以原本的 HTML 出現，而不是成為格式化的文字。

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

若要解決此問題，請參閱確認行的格式已設定為富文本。

共用方式為

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

新式文本編輯器增強功能

從傳統體驗啟用新式 RTF 文字編輯器體驗

從新式富文本編輯器體驗還原回經典體驗

新式 RTF 文字編輯器的限制

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

將富文本編輯器控制項新增至表單中的文字行

自訂富文本編輯器控制項

自訂的等級

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

全域自訂富文本編輯器

使用 Copilot 精修編輯器中的文字

富文本編輯器屬性

範例設定檔

defaultSupportedProps

個別屬性

範例設定

將預設字型設定為 11 點 Calibri

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

僅貼上或建立 HTML 5 內容

只貼上或建立純文字

允許編輯器使用全螢幕

允許查看和編輯 HTML 內容

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

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

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

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

尋找富文本編輯器控制項的設定

離線使用富文本編輯器

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

常見問題

為何輸入的字元顯示緩慢？

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

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

請參閱

意見反應

其他資源

共用方式為

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

新式文本編輯器增強功能

從傳統體驗啟用新式 RTF 文字編輯器體驗

從新式富文本編輯器體驗還原回經典體驗

新式 RTF 文字編輯器的限制

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

將富文本編輯器控制項新增至表單中的文字行

自訂富文本編輯器控制項

自訂的等級

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

全域自訂富文本編輯器

使用 Copilot 精修編輯器中的文字

富文本編輯器屬性

範例設定檔

defaultSupportedProps

個別屬性

範例設定

將預設字型設定為 11 點 Calibri

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

僅貼上或建立 HTML 5 內容

只貼上或建立純文字

允許編輯器使用全螢幕

允許查看和編輯 HTML 內容

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

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

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

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

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

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

尋找富文本編輯器控制項的設定

富文本編輯器工具列

離線使用富文本編輯器

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

常見問題

為何輸入的字元顯示緩慢？

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

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

請參閱

意見反應

其他資源

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