Partilhar via


Adicionar o controlo Editor de texto formatado a uma aplicação condicionada por modelo

O controlo de editor de texto formatado é um editor simples, baseado em HTML criado no popular CKEditor. Permite-lhe criar, colar e editar texto formatado nas suas aplicações condicionadas por modelo. Para formatar texto no editor, pode utilizar a barra de ferramentas do editor, inserir etiquetas de HTML ou colar texto formatado a partir de outras aplicações, como um browser ou o Word.

Pode personalizar o aspeto, a funcionalidade e o comportamento do editor. A experiência de texto moderno do controlo é mostrada na seguinte captura de ecrã.

Captura de ecrã da predefinição do editor de texto formatado numa aplicação condicionada por modelo.

Atualmente, o editor de texto formatado está disponível como duas experiências diferentes:

  • Editor de texto moderno: nova experiência que pode ativar
  • Editor de texto clássico: experiência predefinida

Melhorias do editor de texto moderno

O editor de texto moderno foi concebido para se alinhar com as interfaces familiares e intuitivas de aplicações Microsoft como o Outlook, Word e OneNote. Esta atualização introduz um design moderno, modo escuro, temas de alto contraste e uma nova funcionalidade do Copilot para melhorar as suas capacidades de edição de texto.

Nota

Algumas funcionalidades que estão disponíveis na experiência clássica de editor de texto formatado ainda não estão disponíveis na experiência moderna. Essas funcionalidades incluem:

  • Opções de configuração, conforme descrito neste artigo para a experiência clássica
  • Menções

Ativar a experiência de editor de texto formatado moderno

A experiência clássica de editor de texto formatado está ativada por predefinição. Conclua os seguintes passos para mudar para a experiência de editor de texto formatado moderno.

  1. No Dynamics 365, clique com o botão direito do rato na aplicação para a qual pretende ativar a experiência de editor de texto formatado moderno e, em seguida, selecione ABRIR NO ESTRUTURADOR DE APLICAÇÕES. O Power Apps abre o estruturador de aplicações.
  2. Na barra de comandos, selecione Definições. É apresentada a página Definições.
  3. No painel esquerdo, em Definições, selecione Funcionalidades. É apresentada a página Funcionalidades.
  4. Defina a alternância para Sim para qualquer uma ou todas as seguintes opções, dependendo das suas necessidades:
    • Ativar uma experiência de controlo RichTextEditor moderna e descrições de e-mail: ativa a experiência do controlo do editor de texto formatado moderno para descrições de e-mail. Esta definição substitui quaisquer personalizações que tenha feito anteriormente na experiência de e-mail clássica (predefinida) do editor de texto formatado.
    • Ativar uma experiência de controlo RichTextEditor moderna para controlos predefinidos: ativa a experiência de editor de texto formatado moderno para instâncias predefinidas, não configuradas.
    • Ativar uma experiência de controlo RichTextEditor moderna para a criação de notas: ativa a experiência do editor de texto formatado moderno para notas. Esta definição substitui quaisquer personalizações que tenha feito anteriormente na experiência de criação de notas (predefinida) do editor de texto formatado.
  5. Selecione Guardar.
  6. No Estruturador de Aplicações, selecione Publicar.

Reverter da experiência moderna de editor de texto formatado para a experiência clássica

Se precisar de reverter para a experiência clássica de editor de texto formatado, siga os mesmos passos em Ativar a experiência de editor de texto formatado moderno, mas desmarque as opções selecionadas no Passo 4.

Adicionar o controlo do editor de texto formatado a uma coluna de texto

A configuração que se segue está disponível na experiência clássica de editor de texto formatado.

Quando formatar uma coluna de texto como texto formatado, o controlo predefinido do editor de texto formatado é adicionado automaticamente.

  1. Iniciar sessão no Power Apps.

  2. No painel de navegação esquerdo, selecione Soluções.

  3. Abra uma solução e uma tabela na solução.

  4. Na área Colunas e dados , selecione uma coluna de texto.

    Se a tabela não contém uma coluna de texto, selecione + (Nova coluna) e introduza um nome para a coluna.

  5. Em Tipo de dados, selecione > à direita de Texto e, em seguida, selecione a opção Texto formatado apropriada, com base se a coluna contém uma linha de texto única ou várias linhas.

  6. Guarde a coluna e, em seguida, adicione-a a um formulário.

Adicionar o controlo de editor de texto formatado a uma coluna de texto num formulário

A configuração que se segue está disponível na experiência clássica de editor de texto formatado.

  1. Inicie sessão no Power Apps.

  2. No painel de navegação esquerdo, selecione Soluções.

  3. Abra uma solução e uma tabela na solução.

  4. Na área Experiências de dados , selecione Formulários e, em seguida, localize o formulário que contém a coluna de texto à que pretende adicionar o editor de texto formatado.

  5. Selecione > Editar > Editar no novo separador.

  6. Na tela do estruturador de formulários, selecione, adicione ou crie uma coluna de texto.

  7. No painel de propriedades da coluna, expanda a lista Componentes, selecione + Componente e, em seguida, selecione Controlo de Editor de Texto Formatado.

  8. No painel Adicionar Controlo de Editor de Texto Formatado, selecione Web, Telefone e Tablet para permitir a execução de aplicações em qualquer dispositivo para utilizar o editor.

    Se pretender personalizar o editor, introduza o URL relativo do seu ficheiro de configuração, um recurso web JavaScript que contém as propriedades que pretende alterar, na caixa Valor estático. Se deixar este campo vazio, o editor utiliza a sua configuração predefinida.

  9. Selecionar Concluído.

  10. Selecione Guardar e publicar para aplicar as suas alterações ao formulário.

Personalizar o controlo de editor de texto formatado

As personalizações que se seguem estão disponíveis na experiência clássica de editor de texto formatado.

O Power Apps permite-lhe alterar as propriedades do controlo de editor de texto formatado para personalizar o aspeto, funcionalidades e comportamento do mesmo. Para personalizar uma instância específica do controlo, especifique as propriedades e os respetivos valores num ficheiro de configuração JSON individual. Para personalizar a configuração global do controlo, altere as propriedades no ficheiro de configuração predefinido.

Níveis de personalização

Podem ser aplicados até três níveis ou camadas de configuração ao editor de texto formatado:

  1. No nível mais fundamental, cada instância do controlo tira a sua configuração do ficheiro RTEGlobalConfiguration_Readonly.json. O ficheiro é só de leitura, pelo que não pode alterar estas propriedades diretamente.
  2. No nível seguinte, todas as instâncias do controlo retiram a sua configuração a partir das propriedades no ficheiro RTEGlobalConfiguration.json, se for possível. Esta configuração é colocada como camada sobre a anterior, pelo que as propriedades neste ficheiro substituem as propriedades com o mesmo nome no ficheiro só de leitura.
  3. Por fim, ao nível mais alto, uma instância específica do controlo tira a sua configuração de um ficheiro de configuração específico, se existir um. Esta configuração é colocada como camada sobre a anterior, pelo que as propriedades neste ficheiro substituem as propriedades com o mesmo nome nos dois ficheiros de nível mais baixo.

Temos de adicionar aqui uma ligeira qualificação. Nem todas as propriedades são substituídas por aquelas numa configuração de nível superior. As propriedades extraPlugins são fundidas para permitir a utilização de uma vasta gama de plug-ins externos e de configuração inicial na configuração predefinida. Isto permite-lhe ativar e desativar os plug-ins conforme necessário no ficheiro de configuração para instâncias específicas do controlo.

Personalizar uma instância específica do editor de texto formatado

  1. No Visual Studio Code ou outro editor de texto, crie um ficheiro e dê-lhe um nome significativo.

    O ficheiro RTEGlobalConfiguration.json contém a configuração predefinida ou global do editor de texto formatado. Se estiver a personalizar o controlo num formulário de contacto, por exemplo, poderá dar um nome a esse ficheiro como RTEContactFormConfiguration.json.

  2. Copie e cole o seguinte fragmento de código no ficheiro:

    {
    "defaultSupportedProps": {
      "propertyName": "value",
      "propertyName": "value",
      "propertyName": "value"
    },
    }
    

    O último par propertyName:value não termina com uma vírgula.

  3. Substitua propertyName e value pelas propriedades de controlo de editor de texto formatado que pretende alterar. Os valores das cadeias têm de estar entre aspas.

    Fornecemos algumas configurações de exemplo para si, mas pode definir outras que se adequem às suas necessidades.

  4. No Power Apps, crie um recurso web do tipo JavaScript (JS) utilizando o ficheiro JSON que criou no passo 1.

  5. Adicione o controlo de editor de texto formatado a uma coluna de texto num formulário e no painel Adicionar Controlo de Editor de Texto Formatado > Valor estático, introduza o URL relativo do recurso web do JavaScript.

    Embora seja possível introduzir o URL absoluto do recurso web, recomendamos que introduza o URL relativo. Dessa forma, o recurso web continua a funcionar se o importar como solução para outro ambiente, desde que o caminho relativo seja o mesmo.

    Por exemplo, se o URL do recurso web for https://yourorg.crm.dynamics.com/WebResources/rtecontactform, o URL relativo é /WebResources/rtecontactform.

  6. Selecionar Concluído.

  7. Selecione Guardar e publicar para aplicar as suas alterações ao formulário.

Personalizar o editor de texto formatado globalmente

O ficheiro de configuração global editável RTEGlobalConfiguration.json é o segundo nível de personalização que pode aplicar. Por predefinição, o ficheiro está vazio. Isto significa que todas as instâncias do editor de texto formatado utilizam as propriedades no ficheiro só de leitura RTEGlobalConfiguration_Readonly.json, a menos que crie um ficheiro de configuração para uma instância específica do controlo.

Se a sua empresa precisar de personalizar o controlo em todos os locais, especifique os valores de que necessita no ficheiro RTEGlobalConfiguration.json. Utilize o ficheiro só de leitura como exemplo para se certificar de que introduz pares de propriedade-valor no formato correto.

Utilizar o Copilot para aperfeiçoar o texto no editor

Importante

  • Esta é uma funcionalidade de acesso antecipado. Você pode optar por usá-lo para testes e adoção em seus ambientes.
  • Este recurso está em acesso antecipado apenas para novas organizações. As organizações existentes que já estão usando o recurso podem continuar a usá-lo, mesmo que não tenham optado pelo acesso antecipado.
  • Esse recurso está disponível para Dynamics 365 Sales, incluindo aplicativos de vendas personalizados que têm entidades de leads e oportunidades adicionadas ao mapa do site.

O Copilot utiliza algoritmos de processamento de linguagem natural para ajudar a melhorar o conteúdo escrito. Pode adicionar o Copilot ao editor de texto formatado e, em seguida, obter sugestões para melhorar a gramática, a clareza ou a qualidade global do texto. Aprenda a utilizar o Copilot no editor de texto formatado.

Propriedades do editor de texto formatado

O ficheiro JSON que determina a aparência de uma instância do editor de texto formatado contém dois conjuntos de propriedades:

Exemplo de ficheiro de configuração

O código seguinte é um exemplo de um ficheiro JSON que contém propriedades defaultSupportedProps e propriedades de configuração individual. Se uma propriedade tiver um valor predefinido, é apresentado o valor predefinido. Se uma propriedade não tiver um valor predefinido, é apresentado um valor de exemplo para ilustrar a sintaxe. As propriedades estão descritas nas duas tabelas seguintes.

"defaultSupportedProps": {
  "height": 185,
  "stickyStyle": {
    "font-size": "9pt",
    "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
  },
  "stickyStyles_defaultTag": "div",
  "font_defaultLabel": "Segoe UI",
  "fontSize_defaultLabel": "9",
  "toolbarLocation": "bottom",
  "toolbar": [
  [ "CopyFormatting" ],
  [ "Font" ],
  [ "FontSize" ],
  [ "Bold" ],
  [ "Italic" ],
  [ "Underline" ],
  [ "BGColor" ],
  [ "TextColor" ],
  [ "BulletedList" ],
  [ "NumberedList" ],
  [ "Outdent" ],
  [ "Indent" ],
  [ "Blockquote" ],
  [ "JustifyLeft" ],
  [ "JustifyCenter" ],
  [ "JustifyRight" ],
  [ "Link" ],
  [ "Unlink" ],
  [ "Subscript" ],
  [ "Superscript" ],
  [ "Strike" ],
  [ "Image" ],
  [ "BidiLtr" ],
  [ "BidiRtl" ],
  [ "Undo" ],
  [ "Redo" ],
  [ "RemoveFormat" ],
  [ "Table" ]
 ],
  "plugins": [["button,toolbar,dialogui,dialog,autogrow,notification,clipboard,textmatch,fakeobjects,link,autolink,basicstyles,bidi,blockquote,panelbutton,panel,floatpanel,colorbutton,colordialog,listblock,richcombo,menu,contextmenu,copyformatting,enterkey,entities,popup,find,floatingspace,font,format,htmlwriter,horizontalrule,indent,indentblock,indentlist,justify,lineutils,openlink,list,liststyle,maximize,undo,menubutton,notificationaggregator,xml,ajax,pastetools,pastefromword,pastetext,preview,table,quicktable,removeformat,resize,selectall,showborders,sourcearea,specialchar,stylescombo,tab,tabletools,tableresize,tableselection,widgetselection,widget,wysiwygarea,textwatcher"]],
  "extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filebrowser,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,notification,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools,uploadfile,uploadimage,uploadwidget",
  "removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
  "superimageImageMaxSize": 5,
  "disallowedContent": "form[action]; *[formaction]; script; *[on*]",
  "linkTargets": ["notSet", "_blank"],
},
"attachmentEntity": {
  "name": "msdyn_richtextfiles",
  "fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"externalPlugins": [
  {
    "name": "EmbedMedia",
    "path": "/WebResources/msdyncrm_/myplugins/embedmedia/"
  }
],
"imageEntity": {
  "imageEntityName": "msdyn_richtextfiles",
  "imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
  "height": 500,
  "showFullScreenExpander": true
},
"sanitizerAllowlist": {
  "attributes": [],
  "cssProperties": [],
  "domains": [],
  "protocols": [],
  "tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false,
"allowSameOriginSandbox": false

defaultSupportedProps

A tabela seguinte descreve as propriedades mais utilizadas, mas pode configurar todas as propriedades que o CKEditor suporta. O controlo de editor de texto formatado utiliza o CKEditor 4.

Property Descrição Default value
altura Define a altura inicial da área de conteúdo, em pixeis. "185"
stickyStyle Define o tipo de letra e tamanho do editor. Ver defaultSupportedProps
stickyStyles_defaultTag Cria um wrapper à volta do texto na área de conteúdo do editor. Está inicialmente definido como "div", mas pode alterá-lo para "p" ou qualquer etiqueta alternativa. "div"
font_defaultLabel Define a etiqueta de tipo de letra apresentada na barra de ferramentas. A etiqueta só tem aspeto e não é funcional. A propriedade stickyStyle determina o tipo de letra e tamanho do editor. "Segoe UI"
fontSize_defaultLabel Define a etiqueta do tamanho de tipo de letra apresentada na barra de ferramentas. A etiqueta só tem aspeto e não é funcional. A propriedade stickyStyle determina o tipo de letra e tamanho do editor. "9"
toolbarLocation Define a localização da barra de ferramentas na área de conteúdo do editor. Os valores suportados são "superior" e "inferior". "inferior"
barra de ferramentas Lista os botões da barra de ferramentas a apresentar. Ver defaultSupportedProps
plug-ins Listas de plug-ins predefinidos que o editor pode utilizar. Os plug-ins nesta lista poderão ser diferentes dos plug-ins carregados, se for atribuído um valor a extraPlugins e removePlugins. Se definir esta propriedade para uma cadeia vazia, o editor é carregado sem a barra de ferramentas. Ver defaultSupportedProps
extraPlugins Anexa plug-ins à lista plugins para carregar mais plug-ins.
Muitos plug-ins requerem outros plug-ins para funcionarem. O editor de texto formatado adiciona-os automaticamente e não pode utilizar esta propriedade para os definir manualmente. Utilize removePlugins em substituição.
Ver defaultSupportedProps
removePlugins Listas de plug-ins a não carregar. Utilize-o para alterar os plug-ins que são carregados sem alterar as listas de plugins e extraPlugins. Ver defaultSupportedProps
superimageImageMaxSize Define o tamanho máximo em megabytes (MB) permitido para imagens incorporadas ao utilizar o plug-in superimage. "5"
disallowedContent Permite-lhe prevenir os utilizadores de introduzirem elementos que não pretende no seu conteúdo. É possível não permitir elementos completos ou por atributos, classes e estilos. Ver defaultSupportedProps
linkTargets Permite-lhe configurar que opções de destino da ligação estão disponíveis para os utilizadores quando criarem ligações:
- "notSet": sem destino definido
- "frame": abre o documento no intervalo especificado
- popupWindow": abre o documento numa janela de pop-up
- "_blank": abre o documento numa nova janela ou separador
- "_top": abre o documento no corpo completo da janela
- "_self": abre o documento na mesma janela ou separador em que a ligação está ativada
- "_parent": abre o documento no intervalo principal
"notSet", "_blank"

Propriedades individuais

A tabela seguinte descreve mais propriedades que pode utilizar para personalizar o controlo de editor de texto formatado.

Property Descrição Default value
attachmentEntity Para impor mais segurança em ficheiros carregados ao utilizar uma tabela que não a predefinida, defina esta propriedade e especifique uma tabela diferente.
Sintaxe: "name": "tableName", "fileAttributeName": "attributeNameofBlobReference"
Ver defaultSupportedProps
disableContentSanitization A limpeza de conteúdo remove algumas das etiquetas ou atributos personalizados a partir de conteúdo de texto formatado. Está desativada por predefinição para permitir a cópia e a colagem de conteúdo de texto formatado proveniente de origens externas. Esta propriedade aplica-se apenas ao modo de edição. Quando o controlo do editor é só de leitura ou está desativado, o conteúdo é sempre limpo. verdadeiro
disableDefaultImageProcessing Por predefinição, as imagens inseridas no editor são carregadas para o attachmentEntity definido na configuração. Os utilizadores externos podem não ter privilégios para ver o conteúdo na tabela. Em vez disso, defina esta propriedade como verdadeira para armazenar imagens como cadeias base64 diretamente na coluna configurada para utilizar o controlo do editor de texto formatado. false
disableImages Determina se as imagens podem ser introduzidas no editor. Esta propriedade tem a prioridade máxima. Quando esta propriedade está definida como verdadeira, as imagens são desativadas, independentemente do valor da propriedade imageEntity. false
externalPlugins Lista de plug-ins externos ou plug-ins que cria e que podem ser utilizados no controlo do editor de texto formatado.
Sintaxe: "name": "pluginName", "path": "pathToPlugin" (o valor do caminho pode ser um URL absoluto ou relativo)
Nenhum; consulte defaultSupportedProps como exemplo
imageEntity Para impor mais segurança em imagens ao utilizar uma tabela que não a predefinida, defina esta propriedade e especifique uma tabela diferente.
Sintaxe: "imageEntityName": "tableName", "imageFileAttributeName": "attributeNameofBlobReference"
Ver defaultSupportedProps
readOnlySettings Estas propriedades determinam o comportamento da coluna quando visualizada num estado só de leitura ou desativado. Pode especificar qualquer propriedade suportada. Nenhum; consulte defaultSupportedProps como exemplo
sanitizerAllowlist Lista outros tipos de conteúdo que podem ser apresentados no editor. Ver defaultSupportedProps
showAsTabControl Permite-lhe apresentar mais comandos acima da área de conteúdo. Deve ser definido como verdadeiro para utilizar as seguintes propriedades: showFullScreenExpander, showHtml, showPreview, showPreviewHeaderWarning false
showFullScreenExpander Determina se o editor pode ser utilizado em modo de ecrã inteiro. showAsTabControl tem de ser definido como verdadeiro. false
showHtml Permite que os utilizadores apresentem e editem o conteúdo HTML diretamente. showAsTabControl tem de ser definido como verdadeiro. false
showPreview Permite que os utilizadores pré-visualizem o conteúdo do editor como HTML. showAsTabControl tem de ser definido como verdadeiro. false
showPreviewHeaderWarning Permite-lhe mostrar ou ocultar a mensagem de aviso que é exibida ao visualizar o conteúdo. showAsTabControl e showPreview têm de ser definidos como verdadeiro. false
allowSameOriginSandbox Permite que o conteúdo no editor seja tratado como da mesma origem que a aplicação de composição.
Utilize esta propriedade com atenção. Utilize apenas conteúdo externo fidedigno. Quando esta propriedade está definida como verdadeira, qualquer conteúdo externo poderá ter acesso aos recursos internos.
false

Configurações de exemplo

As seguintes configurações de exemplo criam personalizações específicas do editor de texto formatado na experiência clássica. Pode utilizá-los como estão ou como um ponto de mudança para personalizar uma instância específica do editor de texto formatado ou globalmente.

Definir o tipo de letra predefinido como Calibri de 11 pontos

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"font_defaultLabel": "Calibri",
"fontSize_defaultLabel": "11",
"stickyStyle": {
  "font-size": "11pt",
  "font-family": "Calibri/Calibri, Helvetica, sans-serif;"
},

Fazer com que a tecla Enter introduza uma nova linha em vez de um bloco de parágrafo

Por predefinição, a tecla Enter cria um bloco de parágrafo com a etiqueta HTML <p>. O HTML utiliza blocos de parágrafo para agrupar informações, tal como parágrafos num documento do Word. Os browsers podem formatar a <p> etiqueta de forma ligeiramente diferente, pelo que, para consistência visual, poderá querer utilizar a nova etiqueta de linha ou de quebra de linha <br\>.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"enterMode": 2,

Colar ou criar conteúdo de HTML 5 apenas

Apresar de o controlo de editor de texto formatado funcionar melhor com conteúdo HTML 5, pode utilizar as etiquetas de HTML 4. No entanto, em alguns casos, a combinação de etiquetas de HTML 4 e HTML 5 pode criar desafios de usabilidade. Para se certificar de que todo o conteúdo é HTML 5, forneça todas as etiquetas de HTML 5 suportadas na propriedade allowedContent. O controlo de editor converte quaisquer etiquetas não conformes para o seu equivalente de HTML 5.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"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(*)[*]{*};",

Colar ou criar apenas texto simples

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"enterMode": 2,
"shiftEnterMode": 2,
"allowedContent": "*",
"disallowedContent": "*",
"forcePasteAsPlainText": true,
"toolbar": [],
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Defina esta propriedade individual no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"disableImages": true,

Permitir que o editor utilize o ecrã inteiro

Defina estas propriedades individuais no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"showAsTabControl": true,
"showFullScreenExpander": true,

Captura de ecrã do editor de texto formatado, com o controlo de expansor de ecrã inteiro realçado.

Permitir a visualização e edição de conteúdos HTML

Para permitir que os utilizadores vejam e editem o HTML do seu conteúdo diretamente, mostre o separador HTML .

Defina estas propriedades individuais no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"showAsTabControl": true,
"showHtml": true,

Captura de ecrã do editor de texto formatado, com o controlo do separador HTML realçado.

Mostrar uma barra de ferramentas simplificada ou removê-la totalmente

Por predefinição, a barra de ferramentas do editor contém todas as ferramentas de formatação disponíveis. Para fornecer uma barra de ferramentas simplificada, utilize a propriedade toolbar e especifique as ferramentas que os utilizadores podem utilizar para formatar o respetivo conteúdo.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ],

Captura de ecrã do editor de texto formatado, com uma barra de ferramentas simplificada realçada.

Para remover totalmente a barra de ferramentas, definira o valor de toolbar como '[]' (dois parêntesis retos).

Adicionar uma nova lista de tipos de letra e definir Brush Script MT de 20 pixeis como o tipo de letra predefinido

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"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"
},

Captura de ecrã do editor de texto formatado com Brush Script como o tipo de letra predefinido e uma nova lista de tipos de letra.

Posicione a barra de ferramentas no topo do editor de texto formatado

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"toolbarLocation": "top",

Iniciar o editor a 30 pixeis de altura e aumentar para se ajustar ao conteúdo

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"autoGrow_onStartup": false,
"autoGrow_maxHeight": 0,
"autoGrow_minHeight": 30,
"height": 30,

Captura de ecrã que ilustra que escrever na área de texto formatado ou colar uma imagem aumenta-a para se adequar ao conteúdo.

Fixar a altura do editor para 500 pixeis

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"removePlugins": [ "autogrow" ],
"height": 500,

Captura de ecrã que ilustra que, com uma altura fixa, quando é adicionado conteúdo suficiente à área de texto formatado, aparece uma barra de deslocamento.

Fazer com que o menu de contexto (clique com o botão direito do rato) utilize o menu de contexto predefinido do browser

Para substituir o menu de contexto do controlo de editor pelo menu de contexto predefinido do browser, remova o plug-in contextmenu.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Localizar a configuração de um controlo de editor de texto formatado

Se não tiver a certeza de onde vem a configuração de uma instância do editor de texto formatado, poderá encontrá-la utilizando as ferramentas de programação do browser.

  1. No Microsoft Edge ou Google Chrome, execute a sua aplicação condicionada por modelo e abra um formulário que tem o controlo de editor de texto formatado.
  2. Clique com o botão direito do rato na área de conteúdo de editor de texto formatado e selecione Inspecionar.
  3. No painel de inspeção, selecione o separador Consola.
  4. Selecione a página principal Main.aspx na caixa de lista da barra de comandos.

Captura de ecrã das ferramentas de programação do browser, com o separador Consola e a página main.aspx realçadas.

  1. Selecione o ícone Limpar consola na barra de comandos do painel de inspeção e, em seguida, introduza CKEDITOR.config. na consola.

Captura de ecrã das ferramentas de programação do browser, com o ícone Limpar consola realçado.

  1. Na consola do painel de inspeção, insira CKEDITOR.config. para apresentar as diferentes configurações.

Lista de configurações do Editor CK.

  1. Selecione uma configuração, como autoGrow_minHeight, para visualizar a definição atual.

A barra de ferramentas do editor de texto formatado

A tabela seguinte descreve as ferramentas de formatação disponíveis no editor de texto formatado por predefinição.

Icon Nome Atalho de teclado Descrição
Pincel de Formatação. Copiar Formatação Ctrl+Shift+C, Ctrl+Shift+V Aplicar a aparência de uma secção específica a outra secção.
Tipo de letra. Nome do Tipo de Letra Ctrl+Shift+F Selecione um tipo de letra. A aplicação considera o tipo de letra que selecionou como tipo de letra predefinido. Segoe UI é o tipo de letra predefinido, se não selecionar um.

Quando seleciona qualquer conteúdo formatado, é apresentado o nome do tipo de letra aplicado ao mesmo. Se a seleção contiver vários tipos de letras, é apresentado o primeiro aplicado à seleção.
Tamanho do Tipo de Letra. Tamanho do Tipo de Letra Ctrl+Shift+P Altere o tamanho do seu texto. A aplicação considera o tamanho do tipo de letra que selecionou como tamanho predefinido. 12 é o tamanho predefinido, se não selecionar um.

Quando seleciona conteúdo formatado, é apresentado o tamanho do tipo de letra aplicado ao mesmo. Se a seleção contiver vários tamanhos, é apresentado o primeiro aplicado à seleção.
Negrito. Negrito Ctrl+N Coloque o texto em negrito.
Itálico. Italic Ctrl+I Coloque o texto em itálico.
Sublinhado. Sublinhado Ctrl+S Coloque o texto em sublinhado.
Cor de Realce do Texto. Cor de Fundo Para destacar o texto, realce-o com uma cor brilhante.
Cor do Tipo de Letra. Cor do Texto Altere a cor do seu texto.
Marcas. Inserir/Remover Lista com Marcas Crie uma lista com marcas.
Numerar. Inserir/Remover Lista Numerada Crie uma lista numerada.
Diminuir Avanço. Diminuir Avanço Mova o parágrafo para mais perto da margem.
Aumentar Avanço. Aumentar Avanço Afaste o parágrafo da margem.
Trecho em Bloco. Trecho em Bloco Aplique um formato de cotação a nível de bloco ao seu conteúdo.
Alinhar à Esquerda. Alinhar à Esquerda Ctrl+L Alinhe o conteúdo com a margem esquerda.
Alinhar ao Centro. Alinhar ao Centro Ctrl+E Centre o conteúdo na página.
Alinhar à Direita. Alinhar à Direita Ctrl+R Alinhe o seu conteúdo com a margem direita.
Ligação. Associar Crie uma ligação no documento para aceder rapidamente a páginas web e outros recursos da cloud. Introduza ou cole o texto de ancoragem na caixa Apresentar Texto e, em seguida, introduza ou cole o URL na caixa URL.

Opcionalmente, selecione um Tipo de Ligação e um protocolo se a ligação for para algo diferente de uma página web. Para especificar onde uma ligação do tipo URL deve ser aberta, selecione o separador Destino e, em seguida, selecione um Destino.

Um URL colado ou digitado é automaticamente convertido numa ligação. Por exemplo, http://myexample.com passa a <a href="http://myexample.com">http://myexample.com</a>.
Remover Associação. Desassociar Remova a ligação de uma âncora e torne-a em texto simples.
Superior à Linha. Superior à Linha Escreva letras pequenas logo acima da linha de texto.
Inferior à Linha. Inferior à Linha Escreva letras pequenas logo abaixo da linha de texto.
Rasurado. Rasurado Rasure o texto desenhando uma linha através dele.
Inserir Imagem. Image Para introduzir uma imagem, cole-a a partir da área de transferência na área de conteúdo ou arraste um ficheiro de imagem de uma pasta para a área de conteúdo. Arraste qualquer canto da imagem para a redimensionar. O controlo suporta imagens .png, .jpg. e .gif.

Para ter mais controlo sobre a origem, aspeto e comportamento da imagem, selecione o botão Imagem. Procure o ficheiro de imagem numa pasta local ou introduza o seu URL. Se a imagem estiver armazenada num servidor externo, introduza o caminho absoluto. Se estiver num servidor local, pode introduzir um caminho relativo. Opcionalmente, introduza uma altura e largura específicas para redimensionar a imagem e selecionar um alinhamento. Também deve introduzir texto alternativo para descrever a imagem para as pessoas que utilizam leitores de ecrã.

Se a imagem também for uma ligação a uma página web ou a outro recurso na cloud, introduza o URL do recurso na caixa URL de Destino e, se necessário, selecione o Destino onde a ligação deve ser aberta.
Da Esquerda para a Direita. Orientação do texto da esquerda para a direita Altere o texto da esquerda para a direita. Esta é a predefinição.
Da direita para a esquerda. Orientação do texto da direita para a esquerda Altere o texto para da direita para a esquerda para conteúdo de idioma bidirecional.
Anular. Anular Inverter a última alteração que e fez ao conteúdo.
Refazer. Refazer Anular a última anulação ou voltar a aplicar a última alteração que fez ao conteúdo.
Limpar Todas as Formatações. Remover Formato Remover toda a formatação do texto selecionado.
Tabela. Table Introduza uma tabela com o número de linhas e colunas que selecionou. Para ter mais controlo sobre o tamanho e aspeto da tabela, selecione o botão Tabela > Mais e altere as propriedades da tabela. Pode também clicar com o botão direito do rato numa tabela para ver e alterar as propriedades da tabela.

Para alterar a largura de uma coluna, arraste o limite. Pode selecionar uma ou mais células, linhas ou colunas e aplicar a formatação específica e adicionar uma ligação ao texto selecionado e cortar, copiar e colar linhas ou colunas inteiras.
Definições de Personalização Predefina o tipo de letra e o tamanho do tipo de letra.
Ajuda de Acessibilidade Alt + 0 Abra a lista de atalhos de teclado que pode utilizar no editor de texto formatado.
Expandir Barra de Ferramentas. Expandir Barra de Ferramentas Quando a janela for demasiado estreita para mostrar a barra de ferramentas completa, selecione para expandir a barra de ferramentas para uma segunda linha.

Dica

Para utilizar a verificação de ortografia integrada do browser, prima a tecla Ctrl e clique com o botão direito do rato em simultâneo no texto que pretende verificar. Caso contrário, o menu de clique com o botão direito do rato (contexto) fornece formatação contextual para o elemento que selecionou.
Uma alternativa à verificação de ortografia incorporada do seu browser é a extensão de browser do Microsoft Editor. O Microsoft Editor funciona perfeitamente com o controlo de editor de texto formatado e, quando ativado, fornece capacidades de gramática e de verificação ortográfica rápidas e fáceis.

Utilizar o editor de texto formatado offline

O controlo de editor de texto formatado está disponível quando está a trabalhar offline, embora sem algumas das funcionalidades a que está habituado. As imagens que carrega utilizando a configuração predefinida do editor não estão disponíveis quando está a trabalhar offline.

Os seguintes plug-ins estão disponíveis para o editor de texto formatado enquanto está 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

As seguintes ferramentas de formatação estão disponíveis no editor de texto formatado enquanto está offline:

  • Negrito, itálico, sublinhado, listas com pontos e números, reduzir e aumentar avanço, trecho em bloco, alinhar à esquerda, alinhar ao centro, alinhar à direita, rasurar, texto bidirecional, anular e refazer, e remover formatação

Melhores práticas para usar o editor de texto formatado

  • Os campos de texto formatado armazenam etiquetas HTML para formatação juntamente com os dados introduzidos pelo utilizador. Quando definir o tamanho máximo de campos de texto formatado, certifique-se de que permite tanto as etiquetas de HTML como os dados do utilizador.

  • Para o melhor desempenho, mantenha o conteúdo HTML até 1 MB ou menos. Em tamanhos maiores, pode observar tempos de resposta mais lentos a carregar e editar.

  • Na configuração predefinida, as imagens não afetam negativamente o desempenho porque são armazenadas separadamente do conteúdo HTML. No entanto, as imagens são armazenadas como conteúdo base64 na coluna de texto quando o utilizador que as carrega não tem permissões sobre a tabela msdyn_richtextfiles. O conteúdo base64 é grande, por isso geralmente não quer armazenar imagens como parte do conteúdo da coluna.

  • Se tiver um direito de acesso de administrador de sistema ou utilizador básico, a funcionalidade de personalização do utilizador funciona por predefinição. Se não tiver estas funções, tem de ter privilégios para criar, ler e escrever na tabela msdyn_customcontrolextendedsettings para o plug-in de personalização do utilizador funcionar.

Perguntas mais frequentes

Por que motivo os carateres digitados são apresentados lentamente?

Se tiver muito conteúdo no editor, o tempo de resposta pode aumentar. Mantenha o conteúdo até 1 MB ou menos para o melhor desempenho. A verificações de ortografia gramática também podem atrasar o desempenho da datilografia.

Porque é que não consigo carregar uma imagem? Porque é que a pré-visualização de imagem não é carregada?

Se o nome do ficheiro de imagem, incluindo o caminho, for longo, é possível que o ficheiro não seja carregado ou a pré-visualização poderá não ser apresentada. Tente encurtar o nome do ficheiro ou mover o ficheiro para uma localização com um caminho mais curto e, em seguida, carregue-o novamente.

Porque é que estou a ver HTML no meu texto?

Se o controlo do editor de texto formatado for utilizado numa coluna que não seja formatada para texto formatado, o conteúdo aparece no HTML subjacente em vez de texto formatado.

Captura de ecrã do HTML que aparece na área de conteúdo do editor.

Para resolver este problema, certifique-se de que o formato da coluna está definido como Texto Formatado.

Consultar também

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).