Partager via


Ajouter le contrôle Éditeur de texte enrichi à une application pilotée par modèle

Le contrôle de l’éditeur de texte enrichi est un éditeur HTML léger basé sur le CKEditor populaire. Il vous permet de créer, coller et modifier du texte mis en forme dans vos applications pilotées par modèle. Pour mettre en forme du texte dans l’éditeur, vous pouvez utiliser la barre d’outils de l’éditeur, insérer des balises HTML ou coller du texte mis en forme à partir d’autres applications, comme un navigateur Web ou Word.

Vous pouvez personnaliser l’apparence, les fonctionnalités et le comportement de l’éditeur.

Capture d’écran de l’éditeur de texte enrichi par défaut dans une application pilotée par modèle.

Améliorations de l’éditeur de texte moderne

L’éditeur de texte moderne est conçu pour s’aligner sur les interfaces familières et intuitives des applications Microsoft telles qu’Outlook, Word et OneNote. Cette expérience, définie par défaut, introduit un design moderne, un mode sombre, des thèmes à contraste élevé et une nouvelle fonctionnalité Copilot pour améliorer vos capacités d’édition de texte.

Nonte

La version classique de l’éditeur de texte enrichi est obsolète depuis avril 2025. Si vous rencontrez des problèmes avec la mise à niveau ou l’utilisation de l’éditeur de texte enrichi moderne, contactez le Service clientèle de Microsoft.

Ajouter le contrôle d’éditeur de texte enrichi à une colonne de texte dans un formulaire

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation de gauche, sélectionnez Solutions.

  3. Ouvrez une solution, puis ouvrez une table dans la solution.

  4. Dans la zone Expériences de données, sélectionnez Formulaires, puis ouvrez le formulaire contenant la colonne de texte à laquelle vous souhaitez ajouter l’éditeur de texte enrichi.

  5. Dans le canevas du concepteur de formulaires, sélectionnez une colonne de texte existante. Vous pouvez également sélectionner Nouvelle colonne de table pour créer une nouvelle colonne de texte, entrer un Nom d’affichage, sélectionner Texte>Texte enrichi pour le Type de données, puis sélectionner Enregistrer. Colonne de texte enrichi

    Nonte

    Si vous souhaitez ajouter le contrôle d’éditeur de texte enrichi à une colonne qui existe déjà, vous devez d’abord modifier le type de données de la colonne en Texte (si ce n’est pas déjà une colonne de texte), puis sélectionner le Format en utilisant l’option Texte enrichi.

  6. Dans le volet Propriétés de la colonne, développez la liste Composants, sélectionnez + Composant, puis sélectionnez Contrôle d’éditeur de texte enrichi.

  7. Dans le volet Ajouter le contrôle de l’éditeur de texte enrichi, sélectionnez Web, Téléphone et Tablette pour permettre aux applications qui s’exécutent sur un appareil d’utiliser l’éditeur.

    Si vous souhaitez personnaliser l’éditeur, entrez l’URL relative de son fichier de configuration, une ressource Web JavaScript contenant les propriétés que vous souhaitez modifier, dans la zone Valeur statique. Si vous laissez ce champ vide, l’éditeur utilise sa configuration par défaut.

  8. Cliquez sur Terminé. La colonne de texte enrichi est ajoutée au formulaire.

    Capture d’écran du contrôle d’éditeur de texte enrichi dans un formulaire d’application pilotée par modèle.

  9. Sélectionnez Enregistrer et publier pour appliquer vos modifications au formulaire.

Ajouter le contrôle de l’éditeur de texte enrichi à une colonne de texte

Vous pouvez également créer une colonne pour une table qui utilise le contrôle de l’éditeur de texte enrichi. Les étapes suivantes vous montrent comment créer une colonne de texte qui peut ensuite être ajoutée à un formulaire pour un application pilotée par modèle.

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation de gauche, sélectionnez Solutions.

  3. Ouvrez une solution et une table dans la solution.

  4. Dans la zone Schéma, sélectionnez Colonnes, puis ouvrez une colonne de texte.

    Si la table ne contient pas de colonne de texte, sélectionnez Nouvelle colonne et saisissez un nom pour la colonne.

  5. Dans le volet droit, sélectionnez Format, puis sélectionnez Texte enrichi.

  6. Enregistrez la colonne.

Personnaliser le contrôle de l’éditeur de texte enrichi

Les personnalisations suivantes sont disponibles dans l’expérience de l’éditeur de texte enrichi classique.

Power Apps vous permet de modifier les propriétés du contrôle de l’éditeur de texte enrichi pour personnaliser son apparence, ses fonctionnalités et son comportement. Pour personnaliser une instance spécifique du contrôle, spécifiez les propriétés et leurs valeurs dans un fichier de configuration individuel au format JSON. Pour personnaliser la configuration globale du contrôle, modifiez les propriétés dans le fichier de configuration par défaut.

Niveaux de personnalisation

Jusqu’à trois niveaux, ou couches, de configuration peuvent être appliqués pour personnaliser l’éditeur de texte enrichi :

  1. Au niveau le plus fondamental, chaque instance du contrôle extrait sa configuration du fichier RTEGlobalConfiguration_Readonly.json. Le fichier est en lecture seule, vous ne pouvez donc pas modifier directement ces propriétés.

    Nonte

    RTEGlobalConfiguration.json ne s’applique pas aux e-mails, aux articles de base de connaissances, aux modèles de courrier électronique et aux signatures.

  2. Au niveau suivant, chaque instance du contrôle extrait sa configuration des propriétés du fichier RTEGlobalConfiguration.json, si elles sont présentes. Cette configuration est superposée à la précédente ; par conséquent, les propriétés de ce fichier remplacent les mêmes propriétés nommées dans le fichier en lecture seule.

  3. Enfin, au niveau le plus élevé, une instance spécifique du contrôle extrait sa configuration d’un fichier de configuration spécifique, s’il en existe un. Cette configuration est superposée à la précédente ; par conséquent, les propriétés de ce fichier remplacent les mêmes propriétés nommées dans les deux fichiers de niveau inférieur.

Nous devons ajouter ici une légère nuance. Le système ne remplace pas toutes les propriétés par celles d’une configuration de niveau supérieur. Les propriétés extraPlugins sont fusionnées pour permettre l’utilisation d’un large éventail de plug-ins externes et prêts à l’emploi dans la configuration par défaut. Cela vous permet d’activer et de désactiver les plug-ins selon les besoins dans le fichier de configuration pour des instances spécifiques du contrôle.

Personnaliser une instance spécifique de l’éditeur de texte enrichi

  1. Dans Visual Studio Code ou un autre éditeur de texte, créez un fichier et donnez-lui un nom significatif.

    Le fichier RTEGlobalConfiguration.json contient la configuration par défaut ou globale de l’éditeur de texte enrichi. Si vous personnalisez le contrôle dans, par exemple, un formulaire de contact, vous pouvez nommer le fichier comme suit RTEContactFormConfiguration.json.

  2. Copiez et collez l’extrait de code suivant dans le fichier :

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

La dernière paire propertyName:value ne se termine pas par une virgule.

  1. Remplacez propertyName et value par les propriétés du contrôle de l’éditeur de texte enrichi que vous souhaitez modifier. Les valeurs de chaîne doivent être placées entre guillemets.

    Nous vous avons fourni quelques exemples de configuration, mais vous pouvez en définir d’autres en fonction de vos besoins.

  2. Dans Power Apps, créez une ressource Web de type Javascript (JS) à l’aide du fichier JSON créé à l’étape 1.

  3. Ajoutez le contrôle d’éditeur de texte enrichi à une colonne de texte dans un formulaire et, dans le volet Ajouter le contrôle d’éditeur de texte enrichi>Valeur statique, saisissez l’URL relative de la ressource web JavaScript.

    Bien que vous puissiez entrer l’URL absolue de la ressource web, nous vous recommandons d’entrer l’URL relative. De cette façon, la ressource Web fonctionne toujours si vous l’importez en tant que solution dans un environnement différent, à condition que le chemin relatif soit le même.

    Par exemple, si l’URL de la ressource Web est https://yourorg.crm.dynamics.com/WebResources/rtecontactform, l’URL relative est /WebResources/rtecontactform.

  4. Cliquez sur Terminé.

  5. Sélectionnez Enregistrer et publier pour appliquer vos modifications au formulaire.

Personnaliser l’éditeur de texte enrichi globalement

Le fichier de configuration globale modifiable RTEGlobalConfiguration.json est le deuxième niveau de personnalisation que vous pouvez appliquer. Par défaut, le fichier est vide. Cela signifie que toutes les instances de l’éditeur de texte enrichi utilisent les propriétés du fichier en lecture seule RTEGlobalConfiguration_Readonly.json, à moins que vous créiez un fichier de configuration pour une instance spécifique du contrôle.

Si les besoins de votre entreprise nécessitent de personnaliser le contrôle partout, spécifiez les valeurs nécessaires dans le fichier RTEGlobalConfiguration.json. Utilisez le fichier en lecture seule comme exemple pour vous assurer de saisir les paires propriété-valeur au format correct.

Utiliser Copilot pour affiner le texte dans l’éditeur

Copilot utilise des algorithmes de traitement du langage naturel pour aider à améliorer le contenu écrit. Vous pouvez ajouter Copilot à l’éditeur de texte enrichi, puis obtenir des suggestions pour améliorer la grammaire, la clarté ou la qualité globale de votre texte. Découvrez comment utiliser Copilot dans l’éditeur de texte enrichi.

Propriétés de l’éditeur de texte enrichi

Le fichier JSON qui détermine l’apparence d’une instance de l’éditeur de texte enrichi contient deux ensembles de propriétés :

Exemple de fichier de configuration

Le code suivant est un exemple de fichier JSON qui contient à la fois les propriétés defaultSupportedProps et les propriétés de configuration individuelles. Si une propriété a une valeur par défaut, la valeur par défaut est affichée. Si une propriété n’a pas de valeur par défaut, un exemple de valeur est affiché pour illustrer la syntaxe. Les propriétés sont décrites dans les deux tableaux qui suivent.

{
    "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 Pゴシック/'MS PGothic', 'MS Pゴシック', 'MS Gothic','MS ゴシック', 'Hiragino Kaku Gothic ProN', sans-serif;MS P明朝/'MS PMincho', 'MS P明朝', 'MS Mincho', 'MS 明朝', '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

Le tableau suivant décrit les propriétés les plus couramment utilisées, mais vous pouvez configurer toutes les propriétés prises en charge par CKEditor. Le contrôle de l’éditeur de texte enrichi utilise CKEditor 4.

Propriété Description Valeur par défaut
height Définit la hauteur initiale de la zone de contenu, en pixels. « 185 »
stickyStyle Définit la police et la taille de l’éditeur. Voir defaultSupportedProps
stickyStyles_defaultTag Crée un wrapper autour du texte dans la zone de contenu de l’éditeur. Elle est initialement définie sur « div », mais vous pouvez la remplacer par « p » ou toute autre balise. « div »
font_defaultLabel Définit l’étiquette de police affichée dans la barre d’outils. L’étiquette n’est fournie que pour l’apparence et n’est pas fonctionnelle. La propriété stickyStyle détermine la police et la taille de l’éditeur. "Segoe UI"
fontSize_defaultLabel Définit l’étiquette de la taille de police affichée dans la barre d’outils. L’étiquette n’est fournie que pour l’apparence et n’est pas fonctionnelle. La propriété stickyStyle détermine la police et la taille de l’éditeur. « 9 »
toolbarLocation Définit l’emplacement de la barre d’outils dans la zone de contenu de l’éditeur. Les valeurs prises en charge sont « top » et « bottom ». « bottom »
toolbar Répertorie les boutons de la barre d’outils à afficher. Voir defaultSupportedProps
plugins Répertorie les plug-ins prédéfinis que l’éditeur peut utiliser. Les plug-ins dans cette liste peuvent être différents des plug-ins chargés, si extraPlugins et removePlugins reçoivent une valeur. Si vous définissez cette propriété sur une chaîne vide, l’éditeur se charge sans la barre d’outils. Voir defaultSupportedProps
extraPlugins Ajoute des plug-ins à la liste plugins pour charger plus de plug-ins.
De nombreux plug-ins nécessitent d’autres plug-ins pour fonctionner. L’éditeur de texte enrichi les ajoute automatiquement et vous ne pouvez pas utiliser cette propriété pour les remplacer. Utilisez plutôt removePlugins.
Voir defaultSupportedProps
removePlugins Répertorie les plug-ins qui ne doivent pas être chargés. Utilisez-la pour modifier les plug-ins chargés sans modifier les listes plugins et extraPlugins . Voir defaultSupportedProps
superimageImageMaxSize Définit la taille maximale en mégaoctets (Mo) autorisée pour les images incorporées lors de l’utilisation du plug-in superimage. « 5 »
linkTargets Vous permet de configurer les options de cible de lien disponibles pour les utilisateurs lorsqu’ils créent des liens :
- « notSet » : aucune cible définie
- « frame » : ouvre le document dans le cadre spécifié
- popupWindow : ouvre le document dans une fenêtre contextuelle
- « _blank » : ouvre le document dans une nouvelle fenêtre ou un nouvel onglet
- « _top » : ouvre le document dans tout le corps de la fenêtre
- « _self : ouvre le document dans la même fenêtre ou le même onglet où le lien est activé
- « _parent » : ouvre le document dans le cadre parent
« notSet », « _blank »

Propriétés individuelles

Le tableau suivant décrit d’autres de propriétés que vous pouvez utiliser pour personnaliser le contrôle de l’éditeur de texte enrichi.

Propriété Description Valeur par défaut
attachmentEntity Pour renforcer la sécurité sur les fichiers chargés en utilisant une table autre que celle par défaut, définissez cette propriété et spécifiez une autre table.
Syntaxe : « name » : « tableName », « fileAttributeName » : « attributeNameofBlobReference »
Voir defaultSupportedProps
disableContentSanitization L’assainissement du contenu supprime certains attributs ou balises personnalisés du contenu de texte enrichi. Il est désactivé pour permettre la copie et le collage du contenu de texte enrichi à partir de sources externes. Cette propriété ne s’applique qu’au mode d’édition. Lorsque le contrôle de l’éditeur est en lecture seule ou désactivé, le contenu est toujours assaini. true
disableDefaultImageProcessing Par défaut, les images insérées dans l’éditeur sont chargées dans la propriété attachmentEntity définie dans la configuration. Les utilisateurs externes peuvent ne pas disposer des privilèges nécessaires pour afficher le contenu dans la table. À la place, définissez cette propriété sur true pour stocker les images sous forme de chaînes base64 directement dans la colonne configurée pour utiliser le contrôle de l’éditeur de texte enrichi. faux
disableImages Détermine si des images peuvent être insérées dans l’éditeur. Cette propriété a la plus haute priorité. Lorsque cette propriété est définie sur true, les images sont désactivées, quelle que soit la valeur de la propriété imageEntity. false
externalPlugins Répertorie les plug-ins externes ou les plug-ins que vous créez et qui peuvent être utilisés dans le contrôle de l’éditeur de texte enrichi.
Syntaxe : « name » : « pluginName », « path » : « pathToPlugin » (la valeur du chemin d’accès peut être une URL absolue ou relative)
Aucune ; voir defaultSupportedProps pour obtenir un exemple
imageEntity Pour renforcer la sécurité sur les images en utilisant une table autre que celle par défaut, définissez cette propriété et spécifiez une autre table.
Syntaxe : « imageEntityName » : « tableName », « imageFileAttributeName » : « attributeNameofBlobReference »
Voir defaultSupportedProps
readOnlySettings Ces propriétés déterminent le comportement de la colonne lorsqu’elle est affichée en lecture seule ou désactivée. Vous pouvez spécifier n’importe quelle propriété prise en charge. Aucune ; voir defaultSupportedProps pour obtenir un exemple
sanitizerAllowlist Répertorie les autres types de contenu qui peuvent être affichés dans l’éditeur. Voir defaultSupportedProps
showAsTabControl Vous permet d’afficher d’autres commandes au-dessus de la zone de contenu. Doit être définie sur true pour utiliser les propriétés suivantes : showFullScreenExpander, showHtml, showPreview, showPreviewHeaderWarning faux
showFullScreenExpander Détermine si l’éditeur peut être utilisé en mode plein écran. La propriété showAsTabControl doit être définie sur true. false
showHtml Permet aux utilisateurs d’afficher et de modifier directement le contenu HTML. La propriété showAsTabControl doit être définie sur true. faux
showPreview Permet aux utilisateurs de prévisualiser le contenu de l’éditeur affiché au format HTML. La propriété showAsTabControl doit être définie sur true. false
showPreviewHeaderWarning Vous permet d’afficher ou de masquer le message d’avertissement affiché lors de la prévisualisation du contenu. Les propriétés showAsTabControl et showPreview doivent être définies sur true. false
allowSameOriginSandbox Permet au contenu de l’éditeur de texte enrichi d’être traité comme provenant de la même origine que l’application qui l’affiche.
Utilisez cette propriété avec prudence. Utilisez uniquement du contenu externe fiable. Lorsque cette propriété est définie sur true, tout contenu externe peut avoir accès aux ressources internes.
false

Exemples de configurations

Les exemples suivants de configurations créent des personnalisations spécifiques de l’éditeur de texte enrichi dans l’expérience classique. Vous pouvez les utiliser tels quels ou comme point de départ pour personnaliser une instance spécifique de l’éditeur de texte enrichi ou globalement.

Définir la police par défaut sur Calibri 11 points

Définissez ces propriétés defaultSupportedProps dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule (,).

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

Faire en sorte que la touche Entrée insère une nouvelle ligne au lieu d’un bloc de paragraphe

Par défaut, si vous appuyez sur la touche Entrée, un bloc de paragraphe avec la balise HTML <p> est créé. HTML utilise des blocs de paragraphe pour regrouper les informations, comme les paragraphes dans un document Word. Les navigateurs peuvent formater la balise <p> de manière légèrement différente ; par conséquent, pour la cohérence visuelle, vous souhaiterez peut-être utiliser la balise de nouvelle ligne ou de saut de ligne <br\> à la place.

Définissez cette propriété defaultSupportedProps dans votre fichier de configuration. Suivez cette valeur d’une virgule (,) sauf s’il s’agit de la dernière propriété du fichier.

"enterMode": 2,

Autoriser l’éditeur à utiliser le mode plein écran

Définissez ces propriétés individuelles dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule (,).

"showFullScreenExpander": true,

Capture d’écran de l’éditeur de texte enrichi, avec le contrôle d’extension du mode plein écran mis en surbrillance.

Autoriser l’affichage et la modification du contenu HTML

Pour permettre aux utilisateurs d’afficher et de modifier directement le HTML de leur contenu, affichez la balise HTML.

Définissez ces propriétés individuelles dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule (,).

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

Capture d’écran de l’éditeur de texte enrichi, avec le contrôle de l’onglet HTML mis en surbrillance.

Afficher une barre d’outils simplifiée ou la supprimer entièrement

Par défaut, la barre d’outils de l’éditeur contient tous les outils de mise en forme disponibles. Pour fournir une barre d’outils simplifiée, utilisez la propriété toolbar et spécifiez les outils que les utilisateurs peuvent utiliser pour mettre en forme leur contenu.

Définissez cette propriété defaultSupportedProps dans votre fichier de configuration. Suivez cette valeur d’une virgule (,) sauf s’il s’agit de la dernière propriété du fichier.

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

Capture d’écran de l’éditeur de texte enrichi, avec une barre d’outils simplifiée mise en surbrillance.

Pour supprimer entièrement la barre d’outils, définissez la valeur de toolbar sur « [] » (deux crochets).

Ajouter une nouvelle liste de polices et définir Brush Script MT 20 points comme police par défaut

Définissez ces propriétés defaultSupportedProps dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule (,).

"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"
},

Capture d’écran de l’éditeur de texte enrichi avec Brush Script comme police par défaut et une liste de nouvelles polices.

Positionner la barre d’outils en haut de l’éditeur de texte enrichi

Définissez cette propriété defaultSupportedProps dans votre fichier de configuration. Suivez cette valeur d’une virgule (,) sauf s’il s’agit de la dernière propriété du fichier.

"toolbarLocation": "top",

Démarrer l’éditeur à une hauteur de 30 pixels et augmenter pour l’adapter au contenu

Définissez ces propriétés defaultSupportedProps dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule (,).

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

Capture d’écran illustrant que la saisie dans la zone de texte enrichi ou le collage d’une image l’agrandit pour l’ajuster au contenu.

Fixer la hauteur de l’éditeur à 500 pixels

Définissez ces propriétés defaultSupportedProps dans votre fichier de configuration. Chaque valeur, à l’exception de la dernière, doit être suivie d’une virgule.

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

Capture d’écran qui illustre qu’avec une hauteur fixe, lorsqu’une quantité suffisante de contenu est ajoutée à la zone de texte enrichi, une barre de défilement apparaît.

Faire en sorte que le menu contextuel (clic droit) utilise le menu contextuel par défaut du navigateur

Pour remplacer le menu contextuel du contrôle de l’éditeur par le menu contextuel par défaut du navigateur, supprimez le plug-in contextmenu.

Définissez cette propriété defaultSupportedProps dans votre fichier de configuration. Suivez cette valeur d’une virgule (,) sauf s’il s’agit de la dernière propriété du fichier.

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

Barre d’outils de l’éditeur de texte enrichi

Le tableau suivant décrit les outils de mise en forme disponibles par défaut dans l’éditeur de texte enrichi.

Icon Nom Raccourci clavier Description
Reproduire la mise en forme. Copier la mise en forme Ctrl+Maj+C, Ctrl+Maj+V Appliquez l'apparence d'une section particulière à une autre section.
Police. Nom de la police Ctrl+Maj+F Sélectionnez une police. L’application considère la police sélectionnée comme police par défaut. Segoe UI est la police par défaut si vous n’en sélectionnez pas une.

Quand vous sélectionnez un contenu formaté, le nom de la police qui lui est appliqué s’affiche. Si votre sélection contient plusieurs polices, la première appliquée à la sélection s’affiche.
Taille de police. Taille de la police Ctrl+Maj+P Modifiez la taille de votre texte. L’application considère la taille de police sélectionnée comme taille par défaut. 12 est la taille par défaut si vous n’en sélectionnez pas une.

Quand vous sélectionnez un contenu formaté, la taille de police qui lui est appliquée s’affiche. Si votre sélection contient plusieurs tailles, la première appliquée à la sélection s’affiche.
Gras. Gras Ctrl+B Met votre texte en gras.
Italiques. Italique Ctrl+I Met votre texte en italique.
Souligner. Souligné Ctrl+U Souligne votre texte.
Couleur de surlignage du texte. Couleur d’arrière-plan Faites ressortir votre texte en le surlignant d’une couleur vive.
Couleur de police. Couleur de texte Modifiez la couleur de votre texte.
Puces. Insérer/Supprimer une liste à puces Crée une liste à puces.
Numérotation. Insérer/Supprimer une liste numérotée Créez une liste numérotée.
Réduire le retrait. Réduire le retrait Rapprochez votre paragraphe de la marge.
Augmenter le retrait. Augmenter le retrait Éloignez votre paragraphe de la marge.
Citation. Citation Appliquez un format de devis au niveau du bloc à votre contenu.
Aligner à gauche. Aligner à gauche Ctrl+L Alignez votre contenu avec la marge de gauche.
Aligner au centre. Aligner au centre Ctrl+E Centrez votre contenu sur la page.
Aligner à droite. Aligner à droite Ctrl+R Aligne votre contenu avec la marge de droite.
Lier. Lier Créez un lien dans votre document pour un accès rapide aux pages Web et aux autres ressources cloud. Saisissez ou collez le texte d’ancrage dans la zone Afficher le texte, puis saisissez ou collez l’URL dans la zone URL.

Si vous le souhaitez, sélectionnez un Type de lien et un protocole si le lien renvoie vers autre chose qu’une page Web. Pour spécifier où un lien de type URL doit s’ouvrir, sélectionnez l’onglet Cible, puis sélectionnez une Cible.

Une URL collée ou saisie est convertie automatiquement en lien. Par exemple, http://myexample.com devient <a href="http://myexample.com">http://myexample.com</a>.
Supprimer le lien. Supprimer le lien Supprimez le lien d’une ancre et convertissez-le en texte brut.
Exposant. Exposant Tapez des petites lettres juste au-dessus de la ligne de texte.
Indice. Indice Tapez des petites lettres juste sous la ligne de texte.
Barré. Barré Biffe le texte en traçant une ligne en travers.
Insérer une image. Image Pour insérer une image, collez-la de votre presse-papiers dans la zone de contenu ou faites glisser un fichier image d’un dossier vers la zone de contenu. Déplacez un angle de l’image pour la redimensionner. Le contrôle prend en charge les images .png, .jpg. et .gif.

Pour avoir plus de contrôle sur la source, l’apparence et le comportement de l’image, sélectionnez le bouton Image. Accédez au fichier image dans un dossier local ou saisissez son URL. Si l’image est stockée sur un serveur externe, saisissez le chemin d’accès absolu. S’il s’agit d’un serveur local, vous pouvez saisir un chemin relatif. Si vous le souhaitez, saisissez une hauteur et une largeur spécifiques pour redimensionner l’image, et sélectionnez un alignement. Vous devez également saisir un texte de remplacement pour décrire l’image pour les personnes qui utilisent des lecteurs d’écran.

Si l’image est également un lien vers une page Web ou une autre ressource cloud, saisissez l’URL de la ressource dans la zone URL cible et, si nécessaire, sélectionnez la Cible où le lien doit s’ouvrir.
De gauche à droite. Sens du texte de gauche à droite Modifiez le texte de gauche à droite. Il s’agit du paramètre par défaut.
De droite à gauche. Sens du texte de droite à gauche Modifiez le texte de droite à gauche pour un contenu linguistique bidirectionnel.
Annuler. Annuler Annulez la dernière modification que vous avez apportée au contenu.
Rétablir. Rétablir Annulez votre dernière annulation ou réappliquez la dernière modification que vous avez apportée au contenu.
Effacer toute la mise en forme. Supprimer la mise en forme Supprimez toute la mise en forme du texte sélectionné.
Table. Table Insérez une table avec le nombre de lignes et de colonnes sélectionnées. Pour avoir plus de contrôle sur la taille et l’apparence de la table, sélectionnez le bouton Table>Plus et modifiez ses propriétés. Vous pouvez également cliquer avec le bouton droit sur une table pour afficher et modifier ses propriétés.

Pour modifier la largeur d’une colonne, faites glisser sa bordure. Vous pouvez sélectionner une ou plusieurs cellules, lignes ou colonnes et appliquer une mise en forme spécifique, ajouter un lien au texte sélectionné et couper, copier et coller des lignes ou des colonnes entières.
Paramètres de personnalisation Définissez votre police et votre taille de police par défaut.
Aide sur l’accessibilité Alt + 0 Ouvrez la liste des raccourcis clavier que vous pouvez utiliser dans l’éditeur de texte enrichi.
Développez la barre d’outils. Étendre la barre d’outils Lorsque la fenêtre est trop étroite pour afficher la barre d’outils entière, sélectionnez pour étendre la barre d’outils sur une deuxième ligne.

Astuce

Pour utiliser le correcteur orthographique intégré de votre navigateur, appuyez sur la touche Ctrl tout en cliquant avec le bouton droit sur le texte que vous souhaitez vérifier. Sinon, le menu contextuel (clic droit) fournit une mise en forme contextuelle pour l’élément que vous sélectionnez.
Une alternative au correcteur orthographique intégré de votre navigateur est l’extension du navigateur Microsoft Editor. Microsoft Editor fonctionne de manière transparente avec le contrôle de l’éditeur de texte enrichi et, lorsqu’il est activé, fournit des fonctionnalités de grammaire et de vérification orthographique en ligne rapides et faciles.

Utiliser l’éditeur de texte enrichi en mode hors connexion

Le contrôle de l’éditeur de texte enrichi est disponible lorsque vous travaillez en mode hors connexion, mais sans certaines des fonctions et fonctionnalités auxquelles vous êtes habitué. Les images que vous chargez à l’aide de la configuration par défaut de l’éditeur ne sont pas disponibles lorsque vous travaillez en mode hors connexion.

Les plug-ins suivants sont disponibles dans l’éditeur de texte enrichi en mode hors connexion :

  • 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

Les plug-ins de mise en forme suivants sont disponibles dans l’éditeur de texte enrichi en mode hors connexion :

  • Gras, italique, souligné, listes à puces et numérotées, diminuer et augmenter le retrait, bloquer les guillemets, aligner à gauche, aligner au centre, aligner à droite, barré, texte bidirectionnel, annuler et rétablir et supprimer la mise en forme

Meilleures pratiques pour utiliser l’éditeur de texte enrichi

  • Les champs de texte enrichi stockent les balises HTML pour la mise en forme ainsi que les données saisies par l’utilisateur. Lorsque vous définissez la taille maximale des champs de texte enrichi, assurez-vous d’autoriser à la fois les balises HTML et les données de l’utilisateur.

  • Pour optimiser les performances, limitez votre contenu HTML à 1 Mo ou moins. Avec des tailles plus grandes, vous remarquerez peut-être des temps de réponse plus lents pour le chargement et la modification.

  • Dans la configuration par défaut, les images n’affectent pas négativement les performances car elles sont stockées séparément du contenu HTML. Cependant, les images sont stockées en tant que contenu base64 dans la colonne de texte lorsque l’utilisateur qui les charge ne dispose pas d’autorisations sur la table msdyn_richtextfiles. Le contenu Base64 est volumineux ; par conséquent, vous ne souhaitez généralement pas stocker les images dans le cadre du contenu de la colonne.

  • Si vous avez un rôle de sécurité Administrateur système ou Utilisateur de base, la fonction de personnalisation de l’utilisateur fonctionne par défaut. Si vous ne disposez pas de ces rôles, vous devez disposer des privilèges nécessaires pour créer, lire et écrire sur la table msdyn_customcontrolextendedsettings pour que le plug-in de personnalisation utilisateur fonctionne.

  • Dans la configuration par défaut de l’éditeur de texte enrichi, si vous glissez-déplacez un fichier image dans l’éditeur de texte enrichi, l’image en ligne est chargée dans la table msdyn_richtextfiles. Pour que les utilisateurs appropriés puissent afficher l’image en ligne, assurez-vous d’appliquer les autorisations correctes à msdyn_richtextfiles.

Limitations de l’éditeur de texte enrichi

Lorsque vous utilisez l’éditeur de texte enrichi, tenez compte des limitations répertoriées dans cette section. Pour les questions concernant la disponibilité des fonctionnalités, contactez le Service clientèle de Microsoft.

Important

L’éditeur de texte enrichi moderne est une nouvelle expérience. Pour que la fonctionnalité fonctionne correctement, vous devez supprimer la version classique. Sinon, vos modèles risquent de ne pas s’afficher correctement.

Les limitations de l’éditeur de texte enrichi comprennent :

  • Vous ne pouvez pas utiliser le contenu de l’éditeur de texte enrichi à partir de sources externes comme Microsoft Word, Excel, etc.
  • Les types de fichiers suivants sont pris en charge par défaut : .aac, .avi, .csv, .doc, .docx, .gif, .html, .jpeg, .mid, .midi, .mp3, .mp4, .mpeg, .msg, .pdf, .png, .ppt, .pptx, .svg, .txt, .vsd, .wav, .xls, .xlsm et .xlsx. Vous pouvez configurer les extensions autorisées pour votre environnement dans vos paramètres avancés en accédant à Administration>Général>Définir les extensions de fichier bloquées pour les pièces jointes et en supprimant les extensions que vous souhaitez autoriser.

Gestion des connaissances :

  • Un onglet d’aperçu n’est pas disponible actuellement.

Modèles et signatures de courrier électronique :

  • Si vous rencontrez un problème avec le rendu d’un modèle d’e-mail, nous vous recommandons de le recréer dans l’éditeur moderne.

Forum aux questions

Pourquoi les caractères saisis sont-ils lents à s’afficher ?

Si vous avez beaucoup de contenu dans l’éditeur, le temps de réponse peut augmenter. Maintenez le contenu à 1 Mo ou moins pour optimiser les performances. Les vérifications d'orthographe ou de grammaire peuvent également ralentir les performances de frappe.

Pourquoi ne puis-je pas charger une image ? Pourquoi l’aperçu de l’image ne se charge-t-il pas ?

Si le nom du fichier image, y compris le chemin d’accès, est long, le chargement du fichier peut échouer ou la version préliminaire peut ne pas s’afficher. Essayez de raccourcir le nom du fichier ou de le déplacer vers un emplacement avec un chemin d’accès plus court, puis chargez-le à nouveau.

Pourquoi est-ce que je vois du code HTML dans mon texte ?

Si le contrôle de l’éditeur de texte enrichi est utilisé dans une colonne qui n’est pas mise en forme pour le texte enrichi, le contenu apparaît dans le HTML sous-jacent plutôt que sous forme de texte mis en forme.

Quelle est la limite de taille du contenu HTML ?

Pour optimiser les performances, limitez votre contenu HTML à 1 Mo ou moins. Avec des tailles plus grandes, vous remarquerez peut-être des temps de réponse plus lents pour le chargement et la modification.

Capture d’écran du HTML qui apparaît dans la zone de contenu de l’éditeur.

Pour résoudre ce problème, assurez-vous que le format de la colonne est défini sur Texte enrichi.

J’ai dépassé la limite de caractères, mais il y a moins de caractères que la limite. Pourquoi ?

La base de données stocke l’ensemble de la mise en forme HTML, et pas seulement les caractères, ce qui prend de la place supplémentaire.

Pourquoi est-ce que je ne vois pas l’éditeur de texte enrichi moderne ?

Le contrôle de l’éditeur de texte enrichi moderne fait partie de la Nouvelle apparence pour les applications pilotées par modèle et n’apparaît que si le paramètre d’application est activé. Si le paramètre n’est pas activé, vous pouvez voir une ancienne version de l’éditeur.

Paramètre d’application Nouvelle apparence pour les applications pilotées par modèle