RichEdit

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.

React Blazor

Columnas de texto enriquecido

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.

React Blazor

Cualquier columna de texto de varias líneas

Ú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.

React Blazor

Imágenes

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.

React Blazor

Barra de herramientas condensada

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.

React Blazor
React Blazor
React Blazor

Tema

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.

Ejemplo

Un RichEdit encadernado a una columna de texto enriquecido, abierto en un documento de ejemplo.

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor

Opciones de configuración

Utiliza los controles a continuación para explorar las propiedades disponibles.

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor
DeshacerRehacerFormato de copiaFuenteTamaño de fuenteAudazCursivaSubrayadoTachadoColor de las mechasColor del textoLista con viñetasLista numeradaDisminución de la sangríaAumentar la sangríaCita bloqueadaAlinear a la izquierdaAlinear el centroAlinear a la derechaEnlaceEliminar enlaceSubíndiceSuperíndiceInsertar imagenDe izquierda a derechaDe derecha a izquierdaEliminar el formatoTabla de inserción
Reaccionar Blazor

RichEdit Clase

Parámetros

Nombre
Tipo
Default
Descripción
AllowImagesbool
True
Si se pueden insertar imágenes — desde la barra de herramientas, pegadas o sueltas. Por defecto true.
AutoFitHeightbool
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.
ChildContentRenderFragment?
Contenido hijo del componente
ColumnName*string
Nombre lógico de columna para vincular el editor desde el registro de la tabla.
CondensedToolbarButtonsIReadOnlyCollection<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.
Descriptionstring?
La descripción se mostrará en la descripción emergente.
Disabledbool?
¿Debería desactivar el editor?
DisplayLabelWhenAvailablebool
True
Especifica si mostrar una lable si está disponible.
DisplayToolbarbool
True
Si se muestra la barra de herramientas de formato. Por defecto es true.
DisplayTooltipWhenAvailablebool
True
Especifica si mostrar una descripción emergente si está disponible.
DisplayValidationErrorMessagebool
True
¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
IsVisiblebool
True
¿El editor es visible?
Labelstring?
El texto se mostrará como etiqueta para el editor.
LabelPositionEditorLabelPosition?
Donde se sitúa la etiqueta respecto al control. Cuando null (el valor por defecto) el editor toma la posición establecida en la columna de sección más cercana que encierra, sección o PageLayout, y EditorLabelPosition.Auto cuando ninguno lo configura.
MaxLengthint?
Longitud máxima del valor almacenado, formato incluido: lo que contiene la columna. Resuelto de los metadatos de la columna cuando no está activado.
MinLengthint?
Número mínimo de caracteres de texto — el texto, no su formato.
Placeholderstring?
Se muestra en el editor mientras está vacía.
ReadOnlybool?
¿Debería el editor ser solo lectura?
Requiredbool?
Si el valor es necesario.
Rowsint
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.
ToolbarButtonsIReadOnlyCollection<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.
ToolbarModeRichEditToolbarMode
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.
Valuestring?
Obtiene o establece el valor del editor: el HTML de la columna.
Nombre: AllowImages
Tipo: bool
Default: True
Descripción: Si se pueden insertar imágenes — desde la barra de herramientas, pegadas o sueltas. Por defecto true.
Nombre: AutoFitHeight
Tipo: bool
Default: False
Descripción: 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.
Nombre: ChildContent
Tipo: RenderFragment?
Descripción: Contenido hijo del componente
Nombre: ColumnName*
Tipo: string
Descripción: Nombre lógico de columna para vincular el editor desde el registro de la tabla.
Nombre: CondensedToolbarButtons
Tipo: IReadOnlyCollection<RichEditToolbarButton>?
Descripción: 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.
Nombre: Description
Tipo: string?
Descripción: La descripción se mostrará en la descripción emergente.
Nombre: Disabled
Tipo: bool?
Descripción: ¿Debería desactivar el editor?
Nombre: DisplayLabelWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una lable si está disponible.
Nombre: DisplayToolbar
Tipo: bool
Default: True
Descripción: Si se muestra la barra de herramientas de formato. Por defecto es true.
Nombre: DisplayTooltipWhenAvailable
Tipo: bool
Default: True
Descripción: Especifica si mostrar una descripción emergente si está disponible.
Nombre: DisplayValidationErrorMessage
Tipo: bool
Default: True
Descripción: ¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
Nombre: IsVisible
Tipo: bool
Default: True
Descripción: ¿El editor es visible?
Nombre: Label
Tipo: string?
Descripción: El texto se mostrará como etiqueta para el editor.
Nombre: LabelPosition
Tipo: EditorLabelPosition?
Descripción: Donde se sitúa la etiqueta respecto al control. Cuando null (el valor por defecto) el editor toma la posición establecida en la columna de sección más cercana que encierra, sección o PageLayout, y EditorLabelPosition.Auto cuando ninguno lo configura.
Nombre: MaxLength
Tipo: int?
Descripción: Longitud máxima del valor almacenado, formato incluido: lo que contiene la columna. Resuelto de los metadatos de la columna cuando no está activado.
Nombre: MinLength
Tipo: int?
Descripción: Número mínimo de caracteres de texto — el texto, no su formato.
Nombre: Placeholder
Tipo: string?
Descripción: Se muestra en el editor mientras está vacía.
Nombre: ReadOnly
Tipo: bool?
Descripción: ¿Debería el editor ser solo lectura?
Nombre: Required
Tipo: bool?
Descripción: Si el valor es necesario.
Nombre: Rows
Tipo: int
Default: 10
Descripción: 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.
Nombre: ToolbarButtons
Tipo: IReadOnlyCollection<RichEditToolbarButton>?
Descripción: 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.
Nombre: ToolbarMode
Tipo: RichEditToolbarMode
Default: Full
Descripción: 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.
Nombre: Value
Tipo: string?
Descripción: Obtiene o establece el valor del editor: el HTML de la columna.

Eventos

Nombre
Tipo
Descripción
ValueChangedEventCallback<ColumnValueBase>
Recibe o establece una callback que actualiza el valor vinculado.
Nombre: ValueChanged
Tipo: EventCallback<ColumnValueBase>
Descripción: Recibe o establece una callback que actualiza el valor vinculado.

Métodos

Nombre
Parámetros
Tipo
Descripción
FocusAsyncTask
Pone el cursor en el editor.
GetValidationErrorsList<string>
Devuelve errores de validación para el valor actual: el mínimo cuenta el texto, el máximo cuenta lo que se almacena.
OnImageErrorstring fileName
string reason
void
JS → C#: una imagen que el usuario eligió no se pudo insertar. Dijo bajo el editor.
OnStateChangedJsonElement state
void
JS → C#: lo que muestra la barra de herramientas cambió — la selección se movió o su formato también.
OnValueChangedstring value
Task
JS → C#: el documento cambió. Lleva el valor a almacenar, o nulo cuando está vacío.
UploadImageAsyncIJSStreamReference image
string fileName
long size
Task<string>
JS → C#: almacena una imagen que el usuario insertó como un registro msdyn_richtextfile y devuelve su id — o null cuando el usuario puede no crear uno o leerlo, y el la imagen se conserva en el documento en su lugar.
Nombre: FocusAsync
Tipo: Task
Descripción: Pone el cursor en el editor.
Nombre: GetValidationErrors
Tipo: List<string>
Descripción: Devuelve errores de validación para el valor actual: el mínimo cuenta el texto, el máximo cuenta lo que se almacena.
Nombre: OnImageError
Parámetros: string fileName
string reason
Tipo: void
Descripción: JS → C#: una imagen que el usuario eligió no se pudo insertar. Dijo bajo el editor.
Nombre: OnStateChanged
Parámetros: JsonElement state
Tipo: void
Descripción: JS → C#: lo que muestra la barra de herramientas cambió — la selección se movió o su formato también.
Nombre: OnValueChanged
Parámetros: string value
Tipo: Task
Descripción: JS → C#: el documento cambió. Lleva el valor a almacenar, o nulo cuando está vacío.
Nombre: UploadImageAsync
Parámetros: IJSStreamReference image
string fileName
long size
Tipo: Task<string>
Descripción: JS → C#: almacena una imagen que el usuario insertó como un registro msdyn_richtextfile y devuelve su id — o null cuando el usuario puede no crear uno o leerlo, y el la imagen se conserva en el documento en su lugar.