| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Présentation
Un widget est un élément permettant d'afficher une ou plusieurs informations.
L'affichage d'un widget se fait via une grille ( Voir la pageFOR-MERGE - 002.5 - SEF-8970 - Concept et paramétrage de Configurer la grille - Edition Édition JSON - Météo ).
Il existe plusieurs types de widgets :
- Widget titre (Voir la pageFOR-MERGE - 002.5 - SEF-8970 - Widget Titre - Edition Édition JSON - Météo ) ;
- Widget séparateur ( Voir la page FOR-MERGE - 002.5 - SEF-8970 - Widget Séparateur - Edition Édition JSON - Météo ) ;
- Widget météo ( Voir la page FOR-MERGE - 002.5 - SEF-8970 - Widget Météo - Détail Édition JSON - Météo ) ;
Description
Ajout d'un nouveau widget
Dans le format, JSON, le rajout d'un nouveau widget se fait au niveau de la partie "grid_elements".
| Code Block | ||||
|---|---|---|---|---|
| ||||
...
"grid_elements": [
{
DEFINITION DU WIDGET 1
},
{
DEFINITION DU WIDGET 2
},
...
]
... |
Définition d'un Widget
Paramètres des widgets
Les widgets vont être définis à l'aide de paramètres composés d'une clé et d'une valeur.
| Code Block | ||||
|---|---|---|---|---|
| ||||
...
{
"position_x": 0,
"position_y": 3,
...
}
},
... |
Un paramètre peut être non défini, mais avoir une valeur :
- Si le paramètre n'est pas présent dans le JSON ou s'il existe, mais que sa valeur est égale à "default", la météo va le considérer comme ayant une valeur non définie et va calculer sa valeur par défaut ( voir le chapitre Calcul de la valeur par défaut suivant ).
| Anchor | ||||
|---|---|---|---|---|
|
Calcul de la valeur d'un paramètre en cascade
La valeur d'un paramètre peut être définie à 3 niveaux différents :
- Dans le widget ( servira uniquement pour ce widget ) ;
- Dans le niveau "layout" d'une grille ( servira de valeur par défaut pour ce paramètre dans cette grille ) ;
- Dans les"fichiers de configurations" de la météo ( servira de valeur par défaut pour ce paramètre dans toutes les météos ) ;
La valeur d'un paramètre sera déterminée en parcourant les 3 niveaux dans l'ordre jusqu'à ce qu'il trouve une valeur définie :
- le niveau "widget",
- le niveau "layout" de la grille,
- le niveau "fichier de configuration ".
| Info |
|---|
Remarque :
|
Définition des valeurs par défauts d'une météo
Les valeurs par défaut pour une météo vont être définies dans le chapitre "layouts".
Ce sera mentionné dans la page spécifique à chaque widget.
Exemple :
Il y a un chapitre spécifique pour chaque type de widget :
| Code Block |
|---|
...
"layouts" : {
"title_widget_layout": {
...
},
"separator_widget_layout": {
...
},
"weather_widget_layout" : {
...
},
},
... |
Le contenu de ces 3 chapitres est décrit dans les pages de chaque widget.
Voir les pages d’édition :
du widget titre( voir la page
FOR-MERGE - 002.5 - SEF-8970 - Widget Titre - Edition - Météo )Exemple
Dans cet exemple :
- La couleur du texte du titre sera "blue", car même si elle est définie à "black" dans le niveau "layout", puisqu'elle est définie dans l'objet, la valeur définie dans le "layout" sera ignorée.
- La hauteur sera 2, parce qu'elle est définie uniquement dans le niveau "layout" ( non définie dans le widget ).
- La largeur sera celle définie dans le fichier de configuration .