Texto rico

Introdução

No NocoBase, o texto rico (Rich text) é usado para armazenar conteúdo formatado.

O campo de texto rico é adequado para o corpo de avisos, artigos, modelos de e-mail, documentos de instruções e outros conteúdos. Ele oferece uma experiência mais próxima da edição WYSIWYG.

Se a equipe estiver acostumada com Markdown ou precisar de um formato de texto simples e controlável, escolha Markdown ou Markdown Vditor.

Cenários de uso

O texto rico é adequado para os seguintes cenários de negócio:

  • Corpo de avisos e artigos
  • Modelos de e-mail e de notificações
  • Instruções de produtos e operações
  • Conteúdo que precisa de imagens, links e estilos

Criação e configuração

Na página «Configure fields» da tabela de dados, clique em «Add field» e selecione «Texto rico» para criar um campo de texto rico.

20240512181002

ConfiguraçãoDescrição
Field interfaceTipo de interface do campo. Para texto rico, corresponde a richText e determina como o campo será preenchido e exibido na página.
Field display nameNome exibido do campo na interface, como «Corpo do aviso», «Modelo de e-mail» ou «Instruções do produto». Recomenda-se usar um nome que os usuários de negócio possam compreender diretamente.
Field nameNome identificador do campo, usado em referências internas como API, campos de relação, permissões e fluxos de trabalho. Normalmente não pode ser alterado após a criação; aceita apenas letras, números e sublinhados, e deve começar com uma letra.
Field typeTipo do campo na camada de dados. Os campos de texto rico normalmente usam text para armazenar o conteúdo.
Default valueValor padrão. Ao criar um registro, se o usuário não preencher o campo, o valor padrão poderá ser inserido automaticamente.
Validation rulesRegras de validação. Podem limitar o comprimento ou exigir o preenchimento.
DescriptionDescrição do campo. É adequado informar o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
Atenção

O nome do campo será referenciado por blocos de página, permissões, fluxos de trabalho e APIs. Confirme a nomenclatura antes da criação para evitar custos de ajuste de configuração posteriormente.

Características do campo

O comportamento padrão do campo de texto rico é o seguinte:

CaracterísticaDescrição
Field interface padrãorichText.
Field type padrãotext.
Field type opcionaltext.
Componente da páginaO modo de edição usa um editor de texto rico.
FiltragemOferece suporte a filtros de texto, como contém, está vazio e não está vazio.
OrdenaçãoNormalmente não é usado para ordenação.
ValidaçãoOferece suporte a validações de texto, como comprimento e preenchimento obrigatório.

Edição da configuração

Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo de texto rico. A edição do campo serve principalmente para ajustar a forma como ele é exibido e usado no NocoBase, como alterar o nome de exibição, a descrição, o valor padrão, as regras de validação ou as configurações específicas do campo.

Se o campo vier de uma tabela já sincronizada no banco de dados principal, a edição normalmente consiste em fazer um mapeamento de campo — mapear o campo do banco de dados para o Field type e o Field interface do NocoBase.

ConfiguraçãoPode ser editadaDescrição
Field display nameSimAltera o nome exibido do campo na interface, sem alterar o nome identificador do campo.
Field nameNãoNormalmente, o nome identificador do campo não pode ser alterado no formulário de edição após a criação.
Field interfaceSuporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento de campos. O ajuste afetará a forma de entrada, exibição e validação na página.
Field typeSuporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento de campos. Antes do ajuste, é necessário confirmar se os dados existentes podem ser usados com o novo tipo.
Default valueSimAjusta o valor padrão dos novos registros.
Validation rulesSimAjusta as regras de validação do campo.
DescriptionSimComplementa o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
Atenção

Alternar o Field type ou o Field interface não equivale a simplesmente alterar um nome de exibição. Isso afeta a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtragem e a forma de uso das variáveis em fluxos de trabalho. Quando houver muitos dados existentes, confirme primeiro se o formato dos dados é compatível.

Exclusão do campo

Clique em «Delete» à direita do campo para excluir o campo de texto rico. No banco de dados principal, também é possível selecionar vários campos e excluí-los em lote.

Ao excluir um campo de texto rico criado no banco de dados principal, normalmente a coluna real correspondente no banco de dados e os dados já existentes nessa coluna também serão excluídos. Ao excluir um campo sincronizado do banco de dados ou mapeado de uma fonte de dados externa, o impacto dependerá da fonte de dados e da origem do campo correspondente.

Aviso

A exclusão de um campo pode afetar blocos de página, formulários, filtros, permissões, fluxos de trabalho, APIs, importações, exportações e dados existentes. Antes de excluir, confirme se o campo ainda é referenciado por alguma configuração de negócio.

Uso na configuração de páginas

O campo de texto rico é adequado para cenários de edição e exibição de conteúdo. 20260709231418

CenárioUso
Bloco de formulárioEditar conteúdo de texto rico.
Bloco de detalhesExibir o conteúdo no formato de texto rico.
Modelo de e-mail ou notificaçãoServir como fonte do corpo do modelo.
Bloco de tabelaExibir um resumo ou conteúdo simplificado.
  • Campo — Entenda a função, as categorias e a lógica de mapeamento dos campos
  • Tabela comum — Criar e gerenciar campos em uma tabela comum
  • Markdown — Armazenar conteúdo em Markdown
  • Markdown Vditor — Usar o Vditor para editar Markdown