Texto
Nesta seção
Entenda os campos de texto do ENSPACE
Os campos de texto do ENSPACE são utilizados para exibir ou armazenar conteúdos textuais em formulários, tarefas e telas.
Eles podem ser usados para:
- coletar informações digitadas pelos usuários;
- exibir conteúdos visuais;
- estruturar formulários;
- aplicar formatações automáticas;
- padronizar dados;
- melhorar a experiência de preenchimento.
Tipos disponíveis e quando utilizar
Comparação entre os campos
| Recurso | Texto | Texto Longo | HTML |
|---|---|---|---|
| Aceita múltiplas linhas | Não | Sim | Sim |
| Permite quebra de linha | Não | Não | Sim |
| Possui transformadores | Sim | Sim | Não |
| Possui máscaras | Sim | Sim | Não |
| Aceita HTML personalizado | Não | Não | Sim |
| Possui transcrição de voz | Sim | Sim | Não |
| Possui botão de cópia | Sim | Sim | Não |
Como os campos de texto funcionam
Os campos Texto e Texto Longo funcionam como campos de string com recursos adicionais de processamento e formatação.
Isso significa que eles podem:
- transformar automaticamente valores digitados;
- aplicar máscaras;
- limitar caracteres;
- padronizar conteúdo;
- modificar o valor salvo no sistema.
Já o campo HTML possui comportamento diferente, renderizando conteúdos visuais diretamente na interface.
Recursos compartilhados
Os campos Texto e Texto Longo compartilham diversos recursos de processamento e formatação.
Transformadores de texto
Transformadores alteram automaticamente o conteúdo digitado pelo usuário antes do armazenamento.
Eles são úteis para:
- padronizar dados;
- facilitar buscas;
- melhorar integrações;
- evitar inconsistências.
| Transformador | Descrição | Exemplo |
|---|---|---|
| Lowercase | Converte todo o texto para minúsculas. | João SILVA → joão silva |
| Uppercase | Converte todo o texto para maiúsculas. | João Silva → JOÃO SILVA |
| Deburr | Remove acentos e caracteres especiais. | João Çá → Joao Ca |
| Trim | Remove espaços extras no início e no final do texto. | João Silva → João Silva |
| Kebab Case | Converte o texto para formato kebab-case. | João Silva → joao-silva |
| Camel Case | Converte o texto para formato camelCase. | João Silva → joaoSilva |
| Snake Case | Converte o texto para formato snake_case. | João Silva → joao_silva |
| Capitalização | Capitaliza a primeira letra de cada palavra mantendo o restante minúsculo. | joÃO silVA → João Silva |
| Start Case | Capitaliza palavras removendo espaços extras. | joão silva → João Silva |
| Title Case | Capitaliza palavras principais, ignorando artigos e preposições quando aplicável. | senhor dos aneis → Senhor dos Aneis |
| Número por extenso | Converte números para texto por extenso. | 152 → cento e cinquenta e dois |
| remove_space | Remove todos os espaços do conteúdo. | João Silva → JoãoSilva |
Botão de cópia
Quando habilitado, adiciona um botão de cópia no lado direito do campo.
Esse recurso é útil para:
- protocolos;
- identificadores;
- links;
- códigos internos;
- conteúdos reutilizados com frequência.
Transcrição de voz
Permite que o usuário preencha o campo utilizando fala.
O botão de voz aparece no lado esquerdo da área de digitação.
A funcionalidade funciona em navegadores compatíveis com reconhecimento de voz.
Máscaras
As máscaras formatam automaticamente o conteúdo digitado pelo usuário conforme padrões específicos.
Elas ajudam a:
- padronizar informações;
- orientar preenchimento;
- evitar formatos inválidos;
- melhorar consistência dos dados.
Máscaras disponíveis
| Máscara | Exemplo |
|---|---|
| CPF | 999.999.999-99 |
| CNPJ | 99.999.999/9999-99 |
| CEL | (99) 99999-9999 |
| CEP | 99999-999 |
| RG | 99.999.999-9 |
| OAB | 999999-UF |
| Nº CNJ | 9999999-99.9999.9.99.9999 |
Máscaras personalizadas
Além das máscaras prontas, você pode criar formatos personalizados utilizando caracteres especiais.
| Símbolo | Significado |
|---|---|
@ | Aceita apenas letras |
# | Aceita apenas números |
* | Aceita letras ou números |
Exemplos
| Máscara | Resultado esperado |
|---|---|
###.###.###-## | CPF |
@@@-#### | Código misto |
**-**** | Identificador alfanumérico |
@@-###-@@ | Código personalizado |
Máscaras vs validações
| Aspecto | Máscaras | Validações |
|---|---|---|
| Quando atuam | Durante a digitação | Antes do salvamento |
| Objetivo | Guiar e formatar o preenchimento | Verificar regras do campo |
| Formata automaticamente | Sim | Não |
| Restringe caracteres inválidos | Sim | Sim |
| Uso comum | CPF, telefone, CEP | Campo obrigatório, limites e regras |
Comportamento dos dados
As configurações aplicadas nos campos podem alterar diretamente o valor salvo no sistema.
Isso significa que:
- transformadores modificam o conteúdo armazenado;
- máscaras influenciam o formato salvo;
- limites de caracteres restringem o conteúdo aceito.
Algumas alterações afetam apenas novos preenchimentos.
Exemplo:
- remover um transformador não altera dados antigos;
- adicionar uma máscara não modifica registros já existentes;
- conteúdos anteriores só mudam se forem editados novamente.
Casos de uso
- Texto: nomes completos, CPF, CNPJ, telefone, e-mail, protocolos, códigos de produto, identificadores únicos, links curtos.
- Texto Longo: descrições de produtos, relatórios de atendimento, observações detalhadas, feedbacks, instruções operacionais, notas internas.
- HTML: termos de uso, manuais de instrução, avisos formatados, conteúdo com imagens, descrições visuais de produtos, cabeçalhos informativos.
Boas práticas
- Utilize Texto para informações curtas que precisam de máscaras, transformadores ou botão de cópia.
- Utilize Texto Longo quando o conteúdo exigir múltiplas linhas e o usuário precisar digitar descrições extensas.
- Utilize HTML apenas para exibição visual de conteúdo formatado, nunca para coleta de dados do usuário.
- Configure máscaras em campos de Texto para CPF, telefone e CEP, em vez de usar campos de Número.
- Combine transformadores para padronizar dados antes do armazenamento e evitar inconsistências no banco de dados.
- Lembre-se de que alterações em transformadores e máscaras não afetam registros já existentes — revise dados antigos manualmente se necessário.