Tipos de campo de conteúdo
Os tipos de campo definem que tipo de dado um campo armazena e como quem edita interage com ele. Escolher o tipo certo ajuda a manter o conteúdo consistente, mais fácil de gerenciar e mais fácil de reutilizar no projeto.
Vários valores
Seção intitulada “Vários valores”A maioria dos tipos de campo pode permitir vários valores. Nas configurações do campo, defina Permitir vários valores (ou Tipo de seleção para opções, referências, arquivos e componentes) como Múltiplo.
Quando Múltiplo está ativado, você também pode definir:
- Quantidade mínima: a menor quantidade de itens que quem edita deve informar
- Quantidade máxima: a maior quantidade de itens que pode ser adicionada
No editor de conteúdo, campos escalares (texto, número e similares) mostram um controle Adicionar … para que seja possível acrescentar outro valor. Campos de opção, referência, arquivo e componente mantêm as interfaces de seleção múltipla e de adição.
Campos de vários valores são expostos na API GraphQL como listas (por exemplo, [String] para um campo de texto múltiplo).
Campos de título precisam continuar sendo campos de texto de valor único.
Use Texto para valores curtos, como títulos, nomes, rótulos e slugs.
Em geral é a melhor escolha quando o conteúdo deve caber em uma única linha e não precisa de formatação.
Área de texto
Seção intitulada “Área de texto”Use Área de texto para texto simples mais longo, como resumos, notas, trechos ou descrições internas.
Escolha esta opção quando quem edita precisa de mais espaço para escrever, mas o conteúdo não exige formatação rica.
Texto rico
Seção intitulada “Texto rico”Use Texto rico para conteúdo formatado, como o corpo de um artigo, seções de página e textos de marketing mais longos.
Este tipo de campo foi feito para conteúdo que inclui estrutura ou estilo, como parágrafos, títulos, listas e links.
Booleano
Seção intitulada “Booleano”Use Booleano para valores verdadeiro ou falso, por exemplo se algo está em destaque, ativado ou visível.
Serve para interruptores e marcas simples.
Opção de seleção
Seção intitulada “Opção de seleção”Use Opção de seleção quando quem edita deve escolher em uma lista fixa de valores.
Isso ajuda a padronizar o conteúdo e a evitar entrada manual inconsistente.
Referência de conteúdo
Seção intitulada “Referência de conteúdo”Use Referência de conteúdo para conectar um item a outro, por exemplo vincular um artigo a um autor, uma categoria ou uma entrada relacionada.
Use quando o valor deve apontar para conteúdo gerenciado, em vez de guardar texto livre.
Arquivo
Seção intitulada “Arquivo”Use Arquivo para anexar arquivos enviados, como imagens, documentos, vídeos ou recursos para download.
Assim a mídia fica gerenciada à parte e, ao mesmo tempo, é fácil anexá-la às entradas.
Componente
Seção intitulada “Componente”Use Componente quando quiser reutilizar o mesmo grupo de campos em vários modelos de conteúdo.
Por exemplo, você pode usar um componente para campos de SEO, blocos de chamada para ação ou dados de contato compartilhados.
Dados remotos
Seção intitulada “Dados remotos”Use Dados remotos para trazer opções ou JSON de uma API externa.
Escolha esta opção quando os valores devem vir de uma fonte externa ao vivo, em vez de serem digitados manualmente. Consulte Dados remotos para a configuração.
JSON bruto
Seção intitulada “JSON bruto”Use JSON bruto para armazenar JSON arbitrário, como blocos de configuração, metadados estruturados ou objetos e arrays aninhados.
Quem edita informa os valores como JSON em uma área de texto. A API GraphQL expõe o campo como o escalar JSON. Prefira esta opção quando os dados são escritos no Contismo; use Dados remotos quando os valores devem ser buscados em uma API externa.
Guia rápido
Seção intitulada “Guia rápido”| Se você precisa armazenar | Use |
|---|---|
| Um valor curto de uma linha | Texto |
| Texto simples mais longo | Área de texto |
| Conteúdo formatado | Texto rico |
| Um valor verdadeiro ou falso | Booleano |
| Uma escolha em uma lista fixa | Opção de seleção |
| Um link para outro item gerenciado | Referência de conteúdo |
| Um arquivo ou uma imagem | Arquivo |
| Um grupo de campos reutilizável | Componente |
| Dados de uma API externa | Dados remotos |
| JSON estruturado arbitrário | JSON bruto |
Escolher o campo certo
Seção intitulada “Escolher o campo certo”Em geral, escolha o tipo de campo mais simples que sirva para o conteúdo que você precisa armazenar. Assim os modelos ficam mais fáceis de entender, mais fáceis de usar para quem edita e mais confiáveis quando o conteúdo é entregue pela API.