Ce RichEdit composant est un éditeur de texte enrichi pour les colonnes de texte multi-lignes Dataverse. Il propose la mise en forme propre à l’éditeur de texte enrichi de Dynamics — polices et tailles, couleurs, listes, indentations, alignement, liens, images et tables — et écrit comme Dynamics le fait, de sorte qu’un document édité dans votre portail et dans une application pilotée par modèle ressemble dans les deux cas. Il est dessiné avec les propres contrôles de Fluent UI et suit votre thème.
<RichEdit columnName="ppp_richdescription" /><RichEdit ColumnName="ppp_richdescription" />Une colonne dont le format dans Dataverse est du texte enrichi n’a besoin d’aucun élément supplémentaire : ColumnEdit elle se RichEdit rend pour elle, avec son étiquette, sa limite de longueur, son niveau requis et ses permissions prises de la colonne comme n’importe quel autre éditeur.
<ColumnEdit columnName="ppp_richdescription" /><ColumnEdit ColumnName="ppp_richdescription" />Utilisez RichEdit directement pour modifier toute autre colonne de texte multiligne en texte enrichi. Sa valeur est alors le HTML du document. Les grilles et exportations affichent le texte d’une telle colonne sans sa mise en forme.
<RichEdit columnName="description" /><RichEdit ColumnName="description" />Les images peuvent être insérées depuis la barre d’outils, collées ou déposées. Elles sont stockées sous forme de stockage par Dynamics, dans msdyn_richtextfile des enregistrements, lorsque l’utilisateur peut les créer et les lire — accordez-les dans votre tableau. Sans cette permission, une image est conservée dans le document lui-même. Réglez AllowImages pour false désactiver les images.
<RichEdit columnName="ppp_richdescription" allowImages={false} /><RichEdit ColumnName="ppp_richdescription" AllowImages="false" />Réglez ToolbarMode sur Condensed pour un éditeur avec peu de place, ou pour un texte court comme une note : la barre d’outils affiche alors uniquement la mise en forme la plus utilisée — annuler et refaire, gras, italique, souligner, rayer, surligner et couleurs de texte, listes à puces et numérotées, et liens — et un bouton à la fin qui ouvre la mise en place sur deux boutons, puis la referme. Nommez les autres boutons avec CondensedToolbarButtons (Réagir : condensedToolbarButtons), une liste de RichEditToolbarButton valeurs : la barre d’outils les affiche, dans l’ordre dans lequel la barre d’outils complète les dessine. Limitez la barre d’outils elle-même, complète ou condensée, aux boutons nommés dans ToolbarButtons (Réagir : toolbarButtons) ; cela limite les boutons, pas la mise en forme, donc les raccourcis clavier et le texte collé continuent de formater. Réglez DisplayToolbar pour false n’afficher aucune barre d’outils du tout.
<RichEdit columnName="ppp_richdescription" toolbarMode={RichEditToolbarMode.Condensed} /><RichEdit ColumnName="ppp_richdescription" ToolbarMode="RichEditToolbarMode.Condensed" /><RichEdit columnName="ppp_richdescription"
toolbarMode={RichEditToolbarMode.Condensed}
condensedToolbarButtons={[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Link]} /><RichEdit ColumnName="ppp_richdescription"
ToolbarMode="RichEditToolbarMode.Condensed"
CondensedToolbarButtons="[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Link]" /><RichEdit columnName="ppp_richdescription"
toolbarButtons={[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Underline, RichEditToolbarButton.Link]} /><RichEdit ColumnName="ppp_richdescription"
ToolbarButtons="[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Underline, RichEditToolbarButton.Link]" />La bordure, la barre d’outils et l’indicateur de mise au point de l’éditeur utilisent les jetons de design de Fluent UI, afin qu’ils correspondent aux autres éditeurs dans les thèmes clairs et sombres et avec la couleur d’accent. La mise en forme propre d’un document — ses polices et ses couleurs — est affichée telle qu’écrite, telle que Dynamics.
Un RichEdit lien à une colonne en texte enrichi, ouvert sur un document d’exemple.
Utilisez les commandes ci-dessous pour explorer les propriétés disponibles.
Nom | Type | Par défaut | Description |
|---|---|---|---|
AllowImages | bool | True | Que des images puissent être insérées — depuis la barre d’outils, collées ou supprimées. Par défaut : true. |
AutoFitHeight | bool | False | Que la zone de montage corresponde à son contenu — d’une ligne à RichEdit.Rows, alors défilement — plutôt que d’être RichEdit.Rows toujours en hauteur de lignes. Par défaut à false. |
ChildContent | RenderFragment? | Contenu enfant du composant | |
ColumnName* | string | Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table. | |
CondensedToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Les boutons affichés par une barre d’outils condensée ( RichEditToolbarMode.Condensed), dessinés dans l’ordre dans lequel la barre d’outils complète les dessine, quel que soit l’ordre dans lequel elles sont nommées ; le bouton à sa fin Toujours ouvert sur le reste de RichEdit.ToolbarButtons. Ni posé ni vide, le formatage le plus utilisé (RichEdit.DefaultCondensedToolbarButtons : annuler et refaire, gras, italique, souligné, rayé, surligné et couleurs de texte, listes à puces et numérotées, et Liens. | |
Description | string? | Description à afficher dans l’infobulle. | |
Disabled | bool? | Si l’éditeur est désactivé. | |
DisplayLabelWhenAvailable | bool | True | Précise s’il faut afficher une étiquette si disponible. |
DisplayToolbar | bool | True | Si la barre d’outils de mise en forme est affichée. Par défaut, . true |
DisplayTooltipWhenAvailable | bool | True | Précise s’il faut afficher une infobulle si disponible. |
DisplayValidationErrorMessage | bool | True | Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ? |
IsVisible | bool | True | L’éditeur est-il visible ? |
Label | string? | Le texte doit être affiché comme une étiquette pour l’éditeur. | |
LabelPosition | EditorLabelPosition? | Là où l’étiquette se situe par rapport au contrôle. Quand null (par défaut) le l’éditeur prend la position définie sur la EditorLabelPosition.Auto quand il n’y en a pas un. | |
MaxLength | int? | Longueur maximale de la valeur stockée, formatage inclus : ce que contient la colonne. Résolu à partir des métadonnées de la colonne lorsqu’elle n’est pas définie. | |
MinLength | int? | Nombre minimum de caractères de texte — le texte, pas sa mise en forme. | |
Placeholder | string? | Affiché dans l’éditeur pendant qu’il est vide. | |
ReadOnly | bool? | L’éditeur devrait-il être en lecture seule ? | |
Required | bool? | Si la valeur est requise. | |
Rows | int | 10 | La hauteur de la zone d’édition en lignes de texte, quelle que soit la quantité de contenu du document ; plus longue Le contenu défile. Avec RichEdit.AutoFitHeight, le maximum qu’il atteint . Par défaut est 10. |
ToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Les seuls boutons affichés par la barre d’outils, en entier ou condensé, sont dessinés dans l’ordre de la barre d’outils complète les dessine. Une barre d’outils condensée affiche celles de RichEdit.CondensedToolbarButtons qui sont ici, et s’ouvre sur le reste ; sans aucun à afficher, il n’y a pas de bouton pour l’ouvrir fini. Il limite les boutons, pas la mise en forme : raccourcis clavier et texte collé quand même format. Ni défini ni vide, chaque bouton est affiché. | |
ToolbarMode | RichEditToolbarMode | Full | Quelle part de la barre d’outils est affichée : chaque bouton, ou la mise en forme la plus utilisée avec un bouton qui montre le reste ( RichEditToolbarMode.Condensed). Par défaut à RichEditToolbarMode.Full. |
Value | string? | Obtient ou définit la valeur de l’éditeur : le HTML de la colonne. |
AllowImagestrue.AutoFitHeightRichEdit.Rows, alors défilement — plutôt que d’être RichEdit.Rows toujours en hauteur de lignes. Par défaut à false.ChildContentColumnName*CondensedToolbarButtonsRichEditToolbarMode.Condensed), dessinés dans l’ordre dans lequel la barre d’outils complète les dessine, quel que soit l’ordre dans lequel elles sont nommées ; le bouton à sa fin Toujours ouvert sur le reste de RichEdit.ToolbarButtons. Ni posé ni vide, le formatage le plus utilisé (RichEdit.DefaultCondensedToolbarButtons : annuler et refaire, gras, italique, souligné, rayé, surligné et couleurs de texte, listes à puces et numérotées, et Liens.DescriptionDisabledDisplayLabelWhenAvailableDisplayToolbartrueDisplayTooltipWhenAvailableDisplayValidationErrorMessageIsVisibleLabelLabelPositionnull (par défaut) le l’éditeur prend la position définie sur la EditorLabelPosition.Auto quand il n’y en a pas un.MaxLengthMinLengthPlaceholderReadOnlyRequiredRowsRichEdit.AutoFitHeight, le maximum qu’il atteint . Par défaut est 10.ToolbarButtonsRichEdit.CondensedToolbarButtons qui sont ici, et s’ouvre sur le reste ; sans aucun à afficher, il n’y a pas de bouton pour l’ouvrir fini. Il limite les boutons, pas la mise en forme : raccourcis clavier et texte collé quand même format. Ni défini ni vide, chaque bouton est affiché.ToolbarModeRichEditToolbarMode.Condensed). Par défaut à RichEditToolbarMode.Full.ValueNom | Type | Description |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | Obtient ou définit un callback qui met à jour la valeur liée. |
ValueChangedNom | Paramètres | Type | Description |
|---|---|---|---|
FocusAsync | Task | Ça place le curseur dans l’éditeur. | |
GetValidationErrors | List<string> | Retourne des erreurs de validation pour la valeur courante : le minimum compte le texte, le maximum compte ce qui est stocké. | |
OnImageError | string fileName string reason | void | JS → C# : une image choisie par l’utilisateur n’a pas pu être insérée. Dit sous l’éditeur. |
OnStateChanged | JsonElement state | void | JS → C# : ce que montre la barre d’outils a changé — la sélection a été déplacée ou sa mise en forme a changé. |
OnValueChanged | string value | Task | JS → C# : le document a changé. Contient la valeur à stocker, ou nul lorsqu’il est vide. |
UploadImageAsync | IJSStreamReference image string fileName long size | Task<string> | JS → C# : stocke une image que l’utilisateur a insérée comme un null lorsque l’utilisateur ne peut pas en créer un ou ne pas le relire, et le l’image est conservée dans le document à la place. |
FocusAsyncGetValidationErrorsOnImageErrorOnStateChangedOnValueChangedUploadImageAsyncnull lorsque l’utilisateur ne peut pas en créer un ou ne pas le relire, et le l’image est conservée dans le document à la place.