Présentation - Widget Séparateur

Le widget séparateur permet d'organiser les autres widgets dans la météo. Il peut par exemple être utilisé pour définir des sections ou des groupes de widget météo.

Plus d'informations sur les widgets séparateurs dans cette page : Widget Séparateur - Edition - Météo

Description

Pour le widget séparateur, il faut configurer :

  • Sa position dans la grille et sa taille.
  • Le texte à afficher 


Les options du widget séparateur

  • Sa partie gauche :
    • l'afficher ou la cacher,
    • la taille ( en pourcentage ) que prendra la zone affichée dans le widget.
  • Sa partie réservée au texte :
    • l'alignement du texte,
    • la couleur du texte,
    • le pourcentage du zoom de la taille de la police.
  • Sa partie droite :
    • l'afficher ou la cacher,
    • la taille ( en pourcentage ) que prendra la zone affichée dans le widget.

Configuration

...    
"grid_elements": [
	{
		"position_x": 0,
        "position_y": 3,
        "width"     : "all",
        "height"    : 2,
        "content"   : {
			"type" : "separator_widget",
		    "layout" : {
        		"information_to_display" : {
            		"left_area" : {
                		"displayed" : true,
                		"width_percent" : 10
            		},
            		"title_area" : {
                		"label" : "DATACENTER France",
                		"font_zoom_percent" : 100,
                		"text_color" : "#000000",
                		"text_align" : "center"
            		},
            		"right_area" : {
                		"displayed" : true,
                		"width_percent" : 10
            		}
        		}
    		}
         }   
	}
]
...

Positionnement et dimensionnement

Pour plus d'explication regarder la page Concept et paramétrage des widgets - Edition - Météo

...    
"grid_elements": [
	{
		"position_x": 0,
        "position_y": 3,
        "width"     : "all",
        "height"    : 2,
        ...
	}
]
...
NomTypeDéfautCommentaire
position_x
Numéro de cellule

---

Abscisse du point "le plus en haut à gauche" d'un widget :

  • un nombre => Correspond à la case numéro X dans la largeur de la grille;
  • Doit obligatoirement être défini.
position_y
Numéro de cellule ---

Ordonnée du point "le plus en haut à gauche" d'un widget :

  • un nombre => Correspond à la case numéro Y dans la hauteur de la grille;
  • Doit obligatoirement être défini.
width
Nombre de cellules ---

Correspond à la largeur du widget :

  • un nombre, entre 1 et le nombre de cases en largeur de la grille;
  • "all" => Pour prendre toute la largeur de la page :
    • Dans ce cas, sa "position_x" devra être 0.
  • "default" => la valeur sera calculée avec le système de "Calcul de la valeur en cascade" ( voir la page Concept et paramétrage des widgets - Edition - Météo   ).

Si le paramètre "width" n'est pas présent dans la configuration du widget, c'est comme s'il valait "default".

height
Nombre de cellules ---

Correspond à la hauteur du widget :

Si le paramètre "height" n'est pas présent dans la configuration du widget, c'est comme s'il valait "default".


Contenu du widget séparateur

...    
"grid_elements": [
	{
		...
    	"content" : {
        	"type" : "separator_widget",
        	"layout" : {
            	"information_to_display" : {
                	"left_area" : {
						...
                	},
                	"title_area" : {
						...
                	},
                	"right_area" : {
					 	...
                	}
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
type
String -

Type du widget, dans le cas du widget séparateur ce paramètre doit être obligatoirement défini à la valeur : separator_widget.

layout
Clé -

La clé layout permet de gérer la disposition et l'affichage du widget. Seul la clé information_to_display pour le widget de type separator_widget peut être renseigné.

information_to_display
Clé - La clé information_to_display doit être renseigné dans la clé layout. Elle permet de paramétrer l'affichage des différentes zones du widget. En l'occurrence : left_area, title_area et right_area.




La zone de gauche ( left_area )
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
                	"left_area" : {
                    	"displayed" : true,
                    	"width_percent" : 10
                	},
					...
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
displayed
Booléen

true

Affichage ou non de la zone de gauche.

width_percent
Integer 10

Pourcentage du widget occupé par la zone de gauche.

Doit être compris entre 0 et 100

La zone de titre ( title_area )
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
					...
					"title_area" : {
    					"label" : "DATACENTER FRANCE",
    					"font_zoom_percent" : 100,
    					"text_color" : "000000",
					    "text_align" : "center"
					},      
					...
            	}
        	}
    	}
	}
]
...



NomTypeDéfautCommentaire
label
String -

Texte affiché dans le widget.

Doit obligatoirement être défini.

font_zoom_percent
Integer 100

Zoom en pourcentage de la taille de la police.

Doit être supérieur à 0

Une valeur de 200 affiche un texte deux fois plus gros

Une valeur de 50 affiche un texte deux fois plus petit

text_color
Couleur Web

#000000

Couleur d'affichage du texte. 

text_align
String center

Alignement du texte
Valeurs possibles :

La zone de droite ( right_area )
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
					...
                	"right_area" : {
                    	"displayed" : true,
                    	"width_percent" : 10
                	}
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
displayed
Booléen true

Affichage ou non de la zone de droite.

width_percent
Integer 10

Pourcentage du widget occupé par la zone de droite.

Doit être compris entre 0 et 100


Exemple

...    
"grid_elements": [ 
	{
    	"position_x" : 0,
    	"position_y" : 2,
    	"width" : "all",
    	"height" : 2,
    	"content" : {
    	    "type" : "separator_widget",
    	    "layout" : {
    	        "information_to_display" : {
    	            "left_area" : {
    	                "displayed" : true,
    	                "width_percent" : 10
    	            },
    	            "title_area" : {
    	                "label" : "DATACENTER FRANCE",
    	                "font_zoom_percent" : 100,
    	                "text_color" : "#030303",
    	                "text_align" : "center"
    	            },
    	            "right_area" : {
    	                "displayed" : true,
    	                "width_percent" : 10
    	            }
    	        }
    	    }
    	}
	}
]
...

Définir les valeurs par défaut du widget "séparateur" dans une météo

Dans le chapitre "layouts" de la grille, il suffit de définir / compléter le chapitre "separator_widget_layout" :

  • il faut seulement définir les valeurs pour lesquels on souhaite mettre un paramètre par défaut;
  • certains paramètres ne peuvent pas avoir de valeur par défaut :
    • position_x,
    • position_y,
    • type,
    • label.
  • Si vous utilisez la valeur "default" pour un paramètre qui l'accepte, la valeur sera alors celle présente dans le fichier de configuration du module "webui-module-service-weather".
...    
"grid_elements": [
	...
],
"layouts" : {
	... 
	"separator_widget_layout" : {
	   	"width" : "default",
    	"height" : "default",
		"content" : {
	        "layout" : {
	            "information_to_display" : {
	                "left_area" : {
	                    "displayed" : true,
	                    "width_percent" : 10
	                },
	                "title_area" : {
	                    "font_zoom_percent" : 100,
	                    "text_color" : "#000000",
	                    "text_align" : "center"
	                },
	                "right_area" : {
	                    "displayed" : true,
	                    "width_percent" : 10
	                }
	            }
	        }
	    }
	
	},
 	... 
}
...