O RichEdit componente é um editor de texto enriquecido para colunas de texto multilinha do Dataverse. Ele oferece a formatação que o próprio editor de texto enriquecido da Dynamics oferece — fontes e tamanhos, cores, listas, indents, alinhamento, links, imagens e tabelas — e escreve da mesma forma que a Dynamics escreve, de modo que um documento editado no seu portal e em um aplicativo orientado a modelos seja igual em ambos. Ele é desenhado com os próprios controles da Fluent UI e segue seu tema.
<RichEdit columnName="ppp_richdescription" /><RichEdit ColumnName="ppp_richdescription" />Uma coluna cujo formato no Dataverse é texto enriquecido não precisa de nada extra: ColumnEdit renderiza um RichEdit para ela, com seu rótulo, limite de comprimento, nível exigido e permissões retiradas da coluna, como qualquer outro editor.
<ColumnEdit columnName="ppp_richdescription" /><ColumnEdit ColumnName="ppp_richdescription" />Use RichEdit diretamente para editar qualquer outra coluna de texto de várias linhas como texto enriquecido. Seu valor é então o HTML do documento. Grades e exportações mostram o texto dessa coluna sem sua formatação.
<RichEdit columnName="description" /><RichEdit ColumnName="description" />Imagens podem ser inseridas da barra de ferramentas, coladas ou descartadas. Elas são armazenadas como o Dynamics as armazena, em msdyn_richtextfile registros, quando o usuário pode criá-los e ler — conceda permissões na sua tabela. Sem essa permissão, uma imagem é mantida no próprio documento. Configurado AllowImages para false desligar imagens.
<RichEdit columnName="ppp_richdescription" allowImages={false} /><RichEdit ColumnName="ppp_richdescription" AllowImages="false" />Defina ToolbarMode para Condensed um editor com pouco espaço, ou para texto curto como uma nota: a barra de ferramentas então mostra apenas a formatação mais usada — desfazer e refazer, negrito, itálico, sublinhado, riscado, destaque e cores do texto, listas com marcadores e numeradas, e links — e um botão no final que abre para cada dois botões e fecha novamente. Nomeie outros botões com CondensedToolbarButtons (Reagir: condensedToolbarButtons), uma lista de RichEditToolbarButton valores: a barra de ferramentas mostra esses botões, na ordem em que a barra de ferramentas completa os desenha. Limite a própria barra de ferramentas, completa ou condensada, aos botões nomeados em ToolbarButtons (Reagir: toolbarButtons); ela limita os botões, não a formatação, então atalhos de teclado e texto colado ainda formatam. Defina DisplayToolbar para false não mostrar nenhuma barra de ferramenta.
<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]" />A borda, barra de ferramentas e indicador de foco do editor usam os tokens de design do Fluent UI, então eles combinam com os outros editores em temas claros e escuros e com a cor de destaque. A formatação própria de um documento — suas fontes e cores — é mostrada como escrita, conforme o Dynamics mostra.
Um RichEdit encadernado em uma coluna de texto enriquecido, aberto em um documento de exemplo.
Use os controles abaixo para explorar as propriedades disponíveis.
Nome | Tipo | Padrão | Descrição |
|---|---|---|---|
AllowImages | bool | True | Se as imagens podem ser inseridas — da barra de ferramentas, coladas ou soltas. Padrão para true. |
AutoFitHeight | bool | False | Se a área de edição se encaixa no conteúdo — de uma linha até RichEdit.Rows, então rolando — em vez de sempre ter RichEdit.Rows linhas de altura. Padrão para false. |
ChildContent | RenderFragment? | Conteúdo filho do componente | |
ColumnName* | string | Nome lógico da coluna para vincular o editor a partir do registro da tabela. | |
CondensedToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Os botões que uma barra de ferramentas condensada mostra ( RichEditToolbarMode.Condensed), desenhados em a ordem em que a barra de ferramentas completa os desenha, seja qual for a ordem em que sejam nomeados; o botão no final Ainda abre para o restante de RichEdit.ToolbarButtons. Não está definido ou vazio, o formatação mais usada (RichEdit.DefaultCondensedToolbarButtons): desfazer e refazer, negrito, itálico, sublinhado, riscado, cores de destaque e texto, listas com marcadores e numeradas, e Links. | |
Description | string? | Descrição será exibida na dica de ferramenta. | |
Disabled | bool? | Caso o editor esteja desativado. | |
DisplayLabelWhenAvailable | bool | True | Especifica se deve exibir uma lable, se disponível. |
DisplayToolbar | bool | True | Se a barra de ferramentas de formatação é mostrada. Padrão para true. |
DisplayTooltipWhenAvailable | bool | True | Especifica se deve exibir uma dica de ferramenta, se disponível. |
DisplayValidationErrorMessage | bool | True | Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação? |
IsVisible | bool | True | O editor é visível? |
Label | string? | Texto para ser exibido como um rótulo para o editor. | |
LabelPosition | EditorLabelPosition? | Onde o rótulo fica em relação ao controle. Quando null (o padrão) o editor assume a posição definida na EditorLabelPosition.Auto quando não existe um configura. | |
MaxLength | int? | Comprimento máximo do valor armazenado, formatação incluída: o que a coluna contém. Resolvido a partir dos metadados da coluna quando não está definido. | |
MinLength | int? | Número mínimo de caracteres de texto — o texto, não sua formatação. | |
Placeholder | string? | Mostrado no editor enquanto está vazio. | |
ReadOnly | bool? | O editor deve ser somente leitura. | |
Required | bool? | Se o valor for necessário. | |
Rows | int | 10 | Altura da área de edição em linhas de texto, quanto o documento preenche; mais longo Rolagem de conteúdo. Com RichEdit.AutoFitHeight, o máximo que cresce para. Padrão é 10. |
ToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | Os únicos botões que a barra de ferramentas mostra, cheios ou condensados, são desenhados na ordem da barra de ferramentas completa os desenha. Uma barra de ferramentas condensada mostra aqueles RichEdit.CondensedToolbarButtons que são aqui, e se abre para o resto destes; sem nenhum para mostrar, não tem botão para abri-lo fora. Limita os botões, não a formatação: atalhos de teclado e texto colado ainda formatar. Não está definido ou vazio, todos os botões são mostrados. | |
ToolbarMode | RichEditToolbarMode | Full | Quanto da barra de ferramentas é mostrado: cada botão, ou a formatação mais usada com um botão que mostra o restante ( RichEditToolbarMode.Condensed). Define para RichEditToolbarMode.Full. |
Value | string? | Recebe ou define o valor do editor: o HTML da coluna. |
AllowImagestrue.AutoFitHeightRichEdit.Rows, então rolando — em vez de sempre ter RichEdit.Rows linhas de altura. Padrão para false.ChildContentColumnName*CondensedToolbarButtonsRichEditToolbarMode.Condensed), desenhados em a ordem em que a barra de ferramentas completa os desenha, seja qual for a ordem em que sejam nomeados; o botão no final Ainda abre para o restante de RichEdit.ToolbarButtons. Não está definido ou vazio, o formatação mais usada (RichEdit.DefaultCondensedToolbarButtons): desfazer e refazer, negrito, itálico, sublinhado, riscado, cores de destaque e texto, listas com marcadores e numeradas, e Links.DescriptionDisabledDisplayLabelWhenAvailableDisplayToolbartrue.DisplayTooltipWhenAvailableDisplayValidationErrorMessageIsVisibleLabelLabelPositionnull (o padrão) o editor assume a posição definida na EditorLabelPosition.Auto quando não existe um configura.MaxLengthMinLengthPlaceholderReadOnlyRequiredRowsRichEdit.AutoFitHeight, o máximo que cresce para. Padrão é 10.ToolbarButtonsRichEdit.CondensedToolbarButtons que são aqui, e se abre para o resto destes; sem nenhum para mostrar, não tem botão para abri-lo fora. Limita os botões, não a formatação: atalhos de teclado e texto colado ainda formatar. Não está definido ou vazio, todos os botões são mostrados.ToolbarModeRichEditToolbarMode.Condensed). Define para RichEditToolbarMode.Full.ValueNome | Tipo | Descrição |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | Recebe ou define um callback que atualiza o valor vinculado. |
ValueChangedNome | Parâmetros | Tipo | Descrição |
|---|---|---|---|
FocusAsync | Task | Coloca o cursor no editor. | |
GetValidationErrors | List<string> | Retorna erros de validação para o valor atual: o mínimo conta o texto, o máximo conta o que está armazenado. | |
OnImageError | string fileName string reason | void | JS → C#: uma imagem escolhida pelo usuário não pôde ser inserida. Disse no editor. |
OnStateChanged | JsonElement state | void | JS → C#: o que a barra de ferramentas mostra mudou — a seleção foi movida ou a formatação mudou. |
OnValueChanged | string value | Task | JS → C#: o documento mudou. Carrega o valor a armazenar, ou nulo quando vazio. |
UploadImageAsync | IJSStreamReference image string fileName long size | Task<string> | JS → C#: armazena uma imagem que o usuário inseriu como um null quando o usuário pode não criar um ou relê-lo, e o a imagem é mantida no documento em vez disso. |
FocusAsyncGetValidationErrorsOnImageErrorOnStateChangedOnValueChangedUploadImageAsyncnull quando o usuário pode não criar um ou relê-lo, e o a imagem é mantida no documento em vez disso.