El RichEdit componente es un editor de texto enriquecido para columnas de texto multilínea de Dataverse. Ofrece el formato que ofrece el propio editor de texto enriquecido de Dynamics — fuentes y tamaños, colores, listas, sangrías, alineamiento, enlaces, imágenes y tablas — y lo escribe tal y como lo escribe Dynamics, de modo que un documento editado en tu portal y en una aplicación basada en modelos se ve igual en ambos. Está dibujado con los controles propios de Fluent UI y sigue tu tema.
<RichEdit columnName="ppp_richdescription" /><RichEdit ColumnName="ppp_richdescription" />Una columna cuyo formato en Dataverse es texto enriquecido no necesita nada extra: ColumnEdit se renderiza RichEdit un para ella, con su etiqueta, límite de longitud, nivel requerido y permisos tomados de la columna como cualquier otro editor.
<ColumnEdit columnName="ppp_richdescription" /><ColumnEdit ColumnName="ppp_richdescription" />Úsalo RichEdit directamente para editar cualquier otra columna de texto de varias líneas como texto enriquecido. Su valor es entonces el HTML del documento. Las cuadrículas y exportaciones muestran el texto de dicha columna sin su formato.
<RichEdit columnName="description" /><RichEdit ColumnName="description" />Las imágenes pueden insertarse desde la barra de herramientas, pegarse o eliminarse. Se almacenan como Dynamics las almacena, en msdyn_richtextfile registros, cuando el usuario puede crearlas y leerlas — concede permisos en tu tabla. Sin ese permiso, una imagen se mantiene en el propio documento. Configura AllowImages para false desactivar imágenes.
<RichEdit columnName="ppp_richdescription" allowImages={false} /><RichEdit ColumnName="ppp_richdescription" AllowImages="false" />Configurado ToolbarMode en Condensed para un editor con poco espacio, o para texto corto como una nota: la barra de herramientas muestra solo el formato más utilizado — deshacer y rehacer, negrita, cursiva, subrayado, tachado, resaltado y colores de texto, listas con viñetas y numeradas, y enlaces — y un botón al final que lo abre a cada otro botón y lo cierra de nuevo. Nombra otros botones con CondensedToolbarButtons (Reaccionar: condensedToolbarButtons), una lista de RichEditToolbarButton valores: la barra de herramientas muestra esos en el orden en que los dibuja la barra completa. Limita la barra de herramientas en sí, completa o condensada, a los botones nombrados en ToolbarButtons (Reaccionar: toolbarButtons); limita los botones, no el formato, así que los atajos de teclado y el texto pegado siguen formateando. Configura DisplayToolbar para false que no muestre ninguna barra de herramientas.
<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]" />El borde, la barra de herramientas y el indicador de enfoque del editor usan los tokens de diseño de Fluent UI, por lo que coinciden con los otros editores en temas claros y oscuros y con el color de tu acento. El formato propio de un documento —sus fuentes y colores— se muestra tal y como está escrito, tal y como lo muestra Dynamics.
Un RichEdit encadernado a una columna de texto enriquecido, abierto en un documento de ejemplo.
Utiliza los controles a continuación para explorar las propiedades disponibles.
Nombre | Tipo | Default | Descripción |
|---|---|---|---|
AllowImages | bool | True | Si se pueden insertar imágenes — desde la barra de herramientas, pegadas o sueltas. Por defecto true. |
AutoFitHeight | bool | False | Si el área de edición encaja con su contenido — de una línea hasta RichEdit.Rows, entonces desplazamiento — en lugar de estar siempre RichEdit.Rows con líneas de altura. Por defecto a false. |
ChildContent | RenderFragment? | Contenido hijo del componente | |
ColumnName* | string | Nombre lógico de columna para vincular el editor desde el registro de la tabla. | |
CondensedToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Los botones que muestra una barra de herramientas condensada ( RichEditToolbarMode.Condensed), dibujados en el orden en que la barra de herramientas completa los dibuja, sea cual sea el orden en que se nombren; el botón al final Aún lo abre al resto de RichEdit.ToolbarButtons. No está puesto ni vacío, el Formato más utilizado (RichEdit.DefaultCondensedToolbarButtons): deshacer y rehacer, negrita, cursiva, subrayado, tachado, colores resaltados y de texto, listas con viñetas y numeradas, y enlaces. | |
Description | string? | La descripción se mostrará en la descripción emergente. | |
Disabled | bool? | ¿Debería desactivar el editor? | |
DisplayLabelWhenAvailable | bool | True | Especifica si mostrar una lable si está disponible. |
DisplayToolbar | bool | True | Si se muestra la barra de herramientas de formato. Por defecto es true. |
DisplayTooltipWhenAvailable | bool | True | Especifica si mostrar una descripción emergente si está disponible. |
DisplayValidationErrorMessage | bool | True | ¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación? |
IsVisible | bool | True | ¿El editor es visible? |
Label | string? | El texto se mostrará como etiqueta para el editor. | |
LabelPosition | EditorLabelPosition? | Donde se sitúa la etiqueta respecto al control. Cuando null (el valor por defecto) el editor toma la posición establecida en la EditorLabelPosition.Auto cuando ninguno lo configura. | |
MaxLength | int? | Longitud máxima del valor almacenado, formato incluido: lo que contiene la columna. Resuelto de los metadatos de la columna cuando no está activado. | |
MinLength | int? | Número mínimo de caracteres de texto — el texto, no su formato. | |
Placeholder | string? | Se muestra en el editor mientras está vacía. | |
ReadOnly | bool? | ¿Debería el editor ser solo lectura? | |
Required | bool? | Si el valor es necesario. | |
Rows | int | 10 | Altura del área de edición en líneas de texto, por mucho que ocupe el documento; más largo El contenido se desplaza. Con RichEdit.AutoFitHeight, el máximo que crece a. Por defecto es 10. |
ToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Los únicos botones que muestra la barra de herramientas, ya sean completos o condensados, se dibujan en el orden de la barra de herramientas completa los dibuja. Una barra de herramientas condensada muestra aquellos que RichEdit.CondensedToolbarButtons son aquí, y se abre al resto de estos; sin ninguno que muestre, no tiene botón para abrirlo fuera. Limita los botones, no el formato: atajos de teclado y texto pegado formato. No fijado ni vacío, todos los botones están mostrados. | |
ToolbarMode | RichEditToolbarMode | Full | Cuánto de la barra de herramientas se muestra: cada botón, o el formato que más se usa con un botón que muestra el resto ( RichEditToolbarMode.Condensed). Por defecto RichEditToolbarMode.Full. |
Value | string? | Obtiene o establece el valor del editor: el HTML de la columna. |
AllowImagestrue.AutoFitHeightRichEdit.Rows, entonces desplazamiento — en lugar de estar siempre RichEdit.Rows con líneas de altura. Por defecto a false.ChildContentColumnName*CondensedToolbarButtonsRichEditToolbarMode.Condensed), dibujados en el orden en que la barra de herramientas completa los dibuja, sea cual sea el orden en que se nombren; el botón al final Aún lo abre al resto de RichEdit.ToolbarButtons. No está puesto ni vacío, el Formato más utilizado (RichEdit.DefaultCondensedToolbarButtons): deshacer y rehacer, negrita, cursiva, subrayado, tachado, colores resaltados y de texto, listas con viñetas y numeradas, y enlaces.DescriptionDisabledDisplayLabelWhenAvailableDisplayToolbartrue.DisplayTooltipWhenAvailableDisplayValidationErrorMessageIsVisibleLabelLabelPositionnull (el valor por defecto) el editor toma la posición establecida en la EditorLabelPosition.Auto cuando ninguno lo configura.MaxLengthMinLengthPlaceholderReadOnlyRequiredRowsRichEdit.AutoFitHeight, el máximo que crece a. Por defecto es 10.ToolbarButtonsRichEdit.CondensedToolbarButtons son aquí, y se abre al resto de estos; sin ninguno que muestre, no tiene botón para abrirlo fuera. Limita los botones, no el formato: atajos de teclado y texto pegado formato. No fijado ni vacío, todos los botones están mostrados.ToolbarModeRichEditToolbarMode.Condensed). Por defecto RichEditToolbarMode.Full.ValueNombre | Tipo | Descripción |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | Recibe o establece una callback que actualiza el valor vinculado. |
ValueChangedNombre | Parámetros | Tipo | Descripción |
|---|---|---|---|
FocusAsync | Task | Pone el cursor en el editor. | |
GetValidationErrors | List<string> | Devuelve errores de validación para el valor actual: el mínimo cuenta el texto, el máximo cuenta lo que se almacena. | |
OnImageError | string fileName string reason | void | JS → C#: una imagen que el usuario eligió no se pudo insertar. Dijo bajo el editor. |
OnStateChanged | JsonElement state | void | JS → C#: lo que muestra la barra de herramientas cambió — la selección se movió o su formato también. |
OnValueChanged | string value | Task | JS → C#: el documento cambió. Lleva el valor a almacenar, o nulo cuando está vacío. |
UploadImageAsync | IJSStreamReference image string fileName long size | Task<string> | JS → C#: almacena una imagen que el usuario insertó como un null cuando el usuario puede no crear uno o leerlo, y el la imagen se conserva en el documento en su lugar. |
FocusAsyncGetValidationErrorsOnImageErrorOnStateChangedOnValueChangedUploadImageAsyncnull cuando el usuario puede no crear uno o leerlo, y el la imagen se conserva en el documento en su lugar.