Champ

Un champ (field) est le composant d’interface affiché dans Content Editor, le formulaire d’édition de Jahia, qui permet à un contributeur de renseigner une propriété d’un contenu. Chaque champ correspond à une propriété (contenu) déclarée dans le modèle. C’est le point de contact entre l’équipe éditoriale et le modèle de contenu conçu par les développeurs.

Définition et fonctionnement

La qualité de la saisie se voit directement dans celle des contenus publiés. Un libellé clair, une aide qui explique l’usage attendu et le bon contrôle de saisie (sélecteur de date, liste de choix, sélecteur de page ou d’image) évitent les erreurs bien plus sûrement qu’une consigne envoyée par email. Un contributeur n’a pas à connaître le nom technique d’une propriété pour la remplir correctement.

Côté technique, Content Editor génère le formulaire à partir de la définition de type de contenu, puis applique d’éventuelles surcharges. Ces réglages au format JSON, livrés dans un module (un paquet de code installé sur Jahia), fixent le libellé, l’aide, l’ordre, le type de sélecteur, le caractère obligatoire ou la lecture seule. La documentation Academy précise qu’une surcharge ne peut pas créer un élément de saisie qui n’existe pas dans la définition. Un fieldset en regroupe plusieurs sous un même intitulé.

Documentation Academy : comment Content Editor génère ses formulaires

Le champ et la propriété : les différences

Le champ est ce que l’on voit, la propriété est ce qui est enregistré. Confondre les deux conduit à modifier le modèle de contenu quand il suffisait d’améliorer le formulaire, ou l’inverse.

Ce qui distingue un champ de ses voisins
Notion	Différence
Propriété (contenu)	La propriété est l’attribut stocké sur le contenu. Le champ est le contrôle qui permet d’en modifier la valeur.
Fieldset	Le fieldset en rassemble plusieurs sous un même intitulé. Il correspond à un mixin, un ensemble de propriétés réutilisable d’un type de contenu à l’autre.
Content Editor	Content Editor est le formulaire complet d’édition des contenus, pages, dossiers et médias. Il est composé de ces éléments de saisie.

Le champ en pratique

Un bloc d’appel à l’action pointe vers une page du site. Si le champ est une simple zone de texte, les contributeurs collent des adresses qui cassent dès qu’une page est déplacée. Si le champ est un sélecteur de page relié à une propriété de type référence, le contributeur choisit la page dans l’arborescence. Le lien désigne alors la page elle-même, pas une adresse recopiée.

Le même raisonnement vaut pour les dates, les listes fermées ou les images. Le choix du contrôle de saisie est une décision éditoriale autant que technique.

Questions fréquentes

Peut-on renommer un champ ou réécrire son aide sans toucher au modèle de contenu ?

Oui. Le libellé et l’aide affichés relèvent du formulaire, pas de la propriété. Ils peuvent être traduits et ajustés, notamment par une surcharge du formulaire livrée dans un module, sans changer le nom technique de la propriété. Les contenus existants ne sont pas touchés. C’est un moyen rapide d’améliorer la qualité de saisie.

Peut-on ajouter un champ au formulaire sans modifier la définition du type de contenu ?

Non. La documentation Academy indique qu’une surcharge de formulaire ne peut pas créer un élément de saisie qui n’est pas déclaré dans la définition du type. Ajouter une information à saisir revient donc à ajouter une propriété au modèle, puis à déployer le module qui porte cette définition. C’est une évolution à confier aux développeurs.