| 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 pageConcept et paramétrage de Configurer la grille - Edition Édition JSON - Météo ).
Il existe plusieurs types de widgets :
- Widget titre ( Voir la page Widget Titre - Edition Édition JSON - Météo ) ;
- Widget séparateur ( Voir la page Widget Séparateur - Edition Édition JSON - Météo ) ;
- Widget météo ( Voir la page Widget Séparateur Météo - Edition Édition JSON - Météo ) ;
Description
Ajout d'un nouveau widget
Dans le format, JSON, Le 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ésenteprésent dans le JSON ou si elle 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 ).Dans la définition des widgets, choisir si vous préférez supprimer un paramètre pour qu'il soit à la valeur par défaut, ou explicitement écrire "default" dépendra uniquement de ce que vous trouvez le plus confortable :
- Ne pas garder un champ réduira la longueur du JSON ; Mettre les champs à "default" vous permettra de ne pas chercher le nom d'un paramètre, si vous voulez lui mettre une valeur ;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 ( ce qui servira uniquement pour ce widget uniquement ) ;
- Dans le niveau "layout" d'une grille ( ce qui servira de valeur par défaut de pour ce paramètre pour dans cette météogrille ) ;
- Dans les"fichiers de configurations" de la météo ( ces valeurs serviront alors servira de valeur par défaut de 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".
Il ne faut définir que les
|
Ce sera mentionné dans la page spécifique à chaque widget.
Exemple :
- Ce sera mentionné dans la page spécifique à chaque widget.
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écris dans les pages de chaque widget.
Voir les pages d’édition :
du widget titre( voir la page
Widget Séparateur - Edition - Météo )Exemple
| Code Block |
|---|
...
"grids": [
{
"nb_tiles_in_width": "default",
"type": "grid",
"grid_elements": [
{
"position_x": 0,
"position_y": 0,
"content": {
"type": "title_widget",
"title": "DATACENTER",
"text_color": "blue"
}
}
],
"layouts": {
"title_widget_layout": {
"height": 2,
"content": {
"text_color": "black"
}
}
}
}
],
... |
Dans cet exemple: