Tipos de campo de contenido
Los tipos de campo definen qué clase de dato almacena un campo y cómo interactúan con él quienes editan. Elegir el tipo de campo adecuado ayuda a mantener el contenido consistente, más fácil de administrar y más fácil de reutilizar en el proyecto.
Varios valores
Sección titulada «Varios valores»La mayoría de los tipos de campo pueden permitir varios valores. En la configuración del campo, define Permitir varios valores (o Tipo de selección para opciones, referencias, archivos y componentes) en Múltiple.
Cuando Múltiple está activado, también puedes definir:
- Cantidad mínima: la menor cantidad de elementos que deben indicar quienes editan
- Cantidad máxima: la mayor cantidad de elementos que pueden agregar
En el editor de contenido, los campos escalares (texto, número y similares) muestran un control Agregar … para que se pueda añadir otro valor. Los campos de opción, referencia, archivo y componente conservan sus interfaces de selección múltiple y de agregado.
Los campos de varios valores se exponen en la API GraphQL como listas (por ejemplo, [String] para un campo de texto múltiple).
Los campos de título deben seguir siendo campos de texto de un solo valor.
Usa Texto para valores cortos, como títulos, nombres, etiquetas y slugs.
Suele ser la mejor opción cuando el contenido debe caber en una sola línea y no necesita formato.
Área de texto
Sección titulada «Área de texto»Usa Área de texto para texto plano más largo, como resúmenes, notas, extractos o descripciones internas.
Elígela cuando quienes editan necesitan más espacio para escribir, pero el contenido no requiere formato enriquecido.
Texto enriquecido
Sección titulada «Texto enriquecido»Usa Texto enriquecido para contenido con formato, como el cuerpo de un artículo, secciones de una página y textos de marketing más largos.
Este tipo de campo está pensado para contenido que incluye estructura o estilo, como párrafos, encabezados, listas y enlaces.
Booleano
Sección titulada «Booleano»Usa Booleano para valores de verdadero o falso, por ejemplo si algo está destacado, activado o visible.
Sirve para interruptores y marcas simples.
Opción de selección
Sección titulada «Opción de selección»Usa Opción de selección cuando quien edita debe elegir entre una lista fija de valores.
Esto ayuda a estandarizar el contenido y a evitar entradas manuales inconsistentes.
Referencia de contenido
Sección titulada «Referencia de contenido»Usa Referencia de contenido para conectar un elemento con otro, por ejemplo vincular un artículo con un autor, una categoría o una entrada relacionada.
Úsala cuando el valor deba apuntar a contenido administrado, en lugar de guardar texto libre.
Archivo
Sección titulada «Archivo»Usa Archivo para adjuntar archivos subidos, como imágenes, documentos, videos o recursos descargables.
Así los medios se administran por separado y, al mismo tiempo, es fácil adjuntarlos a las entradas.
Componente
Sección titulada «Componente»Usa Componente cuando quieras reutilizar el mismo grupo de campos en varios modelos de contenido.
Por ejemplo, puedes usar un componente para campos de SEO, bloques de llamado a la acción o datos de contacto compartidos.
Datos remotos
Sección titulada «Datos remotos»Usa Datos remotos para traer opciones o JSON de una API externa.
Elígelo cuando los valores deban venir de una fuente externa en vivo, en lugar de escribirse a mano. Consulta Datos remotos para la configuración.
JSON sin formato
Sección titulada «JSON sin formato»Usa JSON sin formato para guardar JSON arbitrario, como bloques de configuración, metadatos estructurados u objetos y arreglos anidados.
Quienes editan ingresan los valores como JSON en un área de texto. La API GraphQL expone el campo como el escalar JSON. Prefiere esta opción cuando los datos se escriben en Contismo; usa Datos remotos cuando los valores deban obtenerse de una API externa.
Guía rápida
Sección titulada «Guía rápida»| Si necesitas guardar | Usa |
|---|---|
| Un valor corto de una sola línea | Texto |
| Texto plano más largo | Área de texto |
| Contenido con formato | Texto enriquecido |
| Un valor de verdadero o falso | Booleano |
| Una elección de una lista fija | Opción de selección |
| Un enlace a otro elemento administrado | Referencia de contenido |
| Un archivo o una imagen | Archivo |
| Un grupo de campos reutilizable | Componente |
| Datos de una API externa | Datos remotos |
| JSON estructurado arbitrario | JSON sin formato |
Elegir el campo adecuado
Sección titulada «Elegir el campo adecuado»En general, elige el tipo de campo más simple que se ajuste al contenido que necesitas guardar. Así los modelos son más fáciles de entender, más fáciles de usar para quienes editan y más confiables cuando el contenido se entrega a través de la API.