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-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Présentation - Widget Titre

Comme son nom l'indique, le widget titre permet d'attribuer un titre à la page :

Pour plus d'informations sur l'affichage des widgets "titre", ( voir la page : Widget Titre - Détail - Météo )

Description

Pour le widget "titre", il  faut  configurer :

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


Les  options  du widget "titre" :

  • Sa partie réservée au texte :
    • la couleur du texte,
    • l'alignement du texte,
    • le pourcentage du zoom de la taille de la police.

Configuration

Code Block
languagebash
themeRDarkjs
titleExemple d'un widget titre
...    
"grid_elements": [ 
	{
  		"position_x" : 0,
    	"position_y" : 0,
    	"width" : "all",
    	"height" : 2,
    	"content" : {
        	"type" : "title_widget",
        	"layout" : {
            	"information_to_display" : {
            	    "title_area" : {
                    	"label" : "DATACENTER",
                    	"text_color" : "#000000",
						"text_align" : "left",
                           	   "font_zoom_percent" : 100
                	}
            	}
        	}
    	}
	}
 ]
...

Positionnement et dimensionnement

Pour plus d'explication explications, regarder la page   Concept et paramétrage de de configuration de la grille ( voir la page Configurer la grille - Edition Édition JSON - Météo)

Code Block
languagebash
themejsRDark
...    
"grid_elements": [
    {
        "position_x": 0,
        "position_y": 3,
        "width"     : "all",
        "height"    : "1",
        ...
     }
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
position_x
Numéro de cellule

---

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

  • un nombreCorrespond à la case numéro X dans la largeur de la grille ;
  • 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 grille ;
  • 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 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 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éepositif, 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 titre 

Code Block
languagebash
themejsRDark
...    
"grid_elements": [
    {
		... 
		"content" : {
		    "type" : "title_widget",
    		"layout" : {
    	    	"information_to_display" : {
    	    	    "title_area" : {
						...
    	    	    }
    	    	}
	    	}
		}     
	}
]
...
NomTypeDéfautCommentaire
Code Blocknoformat
type
String -

Type du widget, dans le cas du widget titre ce paramètre doit être obligatoirement défini à la valeur : title _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 title _widget peut être renseigné.

Code Blocknoformat
information_to_display
Clé - La clé information_to_display doit être renseigné renseignée dans la clé layout. Elle permet de paramétrer l'affichage des différentes zones du widget. En l'occurrence ( le widget titre n'a qu'une zone ) : title_area.




Panel

Image Added

La zone de titre
Code Block
languagebash
themeRDarkjs
titleConfiguration du contenu
...    
"grid_elements": [
	{
		...
    	"content" : {
         	...
        	"layout" : {
            	"information_to_display" : {
                	"title_area" : {
                    	"label" : "DATACENTER",
                    	"text_color" : "#000000",
						"text_align" : "left",
						"font_zoom_percent" : 100
                	}
            	}
        	}
    	}
	}
]
...
NomTypeDéfautCommentaire
code
No Format
label
String -

Texte affiché dans le widget.

code

Info

Limité à 300 caractères.

No Format
text_
align
color
String
Couleur Web
center
#000000

Couleur d'affichage

Alignement

du texte.


Valeurs possibles :
  • center ( alignement au centre );
  • left ( alignement à gauche );
  • right ( alignement à droite );
  • "default" =>

     

    • Le format de la valeur est une couleur web ( sous le format hexadécimal, en anglais ou rgb ) ( Voir :    https://en.wikipedia.org/wiki/Web_colors )
    • "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  
     
    • ).
    code
    No Format
    text_align
    String
    center
    left

    Alignement du texte.
    Valeurs possibles :

    center
    • left ( alignement
    au centre
    • à gauche );
    left
    • center ( alignement
    à gauche
    • au centre );
    • 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
      
    • ).
    code
    No Format
    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
      
    • ).

    Exemple

    Code Block
    languagebash
    themeRDarkjs
    titleExemple d'un widget titre
    ...    
    "grid_elements": [ 
    	{
        	"position_x" : 0,
        	"position_y" : 0,
        	"width" : "all",
        	"height" : 2,
        	"content" : {
        	    "type" : "title_widget",
        	    "layout" : {
        	        "information_to_display" : {
        	            "title_area" : {
        	                "label" : "DATACENTER",
        	                "text_color" : "#000000",
        	                "font_zoom_percent" : 100
        	            }
        	        }
        	    }
        	}
    	}
     ]
    ...
    Panel

    Image Removed

    AnchorMeteoDefinirValeurParDefautWidgetTitreMeteoDefinirValeurParDefautWidgetTitre

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

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

    • Il ne faut définir que les valeurs pour lesquelles 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" : {
    	...  
    	"title_widget_layout" : {
        	"width" : "default",
        	"height" : "default",
        	"content" : {
            	"layout" : {
            	    "information_to_display" : {
            	        "title_area" : {
            	            "text_colortext_align" : "#000000left",
                 	                   "font_zoom_percent" : "default"100
        	    	        }
        	    	    }
        	    	}
        	}
    	} 
    	... ]
    }
    ...
    Panel

    Image Added