# Ajouter des champs à un type

Un champ de contenu porte une donnée de vos contenus, comme un prix, une surface ou une date de clôture. Cet article vous apprend à créer un champ, à le rattacher à un type, à le remplir dans l’éditeur et à repérer ce qui manque.

## Avant de commencer

- Vous devez être administrateur du site pour créer un champ et le rattacher à un type. Vos rédacteurs le remplissent ensuite dans l’éditeur.
- Un champ de contenu porte une donnée du contenu lui-même, comme la surface d’un bien ou la date de clôture d’une offre. Pour relier un contenu à un autre, comme un bien à sa ville, utilisez un champ de référence : [Relier vos contenus entre eux](https://lovelyrender.com/fr/documentation/references/).
- Un champ se définit une fois et se rattache à autant de types que vous voulez.

|  | La définition | L’usage par un type |
| --- | --- | --- |
| Où | Le tableau **Champs de contenu** de l’écran **Types de contenu** | La section **Champs de contenu** du formulaire du type |
| Réglages | Le libellé, le type de donnée, les contraintes et les choix | Obligatoire ou non, le libellé et l’aide propres au type, le groupe, la condition d’affichage, le filtre et le tri |

Un même champ « Surface » peut ainsi être obligatoire sur les biens à vendre et facultatif sur les biens à louer. Changer son libellé général le change sur les deux types.

## Créer un champ

1. Dans le menu de l’administration, ouvrez **Types de contenu**.
2. À côté du tableau **Champs de contenu**, cliquez sur **Ajouter un champ de contenu**. Le formulaire s’ouvre dans un panneau sur le côté.
3. Dans **Libellé**, saisissez le nom du champ tel que vos rédacteurs le liront, par exemple `Surface habitable`.
4. Dans **Type**, choisissez la nature de la donnée, par exemple **Nombre**. Les sections **Contraintes** ou **Choix** apparaissent selon le type.
5. Facultatif : réglez les contraintes. Pour une surface, saisissez `8` dans **Minimum** et `5000` dans **Maximum**.
6. Facultatif : dans **Texte d’aide**, écrivez une phrase affichée sous le champ dans l’éditeur, par exemple `En mètres carrés.`
7. Cliquez sur **Enregistrer**. Le champ apparaît dans le tableau, avec **0 usage** dans la colonne **Utilisé par**.

Le formulaire ne demande pas de clé technique. Lovely Render la tire du libellé à la création.

**Attention :** La clé et le type ne changent plus après la création. Si vous vous êtes trompé de type, créez le bon champ et supprimez l’ancien.

## Les types de champ

| Type | Saisie du rédacteur | Contraintes |
| --- | --- | --- |
| **Texte** | Une ligne de texte. | **Longueur minimale**, **Longueur maximale** et **Motif** |
| **Texte long** | Un texte sur plusieurs lignes. | **Longueur minimale** et **Longueur maximale** |
| **Nombre entier** | Un nombre sans décimale. | **Minimum**, **Maximum** et **Pas** |
| **Nombre** | Un nombre décimal. La virgule et les espaces des milliers sont acceptés. | **Minimum**, **Maximum** et **Pas** |
| **Nombre sur un curseur** | Un nombre réglé au curseur. | **Minimum** et **Maximum**, obligatoires, puis **Pas** |
| **Oui / non** | Un interrupteur. | Aucune |
| **Date** | Une date, au sélecteur ou au clavier. | Aucune |
| **Date et heure** | Une date avec l’heure. | Aucune |
| **Heure** | Une heure. | Aucune |
| **E-mail** | Une adresse e-mail. | **Longueur minimale** et **Longueur maximale** |
| **Adresse** | Une adresse Web. | **Longueur minimale** et **Longueur maximale** |
| **Téléphone** | Un numéro de téléphone. | **Longueur minimale**, **Longueur maximale** et **Motif** |
| **Choix** | Une valeur dans une liste. | La liste des choix |
| **Média** | Une image ou une vidéo de la médiathèque ou de Pexels. | Aucune |

Le **Motif** est une expression régulière que la valeur doit suivre, par exemple `^0[1-9]` pour un numéro qui commence par 0.

### Comprendre les contraintes

Une contrainte affiche un avertissement et ne bloque jamais l’enregistrement. Un nombre hors des bornes est ramené dans les bornes quand le rédacteur quitte le champ. Une valeur arrivée par un import passe telle quelle et reste signalée.

Si vous resserrez une borne plus tard, les contenus qui la dépassent restent enregistrables. Ils affichent un avertissement à corriger quand vous le voulez.

## Écrire les choix d’une liste

Un champ **Choix** prend ses valeurs d’une liste. La liste **Les choix sont** propose deux origines.

| Valeur de Les choix sont | Effet |
| --- | --- |
| **Écrits ci-dessous** | Vous écrivez chaque choix avec **Ajouter un choix**. Un choix a une **Valeur enregistrée** et un **Libellé**. La valeur ne change jamais. Le libellé est le texte que lit le rédacteur et il se traduit. |
| **Design system :** suivi d’une famille | Les choix sont les couleurs, dégradés, ombres, ombres de texte, filtres, tracés de découpe, arrondis, tailles de texte ou espacements de votre design system. |
| **La bibliothèque d’icônes** | Les choix sont les icônes de la bibliothèque. |

Une liste du design system ou des icônes se lit à l’ouverture de l’éditeur : elle suit vos changements de palette. Une couleur encore choisie dans un champ ne peut pas être supprimée du design system.

Au-delà de dix choix, le champ devient une liste où le rédacteur tape pour filtrer.

## Rattacher un champ à un type

Un champ ne s’affiche dans l’éditeur d’un type que si ce type le rattache.

1. Dans **Types de contenu**, cliquez sur **Modifier** sur la ligne du type.
2. Dans la section **Champs de contenu** du formulaire, cliquez sur **Ajouter un champ**.
3. Dans **Champ**, choisissez le champ. La liste donne son libellé et sa clé.
4. Réglez son usage par ce type. Le tableau qui suit décrit chaque réglage.
5. Cliquez sur **Enregistrer**. Le nom du type apparaît dans la colonne **Utilisé par** du champ.

| Réglage | Effet | Valeur par défaut |
| --- | --- | --- |
| **Obligatoire** | Le champ compte dans les données manquantes. Il n’empêche jamais de publier. | Décoché. |
| **Filtrable** | Le champ peut devenir un filtre d’une liste de contenus. | Décoché. |
| **Triable** | Vos visiteurs peuvent trier une liste sur ce champ. | Décoché. |
| **Libellé sur ce type** | Remplace le libellé général pour ce type, par exemple « Surface du terrain ». | **Hérité**, le libellé général. |
| **Aide sur ce type** | Remplace le texte d’aide pour ce type. | **Hérité**, le texte d’aide général. |
| **Affiché si** | Fait dépendre l’affichage du champ d’un autre champ. La section Afficher un champ sous condition la détaille. | **Toujours visible**. |

L’ordre des lignes est l’ordre des champs dans l’éditeur. Les flèches **Monter** et **Descendre** d’une ligne la déplacent. La croix la retire.

Si aucun champ n’existe encore, la section le dit. Créez d’abord le champ dans le tableau **Champs de contenu**, puis revenez le rattacher.

## Ranger les champs en groupes

Un groupe rassemble des champs dans un panneau repliable de l’éditeur, par exemple « Caractéristiques ».

1. Dans la section **Champs de contenu** du formulaire du type, cliquez sur **Ajouter un groupe de champs**.
2. Dans **Groupe**, saisissez son nom.
3. Facultatif : cochez **Ouvert par défaut** pour que le panneau s’ouvre déplié.
4. Dans le groupe, cliquez sur **Ajouter un champ** pour chaque champ qu’il porte.
5. Cliquez sur **Enregistrer**.

Les champs hors de tout groupe s’affichent avant les groupes. Les flèches d’un groupe le déplacent parmi les autres. **Retirer ce groupe** l’enlève avec ses lignes.

## Afficher un champ sous condition

Un champ peut ne s’afficher que selon la valeur d’un autre. Par exemple, « Salaire » ne s’affiche que si « Type de contrat » ne vaut pas « freelance ».

1. Sur la ligne du champ, dans **Affiché si**, choisissez le champ dont il dépend.
2. Choisissez la condition.
3. Saisissez la valeur attendue. Pour plusieurs valeurs, séparez-les par des virgules.

| Condition | Le champ s’affiche quand l’autre champ… |
| --- | --- |
| **vaut** | a exactement la valeur saisie. |
| **ne vaut pas** | a une autre valeur que celle saisie. |
| **est l’un de** | a l’une des valeurs saisies. |
| **n’est aucun de** | n’a aucune des valeurs saisies. |
| **n’est pas renseigné** | est vide. |
| **est renseigné** | a une valeur, zéro compris. |

Pour un champ **Choix**, saisissez la valeur enregistrée du choix, pas son libellé.

Un champ masqué est inactif : ni obligatoire, ni contrôlé, ni compté dans ce qui manque. Sa valeur reste enregistrée et revient quand la condition le montre de nouveau.

**Attention :** Une condition ne lit qu’un champ que le même type rattache. Une condition qui vise un autre champ est retirée à l’enregistrement.

## Remplir les champs dans l’éditeur

1. Ouvrez un contenu du type dans l’éditeur.
2. Dans la barre latérale de droite, ouvrez l’onglet du document, celui qui porte le nom du type.
3. Ouvrez l’onglet **Données**. Les champs sans groupe viennent en premier, puis les groupes.
4. Remplissez les champs, puis enregistrez le contenu.

![L’onglet Données · 1 d’une réalisation : la Surface du jardin à 180 avec son aide De 10 à 20000, le champ Livré le vide marqué Obligatoire, pas encore rempli, puis le groupe Chantier ouvert avec sa durée, l’arrosage automatique et le contrat d’entretien.](https://static.lovelyrender.com/uploads/2026/10/887-doc-contenus-donnees.png)

Un champ obligatoire porte une étoile après son libellé. Le titre de l’onglet compte les champs obligatoires encore vides : **Données · 1**. Le compteur baisse à mesure que vous remplissez.

Les valeurs s’enregistrent avec le contenu. Elles entrent dans ses révisions : restaurer une révision restaure les valeurs de ce moment.

| Situation | Comportement |
| --- | --- |
| Champ obligatoire vide | Le message **Obligatoire, pas encore rempli.** s’affiche sous le champ. La publication reste possible. |
| Nombre hors des bornes | La valeur est ramenée dans les bornes quand le rédacteur quitte le champ. Les messages **En dessous du minimum de…** ou **Au-dessus du maximum de…** l’expliquent. |
| Texte trop court ou trop long | Les messages **… caractères au minimum.** ou **… caractères au maximum.** s’affichent. |
| Texte hors du motif | Le message **Ne correspond pas au format attendu.** s’affiche. |
| Champ vidé | Il reste vide. Vide veut dire « pas renseigné ». |
| Valeur zéro ou Non | Elle compte comme renseignée. |
| Champ Média | **Choisir** ouvre la médiathèque, **Remplacer** change le média et **Retirer** l’enlève. **Chercher sur Pexels** importe une photo ou une vidéo de Pexels avec son crédit. |

Aucun message n’empêche d’enregistrer. Les onglets **Données** et **Références** n’apparaissent que sur un type qui a des champs ou des références. Le panneau d’une page ordinaire s’ouvre sur l’onglet **SEO**.

**Remarque :** Après une fermeture accidentelle de l’onglet ou une coupure, l’éditeur propose de restaurer la sauvegarde de votre navigateur, valeurs des champs comprises. Rien n’est restauré sans votre accord.

## Repérer les données manquantes

Trois endroits montrent les champs obligatoires encore vides.

| Endroit | Affichage |
| --- | --- |
| Le titre de l’onglet **Données** | Le nombre de champs obligatoires vides du contenu ouvert. |
| La liste des contenus | Sous le titre d’un contenu incomplet, le nombre de données manquantes. Le survoler nomme les champs. Le filtre **Données** > **Incomplet** ne garde que ces contenus. |
| L’écran de pré-publication | À la première publication d’un contenu, le panneau **Données** liste les champs vides. Vous pouvez publier quand même. |

L’écran de pré-publication n’apparaît pas sur un contenu déjà publié. [Lire la liste de vos contenus](https://lovelyrender.com/fr/documentation/liste-des-contenus/) détaille la liste et ses filtres.

## Supprimer un champ

1. Dans le tableau **Champs de contenu**, cliquez sur **Supprimer** sur la ligne du champ.
2. Lisez la fenêtre. Elle dit combien de types utilisent le champ et combien de contenus portent une valeur.
3. Cliquez sur **Supprimer** pour confirmer.

Le champ quitte tous les types et l’éditeur. Les valeurs déjà enregistrées restent dans la base de votre site. Les blocs qui affichaient le champ restent vides et la page s’affiche normalement.

Pour retirer un champ d’un seul type, retirez sa ligne dans le formulaire du type et gardez la définition.

## Voir aussi

- [Afficher les données d’un contenu](https://lovelyrender.com/fr/documentation/afficher-les-donnees/)
- [Lister et filtrer vos contenus](https://lovelyrender.com/fr/documentation/listes-de-contenus/)
- [Relier vos contenus entre eux](https://lovelyrender.com/fr/documentation/references/)
- [Réutiliser une structure d’un site à l’autre](https://lovelyrender.com/fr/documentation/reutiliser-une-structure/)