Qu'est ce que le format JSON

Le format JSON est un format qui permet de stocker des données de façon organisées et lisible par un humain. Plusieurs règles s'appliquent à ce format :

  • Il ne peut y avoir qu'un élément racine, c'est-à-dire un élément qui va contenir toutes les données,
  • Les données peuvent être organisées soit dans un objet soit dans un tableau,
  • Un objet commence par "{" et finie par "}",
  • Un tableau commence par "[" et termine par "]",
  • Les propriétés sont formées d'un couple clé/valeurs que l'on affiche sous forme ( "clé" : "valeurs" ),
  • Le séparateur de chaque propriété est la virgule. Les propriétés qui sont définies en dernier d'un objet ou d'une liste ne DOIVENT PAS se terminer avec une virgule,
  • L'imbrication de  deux mêmes types de blocs est possible par exemple : un objet dans un objet ou un tableau dans un tableau.

Valeurs possibles :

  • Les propriétés : un nombre ( 1, 2, ... ) , un booléen ( true, false ) , une chaine de caractères ( "default", "mon nom de widget" ),
  • Les tableaux ( [ ... ] ),
  • Les objets ( { ... } ).

Affichage de configuration de la formulaire

Dans le formulaire de configuration de la météo des services, la colorisation syntaxique est la suivante :

  • Le nom des propriétés est affiché en : bleu
  • Les valeurs apparaissent :
    • en blanc quand l'utilisateur a édité une valeur
    • en violet quand c'est la valeur par défaut 


Indentation

Le format JSON étant un format où les propriétés sont imbriquées les unes par rapport aux autres, cela se matérialise en JSON par une indentation entre les blocs, cette indentation est visualisée à l'aide de trait vertical dans le formulaire de configuration.

Cela permet aux utilisateurs de mieux visualiser la fin de chaque indentation.


Actions possibles dans la zone d'édition

Comportement du copier/coller


Vous pouvez dans le formulaire effectuer des copier-coller à l'aide de la souris ou en passant par les raccourcis clavier CTRL+ C et CTRL+ V.

Si vous souhaitez copier toute la configuration sans passer par le bouton de copie du formulaire , nous vous conseillons de faire les raccourcis clavier suivant : CTRL+ A puis CTRL+ C


Si vous souhaitez coller une configuration (éditée depuis un éditeur externe par exemple), le texte apparaitra sans la coloration syntaxique et sans indentation. Pour retrouver un affichage correct, nous vous invitons à cliquer le bouton  


Barre de défilement


Les barres de défilement verticales et horizontales sont en permanence affichées afin de permettre à l'utilisateur de pouvoir continuer de configurer même si la configuration prend plus de place sur la largeur ou la hauteur. 


Affichages des problèmes de configuration

Colorisations syntaxique

Une clé ou une valeur avec une couleur de fond rouge indique que la clé ou la valeur est en "problème". Pour connaitre la nature du problème, référez-vous à l'encadré rouge au dessus du formulaire d'édition.

Lorsqu'une clé est à un problème, c'est toute la partie concernant cette clé qui apparaitra en rouge.

Bulle d'information

Lorsque la clé ou valeur est en problème, une bulle d'information est affiché au survol de la zone pour indiquer quel est la nature du problème


Localiser les problèmes


Lorsqu'un problème est présent dans la configuration de la météo, vous pouvez facilement localiser la propriété en cliquant sur le texte JSON   , cela fera défilé le JSON jusqu'à l'endroit ou le problème se situe.