Adicionar o controle rich text editor a um aplicativo baseado em modelo
O controle rich text editor oferece ao usuário do aplicativo uma área de edição WYSIWYG para formatar texto. O formato de entrada e de saída do controle é HTML. O controle permite que um rich-text copiado, por exemplo, de um navegador da Web ou do Word, seja colado nele.
Algumas das opções de formatação disponíveis são:
- Negrito, itálico, sublinhado e tachado
- Cor do texto, cor de realce
- Tipo e tamanho da fonte
- Listas numeradas e listas com marcadores
- Hiperlinks
- Tabelas
- Imagens
Para obter uma lista completa das opções padrão, consulte Usar a barra de ferramentas do editor de rich text.
Adicionar ou substituir uma coluna de texto para edição de rich text
Crie uma nova coluna de texto e configure o controle ou substitua uma coluna de texto existente. O controle rich text editor pode ser usado com colunas de texto de uma ou várias linhas.
Configuração simples
Para habilitar o editor de rich text com valores padrão em qualquer coluna de texto nova ou existente, você pode definir a opção Formato como Rich text seguindo as etapas abaixo. Mais informações sobre valores padrão: Usar o recurso da Web padrão para alterações em toda a organização
Entre no Power Apps.
Observação
Se você tiver um campo rich text existente, poderá usar a API para alterar o formato para
Richtext. Mais informações: Conversões de formato do tipo de dadosNo painel de navegação esquerdo, selecione Soluções, abra a solução desejada, abra a tabela desejada e selecione a área Colunas.
Selecione +Adicionar > Coluna, digite um nome para a sua coluna, selecione o tipo Dados e depois selecione a opção de formato Rich-text.
Salve a coluna. Agora você pode adicionar a nova coluna a qualquer formulário novo ou existente para esta tabela.
Configuração avançada
O controle rich text editor vem com um conjunto avançado de opções de configuração que possibilitam a personalização de sua aparência, recursos e comportamento. Para ativar o editor de rich text com uma configuração específica em uma coluna nova ou existente, conclua as etapas a seguir.
- Entrar no Power Apps.
- No painel de navegação esquerdo, selecione Soluções, abra a solução desejada, abra a tabela desejada e selecione a área Formulários.
- Selecione o formulário e, em seguida, selecione Editar formulário > Editar formulário em uma nova guia.
- Na tela designer de formulários, adicione ou crie uma coluna de texto ou selecione uma coluna de texto existente, como a coluna de texto de várias linhas personalizada usada neste artigo.
- No painel de propriedades da coluna direita, expanda a seção Componentes, selecione + Componente e, em seguida, selecione Controle Rich Text Editor.
- No painel Adicionar controle rich text editor, selecione uma das seguintes opções e, em seguida, selecione Concluído:
Vincular à coluna da tabela: não recomendamos que você habilite essa opção porque essa propriedade não dá suporte à associação a uma coluna de tabela diferente.
Valor estático: se desejar personalizar a aparência, os recursos e o comportamento do editor de rich text, insira a URL relativa para o recurso da Web JavaScript que contém as propriedades desejadas. Mais informações: Criar e usar a configuração avançada para o controle rich text editor
Web, Telefone e Tablet: habilite tudo se quiser que todos os aplicativos cliente tenham a capacidade de usar rich text na coluna.
- Salve e publique o formulário.
Criar e usar a configuração avançada para o controle rich text editor
Para criar e usar a configuração avançada para o controle rich text editor, siga estas etapas:
Crie um arquivo JavaScript (.js) que contenha o arquivo de texto no formato JSON com a configuração e a estrutura
defaultSupportedPropsdesejadas. Mais informações: Mais exemplos de configurações do editor de rich text e Propriedades do editor de rich-textNo Power Apps, crie um recurso da Web do tipo JavaScript (JS) usando o arquivo JSON criado na etapa 1. Mais informações: Criar ou editar recursos da Web de aplicativos baseados em modelo para estender um aplicativo
Adicione a URL relativa para o recurso da Web JavaScript (por exemplo /WebResources/contoso_toolbartoprte), no campo Valor estático no painel Adicionar controle rich text editor. Mais Informações: Adicionar ou substituir uma coluna de texto para edição de rich text
Dica
- O URL do recurso da Web está localizado próximo ao campo do URL na definição de recurso da Web que você criou na etapa anterior.
- Embora você possa usar a URL absoluta para o Valor estático, ao usar a URL relativa, o recurso da Web continuará funcionando após ser importado para outro ambiente como uma solução.
Salve e publique o formulário.
Melhores práticas para usar o editor de rich text
Considere o seguinte ao usar o editor de rich text:
O melhor desempenho é obtido quando o tamanho do conteúdo HTML é 1 MB ou menos. Quando o tamanho do conteúdo HTML ultrapassa 1 MB, você pode notar tempos de resposta mais lentos para carregar e editar o conteúdo. Por padrão, o conteúdo da imagem é referenciado a partir do conteúdo HTML, mas não é armazenado como parte do conteúdo HTML; portanto, na configuração padrão, as imagens não afetam negativamente o desempenho.
Os campos de rich text armazenarão tags HTML que são necessárias para a formatação juntamente com os dados inseridos pelo usuário. Ao definir o tamanho máximo para o seu campo, certifique-se de atribuir um tamanho grande o suficiente para as marcas HTML e os dados inseridos pelo usuário.
Por padrão, o editor de rich text carregará imagens para o armazenamento do Azure Blob Storage e elas não serão armazenadas como parte do campo. As imagens serão armazenadas no mesmo campo que base64 quando o remetente não tiver permissões para a entidade
msdyn_richtextfiles. O conteúdo base64 é grande, então geralmente não convém armazenar imagens como base64.
Como a configuração é aplicada ao editor de rich text
A experiência e os recursos do editor de rich text são controlados com a configuração. A configuração padrão para o controle rich text editor tem propriedades e valores destinados a atender às necessidades normais de rich text, mas podem ser ajustados. Propriedades e valores de configuração podem ser aplicados a uma instância de controle rich text editor específica. Pode haver até três níveis de configuração que podem ser aplicados a cada instância do editor de rich text. A lógica usada para aplicar propriedades e valores é a seguinte:
O arquivo de configuração global não editável RTEGlobalConfiguration_Readonly.json é carregado.
O arquivo de configuração global editável RTEGlobalConfiguration.json é carregado.
- As propriedades nesta configuração substituem* as mesmas propriedades nomeadas no arquivo de configuração anterior.
Se existir, o arquivo de configuração específico da instância é carregado. Consulte Configuração avançada para obter mais informações sobre a configuração no nível da instância.
- As propriedades nesta configuração substituem* as mesmas propriedades nomeadas em qualquer um dos arquivos de configuração anteriores.
Observação
Todas as propriedades são substituídas, exceto por extraPlugins, que são mesclados. A mesclagem de extraPlugins permite o uso de uma ampla variedade de plug-ins no RTEGlobalConfiguration.json usando externalPlugins e plug-ins fornecidos prontos para uso. Então, apenas os plugins necessários podem ser ativados adicionando-os aos valores extraPlugins na configuração específica da instância.
Uma coluna habilitada para rich text tem um conjunto limitado de configuração que pode ser configurado para o estado somente leitura ou desabilitado. Você pode saber mais sobre essa configuração na descrição da propriedade "readOnlySettings".
Propriedades do editor de rich-text
O arquivo JSON é composto de propriedades definidas como pares de nome e valor. Existem dois tipos de configurações: a seção defaultSupportedProps e definições de configuração individuais que fornecem várias funcionalidades.
O defaultSupportedProps é um conjunto de propriedades para os plug-ins e inclui suporte para todas as configurações do CKEditor. Mais informações: Visualização do arquivo de configuração do editor de rich text. O defaultSupportedProps não se limita apenas às propriedades de plug-in documentadas no CKEditor, mas também permite que você defina propriedades para mais plug-ins adicionais que você pode adicionar ou criar. Mais informações sobre plug-ins: Usar plug-ins para ampliar os processos empresariais.
As definições de configuração individuais permitem que você altere como seu editor se comporta e funciona.
Visualização do arquivo de configuração do editor de rich text
As duas imagens a seguir identificam visualmente as duas seções de configuração. Para o arquivo de configuração completo, acesse Usar o recurso da Web padrão para alterações em toda a organização.
defaultSupportedProps
Mais informações: defaultSupportedProps
Definições de configuração individuais
Mais informações: Definições de configuração individuais
defaultSupportedProps
Você pode configurar todas as propriedades compatíveis com o CKEditor nessa propriedade. Algumas das configurações comumente usadas e personalizadas são descritas abaixo. Para obter a documentação completa sobre as configurações do CKEditor, consulte CKEditor.config. Atualmente, o editor de rich text usa o CKEditor versão 4.17.1.
| Atributo | Descrição | Valor padrão |
|---|---|---|
| altura |
Define a altura inicial do editor de conteúdo. O padrão é 185 px. |
|
| stickyStyle |
Define o tamanho e o estilo da fonte padrão real. |
|
| font_defaultLabel |
Define o rótulo padrão que é exibido na barra de ferramentas para o estilo da fonte. O padrão é Segoe UI. O rótulo padrão é apenas visual e não é funcional, e a configuração stickyStyle aplica a fonte e o tamanho funcionais. |
|
| fontSize_defaultLabel |
Define o rótulo padrão que é exibido na barra de ferramentas para o tamanho da fonte. O padrão é 9. O rótulo padrão é apenas visual e não é funcional, e a configuração stickyStyle aplica a fonte e o tamanho funcionais. |
|
| toolbarLocation |
A localização da interface do usuário onde a barra de ferramentas será renderizada. Os valores com suporte são superior e inferior. O padrão é inferior. |
|
| barra de ferramentas |
Uma lista de botões da barra de ferramentas que serão carregados. |
|
| plugins |
Lista separada por vírgulas de plug-ins a serem usados em uma instância de editor. Os plug-ins reais que são carregados ainda podem ser afetados por duas outras configurações: extraPlugins e removePlugins. |
|
| extraPlugins |
Uma lista separada por vírgulas de outros plug-ins a serem carregados. Esta configuração facilita a adição de novos plug-ins sem mexer na configuração dos plug-ins. |
|
| removePlugins |
Uma lista de plug-ins que não devem ser carregados. Esta configuração permite evitar o carregamento de alguns plug-ins definidos na configuração plugins/extraPlugins sem ter que mexer neles. |
|
| superimageImageMaxSize |
O tamanho máximo em megabytes (MB) permitido para imagens incorporadas ao usar o plug-in de superimagem. O padrão é 5. |
|
| disallowedContent |
Permite impedir elementos que você não deseja ter em seu conteúdo. Você pode impedir elementos inteiros ou por atributos, classes e estilos. Para obter mais informações sobre a configuração "disallowedContent" do CKEditor, consulte Regras de conteúdo não permitidas. |
|
| linkTargets |
Permite configurar quais opções de destinos de links estão disponíveis para os usuários ao criar links. |
Destinos de links
- ```notSet```: nenhum destino definido para o documento na marca de âncora
- ```frame```: abre o documento no quadro especificado
- ```popupWindow```: abre o documento em uma janela pop-up
- ```_blank```: abre o documento em uma nova janela ou guia
- ```_top```: abre o documento em todo o corpo da janela
- ```_self```: abre o documento na mesma janela ou guia em que o link está ativado
- ```_parent```: abre o documento no quadro pai
Exemplo:
|
Definições de configuração individuais
Você pode definir outras configurações que afetam o funcionamento do editor.
| Atributo | Descrição | Valor padrão |
|---|---|---|
| attachmentEntity |
Ao configurar essa propriedade e especificar uma tabela diferente, você pode evitar usar a tabela padrão para arquivos para que possa impor mais segurança, se necessário. |
Sintaxe:
Exemplo:
Padrão:
|
| disableContentSanitization | Por padrão, a limpeza de conteúdo é desabilitada para permitir a cópia e a colagem bem-sucedidas de conteúdo de rich text de fontes externas. Quando habilitada, a limpeza de conteúdo removerá alguns dos atributos ou marcas personalizados. Essa configuração se aplica apenas a modo de edição. A renderização de estado somente leitura ou desabilitada sempre será limpa. |
|
| disableDefaultImageProcessing |
Por padrão, as imagens serão carregadas usando a API de cliente. Assim que uma imagem for adicionada ao editor, ela será carregada na plataforma. Para processar imagens, defina essa propriedade como verdadeira. |
|
| disableImages |
Definir esta propriedade como verdadeira desabilitará as imagens. Essa propriedade terá a prioridade mais alta. Isso significa que, quando essa propriedade for definida como verdadeira, independentemente do valor da propriedade imageEntity, as imagens serão desabilitadas. Por padrão, as imagens estão habilitadas. |
|
| externalPlugins |
Ao usar esta propriedade, você pode escrever seus próprios plug-ins e usá-los no controle do editor de rich-text. |
Sem nenhum valor padrão, pois é assim que você pode estender sua funcionalidade adicionando outros plugins não fornecidos originalmente. O valor do caminho pode ser uma URL absoluta ou relativa. Exemplo:
Exemplo:
|
| imageEntity |
Ao configurar essa propriedade e especificar uma tabela diferente, você pode evitar usar a tabela padrão para images para que possa impor mais segurança, se necessário. |
Sintaxe:
Exemplo:
Padrão:
|
| readOnlySettings |
Ao definir essa propriedade, você pode configurar outros comportamentos para a coluna quando exibida em um estado somente leitura ou desabilitada. |
Exemplo:
Padrão:
|
| readOnlySettings |
Ao definir essa propriedade, você pode permitir que mais conteúdo seja exibido. |
Exemplo:
Padrão:
|
| showAsTabControl |
Ao configurar esta propriedade, você pode exibir mais comandos acima da janela do editor. Deve ser definido como verdadeiro para ativar os seguintes atributos:
|
|
| showFullScreenExpander |
Essa propriedade adiciona a funcionalidade de expandir/recolher em tela inteira, que permite expandir e usar o editor no modo de tela inteira. Depende de showAsTabControl definido como verdadeiro. |
|
| showHtml |
Essa propriedade adiciona a opção de exibir e editar o conteúdo html diretamente. Depende de showAsTabControl definido como verdadeiro. |
|
| showPreview |
Essa propriedade adiciona a opção de visualizar o conteúdo do editor renderizado como html. A visualização permite que você veja como seu conteúdo será exibido se você compartilhar e renderizar o conteúdo como HTML fora do editor. Depende de showAsTabControl definido como verdadeiro. |
|
| showPreviewHeaderWarning |
Essa propriedade permite mostrar/ocultar a mensagem de aviso exibida durante a visualização do conteúdo. Depende de showAsTabControl e showPreview definidos como verdadeiro. |
|
Configurações do editor de rich text comumente usadas
Veja a seguir as configurações comuns para o editor de rich text. Essas configurações de amostra podem ser usadas para habilitar tipos específicos de experiências de rich text. Para cada amostra, você cria um recurso da Web JSON ou modifica a configuração de recurso da Web padrão. Mais informações: Criar e usar a configuração avançada para o controle rich text editor e Usar o recurso da Web padrão para alterações em toda a organização
Defina a fonte padrão para Calibri com tamanho de fonte 11pt
Defina a fonte e o tamanho padrão para corresponder aos padrões do Microsoft Windows. Este exemplo mostra quais configurações você usa para implementar essa alteração em sua experiência.
Defina estas propriedades defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"font_defaultLabel": "Calibri"
"fontSize_defaultLabel": "11"
"stickyStyle": {
"font-size": "11pt",
"font-family": "Calibri/Calibri, Helvetica, sans-serif;"
}
Fazer as quebras de linha (tecla Enter) criarem um <br> em vez de um <p>
O comportamento padrão da tecla Enter cria blocos de parágrafo com a marca HTML <p> (também usada ao interpretar o conteúdo colado). Blocos de parágrafo são usados em HTML para agrupar informações. Em alguns casos, ao criar novas informações ou colar informações do Microsoft Word ou de outro editor de conteúdo, devido à forma como cada navegador interpreta a formatação da marca do bloqueio de parágrafo (<p>) um pouco diferente, talvez seja necessário usar a marca HTML <br> em vez de bloqueios de parágrafo. Em certos casos, o espaçamento vertical para marcas HTML <br> pode ser visualmente mais consistente em vários navegadores e experiências. Este exemplo mostra como mudar de <p> para <br>.
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"enterMode": 2
Todo o conteúdo colado ou criado é compatível com HTML 5
O controle do editor de rich-text funciona melhor com conteúdo HTML 5, embora as marcas e a formatação HTML 4 também possam ser usadas com êxito. Em alguns casos, a mistura de marcas HTML 4 e HTML 5 pode criar desafios de usabilidade ao selecionar e configurar fontes e tamanhos. O uso de "allowedContent" pode garantir que todo o conteúdo seja HTML 5. Este exemplo permite todas as marcas HTML 5 compatíveis. Quaisquer marcas não compatíveis são convertidas em seu equivalente HTML 5.
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"allowedContent": "a(*)[*]{*};abbr(*)[*]{*};address(*)[*]{*};area(*)[*]{*};article(*)[*]{*};aside(*)[*]{*};audio(*)[*]{*};b(*)[*]{*};base(*)[*]{*};bdi(*)[*]{*};bdo(*)[*]{*};blockquote(*)[*]{*};body(*)[*]{*};br(*)[*]{*};button(*)[*]{*};canvas(*)[*]{*};caption(*)[*]{*};cite(*)[*]{*};code(*)[*]{*};col(*)[*]{*};colgroup(*)[*]{*};data(*)[*]{*};datalist(*)[*]{*};dd(*)[*]{*};del(*)[*]{*};details(*)[*]{*};dfn(*)[*]{*};dialog(*)[*]{*};div(*)[*]{*};dl(*)[*]{*};dt(*)[*]{*};em(*)[*]{*};embed(*)[*]{*};fieldset(*)[*]{*};figcaption(*)[*]{*};figure(*)[*]{*};footer(*)[*]{*};form(*)[*]{*};h1(*)[*]{*};h2(*)[*]{*};h3(*)[*]{*};h4(*)[*]{*};h5(*)[*]{*};h6(*)[*]{*};head(*)[*]{*};header(*)[*]{*};hr(*)[*]{*};html(*)[*]{*};i(*)[*]{*};iframe(*)[*]{*};img(*)[*]{*};input(*)[*]{*};ins(*)[*]{*};kbd(*)[*]{*};label(*)[*]{*};legend(*)[*]{*};li(*)[*]{*};link(*)[*]{*};main(*)[*]{*};map(*)[*]{*};mark(*)[*]{*};meta(*)[*]{*};meter(*)[*]{*};nav(*)[*]{*};noscript(*)[*]{*};object(*)[*]{*};ol(*)[*]{*};optgroup(*)[*]{*};option(*)[*]{*};output(*)[*]{*};p(*)[*]{*};param(*)[*]{*};picture(*)[*]{*};pre(*)[*]{*};progress(*)[*]{*};q(*)[*]{*};rp(*)[*]{*};rt(*)[*]{*};ruby(*)[*]{*};s(*)[*]{*};samp(*)[*]{*};section(*)[*]{*};select(*)[*]{*};small(*)[*]{*};source(*)[*]{*};span(*)[*]{*};strong(*)[*]{*};style(*)[*]{*};sub(*)[*]{*};summary(*)[*]{*};sup(*)[*]{*};svg(*)[*]{*};table(*)[*]{*};tbody(*)[*]{*};td(*)[*]{*};template(*)[*]{*};textarea(*)[*]{*};tfoot(*)[*]{*};th(*)[*]{*};thead(*)[*]{*};time(*)[*]{*};title(*)[*]{*};tr(*)[*]{*};track(*)[*]{*};u(*)[*]{*};ul(*)[*]{*};var(*)[*]{*};video(*)[*]{*};wbr(*)[*]{*};"
Mais exemplos de configurações do editor de rich-text
Adicionar o expansor de tela inteira
Defina estas propriedades Individual configuration settings no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: Definições de configuração individuais)
"showAsTabControl": true
"showFullScreenExpander": true
Adicionar a guia Exibição de fonte HTML
Defina estas propriedades Individual configuration settings no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: Definições de configuração individuais)
"showAsTabControl": true
"showHtml": true
Adicionar uma barra de ferramentas simples com tamanho da fonte, negrito, itálico, sublinhado e realce
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ]
Remover a barra de ferramentas para criar uma superfície de renderização de rich-text
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"toolbar": []
Adicionar uma nova lista de fontes e definir Brush Script MT como a fonte padrão com um tamanho padrão de 20 px
Defina estas propriedades defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"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/8px;12/12px;20/20px;32/32px"
"fontSize_defaultLabel": "20"
"stickyStyle": {
"font-size": "20px",
"font-family": "'Brush Script MT', cursive"
}
Posicionar a barra de ferramentas na parte superior do editor de rich-text
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"toolbarLocation": "top"
Iniciar o editor na altura de 30 px e, em seguida, aumentar automaticamente para ajustar o conteúdo
Defina estas propriedades defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"autoGrow_onStartup": false
"autoGrow_maxHeight": 0
"autoGrow_minHeight": 30
"height": 30
Fixar a altura do editor em 500 px
Defina estas propriedades defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"removePlugins": [ "autogrow" ]
"height": 500
Criar uma superfície de texto simples que remova todas as marcas html, exceto a marca "br"
Defina estas propriedades defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"enterMode": 2
"shiftEnterMode": 2
"allowedContent": "*"
"disallowedContent": "*"
"forcePasteAsPlainText": true
"toolbar": []
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools"
Defina esta propriedade Individual configuration settings no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: Definições de configuração individuais)
"disableImages": true
Remover o menu de contexto para que o clique com o botão direito do mouse funcione com a verificação ortográfica do navegador padrão
Habilitar essa funcionalidade remove o recurso de edição contextual do clique com o botão direito do mouse.
Defina esta propriedade defaultSupportedProps no seu arquivo de configuração. Cada valor deve ser seguido por uma , (comma) a menos que seja o último valor: (Mais informações: defaultSupportedProps)
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools"
Usar o recurso da Web padrão para alterações em toda a organização
O recurso da Web RTE padrão está disponível com o nome de exibição RTEGlobalConfiguration.json. Essa configuração é usada para todas as instâncias do controle RTE e pode ser usada para fazer mudanças em toda a organização. Isso inclui RTE usado em notas de rich text da linha do tempo, gerenciamento de conhecimento e campos de linha única e multilinha que são configurados para usar o controle RTE.
{
"defaultSupportedProps": {
"allowedIframeDomains": [],
"autoGrow_onStartup": true,
"basicEntities": true,
"browserContextMenuOnCtrl": true,
"copyFormatting_allowRules": true,
"customConfig": "",
"dialog_backgroundCoverColor": "black",
"disableNativeSpellChecker": false,
"enterMode": 3,
"extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools",
"fillEmptyBlocks": true,
"font_defaultLabel": "Segoe UI",
"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",
"fontSize_defaultLabel": "9",
"fontSize_sizes": "8/8pt;9/9pt;10/10pt;11/11pt;12/12pt;14/14pt;16/16pt;18/18pt;20/20pt;22/22pt;24/24pt;26/26pt;28/28pt;36/36pt;48/48pt;72/72pt;",
"height": 185,
"keystrokes": [],
"linkDefaultProtocol": "https://",
"listStylePosition": "inside",
"pasteAzureBlobImageAsBase64": false,
"qtCellBorderColor": "rgb(171, 171, 171)",
"qtCellBorderStyle": "solid",
"qtCellBorderWidth": "1px",
"qtCellPadding": "1",
"qtCellSpacing": "0",
"qtCellWith": "120px",
"pasteFilter": null,
"qtColumns": 8,
"qtRows": 6,
"qtStyle": {
"border-collapse": "collapse",
"font-size": "9pt"
},
"removeDialogTabs": "flash:Upload;link:upload",
"removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
"skin": "superowa",
"stickyStyle": {
"font-size": "9pt",
"font-family": "'Segoe UI','Helvetica Neue',sans-serif"
},
"stickyStyles_defaultTag": "div",
"superimageImageMaxSize": 5,
"toolbarcollapser_enableResizer": true,
"toolbarLocation": "bottom",
"uploadRecordId": []
},
"attachmentEntity": {
"name": "msdyn_richtextfiles",
"fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"imageEntity": {
"imageEntityName": "msdyn_richtextfiles",
"imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
},
"sanitizerAllowlist": {
"attributes": [],
"cssProperties": [],
"domains": [],
"protocols": [],
"tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false
}
Encontre a configuração atual para a configuração de editor de rich text
Em um navegador da Web Microsoft Edge ou Google Chrome, execute o aplicativo baseado em modelo e abra um formulário que tenha o controle rich text editor, como uma linha da conta.
Pressione Ctrl enquanto clica na área de controle rich text editor e, em seguida, selecione Inspecionar.
No painel de inspeção, selecione a guia Console e selecione a página principal Main.aspx na caixa de lista suspensa na barra de comandos.
Selecione Limpar console na barra de comandos do painel de inspeção.
No console do painel de inspeção, insira CKEDITOR.config. para exibir as diferentes configurações.
Selecione uma configuração, como autoGrow_minHeight, para exibir a configuração atual.
Usar a barra de ferramentas do editor de rich text
A barra de ferramentas do editor de rich text fornece recursos e funcionalidades que permitem trabalhar com o formato de rich text em notas e email.
Opções de formatação
A tabela a seguir descreve os diferentes recursos de formatação e as opções de funcionalidade disponíveis no editor de rich-text que você pode usar.
| Ícone | Nome | Tecla de atalho | Descrição |
|---|---|---|---|
![]() |
Pincel de Formatação | Ctrl+Shift+C, Ctrl+Shift+V | Aplique a aparência de uma seção específica de outra seção. |
![]() |
Fonte | Ctrl+Shift+F | Selecione sua fonte desejada. A fonte padrão é Segoe UI. Observação: quando você seleciona qualquer conteúdo formatado, o nome da fonte desse conteúdo é exibido. Se sua seleção contiver várias fontes, o nome da fonte superior da sua seleção será exibido. |
![]() |
Tamanho da fonte | Ctrl+Shift+P | Altere o tamanho do seu texto. O tamanho padrão é 12. Observação: quando você seleciona qualquer conteúdo formatado, o tamanho da fonte desse conteúdo é exibido. Se sua seleção contiver vários tamanhos de fonte, o nome da fonte superior da sua seleção será exibido. |
![]() |
Negrito | Ctrl+B | Deixe seu texto em negrito. |
![]() |
Italic | Ctrl+I | Coloque o texto em itálico. |
![]() |
Sublinhado | Ctrl+U | Sublinhe o seu texto. |
![]() |
Cor do Realce do Texto | Destaque o seu texto realçando-o em uma cor brilhante. | |
![]() |
Cor da Fonte | Altere a cor do seu texto. | |
![]() |
Marcadores | Crie uma lista de com marcadores. | |
![]() |
Numeração | Crie uma lista numerada. | |
![]() |
Diminuir Recuo | Mova seu parágrafo para mais perto da margem. | |
![]() |
Aumentar Recuo | Afaste o parágrafo da margem. | |
![]() |
Citação em Bloco | Aplique um formato de cotação em nível de bloco no seu conteúdo. | |
![]() |
Alinhar à Esquerda | Ctrl+L | Alinhe seu conteúdo à margem esquerda. (Geralmente usado para o corpo do texto para facilitar a leitura). |
![]() |
Alinhar ao Centro | Ctrl+E | Centralize seu conteúdo na página. (Geralmente usado para uma aparência formal). |
![]() |
Alinha à Direita | Ctrl+R | Alinhe seu conteúdo com a margem direita. (Geralmente usado para uma aparência formal). |
![]() |
Vínculo | Crie um link no seu documento para acesso rápido a arquivos e páginas da Web. O texto da URL colado ou digitado é convertido em um link. Por exemplo, "http://myexample.com" se tornará "http://myexample.com". Na caixa de diálogo Link, escolha o tipo de Link que você deseja inserir. A guia Informações de Link permite que você escolha o tipo de link, além de definir o protocolo de link e a URL. A guia Destino só está disponível para o tipo de link da URL. Ela especifica o local onde o link será aberto depois que você selecioná-lo. |
|
![]() |
Desvincular | Exclua um link no seu email ou documento. Ao colocar o cursor sobre um link, o botão Desvincular da barra de ferramentas se torna ativo. Clique no botão para remover o vínculo e transformá-lo em texto sem formatação. |
|
![]() |
Sobrescrito | Digite letras minúsculas logo acima da linha de texto. | |
![]() |
Subscrito | Digite letras minúsculas logo abaixo da linha de texto. | |
![]() |
Tachado | Risque o texto desenhando uma linha em cima dele. | |
![]() |
Inserir Imagem | Você pode inserir uma imagem, copiando e colando-a diretamente no editor, arrastando e soltando-a da área de trabalho ou da pasta local diretamente no editor ou digitando uma URL. Os seguintes formatos de imagem têm suporte: .PNG, .JPG., ou .GIF. Para inserir uma imagem embutida no seu artigo: 1. Arraste e solte a imagem ou copie-a e cole-a diretamente no artigo. 2. Arraste qualquer canto da imagem para redimensioná-la. Para inserir uma imagem usando uma URL ou navegando até a imagem local: 1. Escolha Inserir Imagem. 2. Na caixa de diálogo Imagem, escolha uma das seguintes opções:
Observação: |
|
![]() |
Esquerda para Direita | Altere o texto da esquerda para a direita para conteúdo como um parágrafo, cabeçalho, tabela ou lista. Comumente usado para conteúdo de idioma bidirecional. Esta é a configuração padrão. | |
![]() |
Direita para Esquerda | Altere o texto da direita para a esquerda para conteúdo como um parágrafo, cabeçalho, tabela ou lista. Comumente usado para conteúdo de idioma bidirecional. A configuração padrão é da esquerda para a direita. | |
![]() |
Desfazer Digitação | Desfaça as alterações feitas ao conteúdo. | |
![]() |
Refazer Digitação | Refaça as alterações feitas ao conteúdo. | |
![]() |
Limpar Toda Formatação | Remova toda a formatação de uma seleção de texto, deixando apenas o texto normal e não formatado. | |
![]() |
Adicionar uma Tabela | Adicione uma tabela ao seu conteúdo. Após adicionar uma tabela, você poderá fazer o seguinte:
|
|
| Ajuda de acessibilidade | Alt+0 | Exibe uma lista de atalhos de acessibilidade disponíveis ao usar o controle do editor de rich-text. | |
![]() |
Expandir Barra de Ferramentas | É exibido quando a barra de ferramentas está recolhida e nem todas as opções aparecem. Selecione para expandir a barra de ferramentas e tornar todas as opções visíveis. | |
Dica
Você pode acessar o menu de contexto do navegador selecionando Ctrl + clique com o botão direito. Isso será útil se você precisar usar o corretor ortográfico embutido no navegador. Caso contrário, você pode clicar com o botão direito para fornecer formatação contextual para qualquer elemento utilizado.
Além disso, uma alternativa ao verificador ortográfico integrado do seu navegador é a extensão de navegador Editor Microsoft. O Editor Microsoft funciona perfeitamente com o controle de editor de rich text e, quando habilitado, fornece recursos em linha de verificação ortográfica e gramática rápidos e fáceis.
Atalhos de acessibilidade
A tabela a seguir descreve uma lista de atalhos de acessibilidade disponíveis ao usar o controle do editor de rich text. Você pode acessar esta lista enquanto compõe o conteúdo pressionando Alt+0.
| Digitar | Tecla de atalho | Descrição |
|---|---|---|
| Geral | Alt+F11 | Alterne a exibição em tela cheia. |
| Navegação pelas guias | Alt+Ctrl+0 | Vá para a barra de ferramentas. |
| Navegação pelas guias | Alt + 1 | Vá para o editor de rich-text. |
| Navegação pelas guias | Alt + 2 | Vá para o editor HTML. |
| Navegação por tabulação | Alt + 3 | Vá para a exibição de versão preliminar. |
| Comandos gerais do editor | Alt+F10 | Navegue até a barra de ferramentas do editor. Mova-se para o próximo grupo da barra de ferramentas e para o anterior com Tab e Shift+Tab. Mova-se para o próximo botão barra de ferramentas e para o anterior com a Seta para a Direita ou a Seta para a Esquerda. Pressione Espaço ou Enter para ativar o botão da barra de ferramentas. |
| Comandos gerais do editor | Alt+- | Expanda/recolha a barra de ferramentas. |
| Comandos gerais do editor | Consulte a descrição. | Diálogo do Editor: dentro de um diálogo, pressione Tab para navegar até o próximo elemento de diálogo, pressione Shift+Tab para ir para o elemento anterior da caixa de diálogo, pressione Enter para enviar o diálogo, pressione ESC para cancelar o diálogo. Quando um diálogo tiver várias guias, a lista de guias poderá ser acessada com Alt+F10 ou com Tab, seguindo a ordem das guias do diálogo. Com uma lista de guias focada, vá para a guia seguinte e para a anterior com a Seta para a Direita e Esquerda, respectivamente. |
| Comandos gerais do editor | Consulte a descrição. | Caixa de listagem do Editor: dentro de uma caixa de listagem, vá para o próximo item da lista com Tab ou a Seta para Baixo. Vá para o item anterior da lista com Shift+Tab ou Seta para Cima. Pressione Espaço ou Enter para selecionar a opção de lista. Para ESC para fechar a caixa de listagem. |
| Comandos base | Ctrl+Z | Comando Desfazer. |
| Comandos base | Shift+Ctrl+Z | Comando Refazer. |
| Comandos base | Ctrl+B | Comando Negrito. |
| Comandos base | Ctrl+I | Comando Itálico. |
| Comandos base | Ctrl+U | Comando Sublinhar. |
| Comandos base | Alt+0 | Ajuda de acessibilidade. |
| Comandos básicos | Esc | Cancelar operação. |
Experiência offline
O controle do editor de rich-text está disponível ao trabalhar offline com uma configuração básica. A seguir, veja uma lista de plug-ins e opções de formatação compatíveis com o trabalho offline. Todas as configurações adicionadas por meio de arquivos de recursos da Web não estão disponíveis no modo offline.
Plug-ins disponíveis para uso offline
Os plug-ins a seguir estão disponíveis para o editor de rich-text no modo offline.
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
Opções de formatação para uso offline
A tabela a seguir descreve os diferentes recursos de formatação e as opções de funcionalidade disponíveis no editor de rich-text no modo offline.
| Ícone | Nome | Tecla de atalho | Descrição |
|---|---|---|---|
![]() |
Negrito | Ctrl+B | Coloque o texto em negrito. |
![]() |
Itálico | Ctrl+I | Coloque o texto em itálico. |
![]() |
Sublinhado | Ctrl+U | Sublinhe seu texto. |
![]() |
Marcadores | Crie uma lista com marcadores. | |
![]() |
Numeração | Crie uma lista numerada. | |
![]() |
Diminuir Recuo | Mova seu parágrafo para mais perto da margem. | |
![]() |
Aumentar Recuo | Afaste o parágrafo da margem. | |
![]() |
Citação em Bloco | Aplique um formato de cotação em nível de bloco no seu conteúdo. | |
![]() |
Alinhar à Esquerda | Ctrl+L | Alinhe seu conteúdo à margem esquerda. (Geralmente usado para o corpo do texto para facilitar a leitura). |
![]() |
Alinhar ao Centro | Ctrl+E | Centralize seu conteúdo na página. (Geralmente usado para uma aparência formal). |
![]() |
Alinha à Direita | Ctrl+R | Alinhe seu conteúdo à margem direita. (Geralmente usado para uma aparência formal). |
![]() |
Tachado | Risque o texto desenhando uma linha em cima dele. | |
![]() |
Esquerda para Direita | Altere o texto para esquerda para direita em conteúdos como parágrafo, cabeçalho, tabela ou lista. Comumente usado para conteúdo de idioma bidirecional. Esta é a configuração padrão. | |
![]() |
Direita para Esquerda | Altere o texto da direita para a esquerda para conteúdo como um parágrafo, cabeçalho, tabela ou lista. Comumente usado para conteúdo de idioma bidirecional. A configuração padrão é da esquerda para a direita. | |
![]() |
Desfazer Digitação | Desfaça as alterações feitas ao conteúdo. | |
![]() |
Refazer Digitação | Refaça as alterações feitas ao conteúdo. | |
![]() |
Limpar Toda Formatação | Remova toda a formatação de uma seleção de texto, deixando apenas o texto normal e não formatado. | |
Perguntas frequentes
P: Por que os caracteres digitados demoram a ser exibidos?
R. O grande tamanho do conteúdo pode causar latência. Mais informações: Melhores práticas para usar o editor de rich text. As verificações ortográficas ou gramaticais também podem diminuir o desempenho da digitação.
Problemas conhecidos
- O markup HTML é exibido para colunas configuradas para usar o controle do editor de rich-text que são exibidas em componentes diferentes de uma coluna em um formulário que não tem o formato definido como RichText. Por exemplo, isso ocorre em exibições, subgrades, relatórios paginados e portais.
Para resolver esse problema, consulte Configuração simples e veja as etapas necessárias para definir a opção Formato como Rich text.
Consulte também
Criar e editar colunas do Microsoft Dataverse usando o portal do Power Apps
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).
Comentários
Enviar e exibir comentários de




























