Última modificação: 22 de agosto de 2025
Como desenvolvedor, em alguns casos, os editores da WYSIWYG fornecem funcionalidades que, quando usadas incorretamente, podem atrapalhar o objetivo de uma marca unificada e causar problemas de design e fluxo de conteúdo. O editor de rich text nos módulos personalizados agora permite que os desenvolvedores removam componentes da barra de ferramentas de configuração por meio da propriedade enabled_features contida no arquivo fields.json.
Observação: o seguinte se aplica a módulos personalizados que utilizam o campo de rich text apenas para desenvolvimento local. O uso deste recurso não desativará a funcionalidade das opções removidas do editor de rich text, apenas a exibição das opções. Isso é devido a questões de compatibilidade com versões anteriores e, portanto, o conteúdo existente não é afetado.

Como usar enabled_features

No arquivo fields.json que inclui o objeto de campo de rich text, você pode habilitar certos recursos adicionando as opções de barra de ferramentas válidas em um array na propriedade enabled_features, conforme ilustrado abaixo:
// Rich text field with only Bold, Link, and Image available in the Toolbar
{
  "name": "description",
  "label": "Description",
  "required": false,
  "locked": false,
  "type": "richtext",
  "default": null,
  "enabled_features": ["bold", "link", "image"]
}
O editor de conteúdo veria o editor de rich text somente com as opções incluídas habilitadas, conforme ilustrado na imagem abaixo:
Observação: alguns recursos, como o botão “Limpar estilos”, que permite reverter para o estilo padrão do editor, sempre estão habilitados e não podem ser removidos. Se a propriedade enabled_features for omitida, todos os recursos serão exibidos.
Um exemplo de uma barra de ferramentas RTE com recursos habilitados.

Listagens de recursos

Veja abaixo uma lista de recursos que podem ser habilitados individualmente ao usar a propriedade enabled_features.

Grupos de controles

OpçãoDescription
colorsControles de cor do texto e do fundo.
fontsFamília de fontes e controles de tamanho de fonte.
indentsControles externos e de recuo.
listsControles de listas numeradas e com marcadores.
standard_emphasisControles de negrito, itálico e sublinhado.
advanced_emphasisControles de formato riscado, sobrescrito, subscrito e código.
glyphsControles de emojis, caracteres especiais e ícones. Não compatível com módulos de e-mail. Para adicionar o seletor de emojis aos módulos de e-mail, use emoji.

Formatação de texto

OpçãoDescription
blockMostra o menu suspenso do seletor de estilo.
font_familyMostra o menu suspenso do alternador de fonte.
font_sizeMostra o menu suspenso do tamanho da fonte.
boldMostra o botão de negrito.
italicMostra o botão de itálico.
underlineMostra o botão de sublinhado.
text_colorMostra o botão de cor do texto.
background_colorMostra o botão de cor do fundo.
alignmentMostra o botão de alinhamento.
bulleted_listMostra o botão de lista com marcadores.
numbered_listMostra o botão de listas numeradas.
lineheightMostra o botão de altura da linha.
outdentMostra o botão de recuo à esquerda.
indentMostra o botão de recuo.
strikethroughMostra o botão de riscado.
superscriptMostra o botão de sobrescrito.
subscriptMostra o botão de subscrito.
code_formatMostra o botão de formato de código.

Botões Inserir

OpçãoDescription
linkMostra o botão de link.
imageMostra o botão de imagem. Não compatível com módulos de e-mail.
emojiMostra o botão de emojis.
personalizeMostra o item de personalização da barra de ferramentas.
ctaMostra o item do menu Call to action no menu Inserir.
embedMostra o item de menu Incorporar no menu Inserir.
videoMostra o item de menu Vídeo no menu Inserir.
tableMostra o item de menu Tabela no menu Inserir.
charmapMostra o item de menu Caracteres especiais no menu Inserir.
anchorMostra o item de menu Âncora no menu Inserir.
hrMostra o item de menu Linha horizontal no menu Inserir.
nonbreaking_spaceMostra o item de menu Espaço não separável no menu Inserir.
iconMostra o item de menu Ícones no menu Inserir.

Opções avançadas

OpçãoDescription
source_codeMostra o item de menu Código-fonte no menu Avançado.
visual_blocksMostra o item de menu Mostrar blocos no menu Avançado.