Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-htmlfalse
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtruescroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Présentation - Widget Séparateur

Concept

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 ( voir la page Widget Séparateur - Détail - 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

Code Block
languagebash
themejsRDark
titleExemple d'un widget séparateur
...    
"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éola page de configuration d'un widget ( voir la page Configurer un widget - Édition JSON - Météo ).

Code Block
languagebash
themeRDarkjs
titleConfiguration du positionnement
...    
"grid_elements": [
	{
		"position_x": 0,
        "position_y": 3,
        "width"     : "all",
        "height"    : 2,
        ...
	}
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
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 grillegrille ;
  • Doit obligatoirement être défini.
Code Blocknoformat
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 grillegrille ;
  • Doit obligatoirement être défini.
Code Blocknoformat
width
Nombre de cellules ---

Correspond à la largeur du widget :

  • un nombre, entre 1 et le nombre de cases en largeur de la grillegrille ;
  • "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 Configurer un widget - Édition JSON - 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".

Code Blocknoformat
height
Nombre de cellules ---

Correspond à la hauteur du widget :

  • un nombre, non limité, car la hauteur de la grille n'est pas limitépositif, limité à 1000 ;
  • "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 Configurer un widget - Édition JSON - Météo   ).

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

Code Block
languagebash
themejsRDark
titleConfiguration du contenu
...    
"grid_elements": [
	{
		...
    	"content" : {
        	"type" : "separator_widget",
        	"layout" : {
            	"information_to_display" : {
                	"left_area" : {
						...
                	},
                	"title_area" : {
						...
                	},
                	"right_area" : {
					 	...
                	}
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
type
String -

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

Code Blocknoformat
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é.

Code Blocknoformat
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.




Panel

Image Modified

La zone de gauche ( left_area )
Code Block
languagebash
themejsRDark
titleConfiguration du contenu
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
                	"left_area" : {
                    	"displayed" : true,
                    	"width_percent" : 10
                	},
					...
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
displayed
Booléen

true

Affichage ou non de la zone de gauche.

Code Blocknoformat
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 )
Code Block
languagebash
themejsRDark
titleConfiguration du contenu
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
					...
					"title_area" : {
    					"label" : "DATACENTER FRANCE",
    					"font_zoom_percent" : 100,
    					"text_color" : "000000",
					    "text_align" : "center"
					},      
					...
            	}
        	}
    	}
	}
]
...



NomTypeDéfautCommentaire
Code Blocknoformat
label
String -

Texte affiché dans le widget.

Doit obligatoirement être défini.


Info

Limité à 300 caractères.

Code Blocknoformat
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.
  • "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 Configurer un widget - Édition JSON - Météo   ).
Code Blocknoformat
text_color
Couleur Web

#000000

Couleur d'affichage du texte. 

Code Blocknoformat
text_align
String center

Alignement du texte.

Valeurs possibles :

  • center ( alignement centré ) ;
  • left ( alignement à gauche ) ;
  • right ( alignement à droite ) ;
  • "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 Configurer un widget - Édition JSON - Météo   ).
La zone de droite ( right_area )
Code Block
languagebash
themejsRDark
titleConfiguration du contenu
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
					...
                	"right_area" : {
                    	"displayed" : true,
                    	"width_percent" : 10
                	}
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
displayed
Booléen true

Affichage ou non de la zone de droite.

Code Blocknoformat
width_percent
Integer 10

Pourcentage du widget occupé par la zone de droite.

Doit être compris entre 0 et 100


Exemple

Code Block
languagebash
themejsRDark
titleExemple d'un widget séparateur
...    
"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
    	            }
    	        }
    	    }
    	}
	}
]
...
Panel

AnchorSeparateurDefinirValeurLayoutSeparateurDefinirValeurLayout

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".
Code Block
languagejs
titleExemple d'un widget séparateur
...     "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 } } } } }, ... } ...