Définition du format numérique d’un champ modifiable

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture
  • Découvrez comment créer un champ modifiable par l’utilisateur qui conserve un format spécifié.

    Si un administrateur souhaite afficher un champ numérique à un utilisateur final dans un certain format, mais également permettre aux utilisateurs de modifier ce champ, une solution consiste à définir le type d’affichage du champ comme un nombre formaté.

    Écran du champ de numéro

    Actuellement, la seule façon d’utiliser le formatage numérique sur les champs modifiables est de définir le type d’affichage de ce composant dans le CSV de mise en page lui-même. Une fois exporté et ouvert avec votre éditeur CSV préféré (excel dans cet exemple), vous pouvez ajouter ce qui suit à la ligne de votre champ :
    • FormattedNumber dans la colonne F (type d’affichage du composant)
    • format : {...} vers la colonne I (valeur)

    CSV de mise en page

    Une fois celui-ci enregistré, vous pouvez faire glisser ce CSV de mise en page dans la fenêtre de l’éditeur de mise en page, et il remplacera la mise en page actuelle. Vous pouvez vérifier que ce changement a été effectué à partir de l’onglet Modifier les informations de champ de l’éditeur de mise en page, où le type d’affichage est vide :

    CSV de mise en page

    Et dans l’onglet Organiser la mise en page, où les propriétés de champ de votre champ de numéro auront votre format saisi dans la section Valeur brute :

    CSV de mise en page

    CSV de mise en page

    Après l’enregistrement et le déploiement du plan, vous devriez obtenir un résultat similaire à la capture d’écran en haut de cette page. D’autres options de formatage sont répertoriées ci-dessous :

    {
    	"format": {
    		"type": "currency" | "percent" | "unit" | "decimal",
    		"precision": 2, // Any positive integer
    		"unit": Unit, // List of standard JS units, i18n supported
    		"customUnit": string, // Any unit to append to the end of the value, untranslated
    		"displayZeroPriceAs": string,
    		"displayNullPriceAs": string
    	}
    }

    Le formatage en pourcentage est automatiquement multiplié par 100. Ainsi, une valeur de champ de 0,1 s’affichera comme suit : 10 %.

    Vous pouvez afficher uniquement un signe de pourcentage sans mathématiques en utilisant le type : unité, unité : pourcentage.

    Pour afficher la liste des unités prises en charge, consultez ECMAScript® 2026 Internationalization API Specification.

    Vous pouvez utiliser customUnit pour les unités ne figurant pas dans cette liste.