SP:Composant:StyleProperties
De Hegyd Doc.
Version du 28 juin 2010 à 15:30 par Sebd (discuter | contributions)
Sommaire |
Composant: StyleProperties
Ce composant gère toute la partie qui permet a l'utilisateur de personnaliser l'apparence de son site:
- modification de l'apparence des Blocs
- modification de l'apparence des BlocObjects
- application d'un thème
- application d'une palette de couleur
Fonctionnement général
shéma général
Configuration
Tous les styles éditables par l'utilisateurs sont définis dans la configuration (les accordéons défini sur la page mise en page et styles de l'éditeur).
Le fichier principal de configuration se trouve dans conf/styleProperties.php.
Ce fichier permet:
- de définir les conteneurs: un conteneur représente un élément de style a configurer: un titre, un paragraphe, ou meme un bloc entier: le footer, le menu...
définition des conteneurs
Structure
Un conteneur représente un élément de style a configurer: un titre, un paragraphe, ou meme un bloc entier: le footer, le menu... Il est représenté par un tableau php :
'paragraphe' => array(
'blocId'=>array(Bloc::TYPE_CONTENT,Bloc::TYPE_LEFT_MENU,Bloc::TYPE_RIGHT_MENU), //bloc de contenu dans lequel il sera éditable
'blocObjectId'=>BlocObject::TYPE_TEXT, //[[SP:Composant:BlocObject|blocObject]] associé
'type'=>StyleProperties::TYPE_FONT, //type d'élément: TYPE_FONT: styles sur élément intra page (paragraphe, formulaire,liens...). TYPE_MEP: element constituant la page: header,menus,contenu ou footer
'label'=>'Paragraphe', //nom qui sera affiché dans l'accordéon
'targetElements' => array('.p'), //chemin css associé a l'élément. ce chemin doit être relatif et uniquement se reduire a sa version minimale. Il sera préfixé de facon automatique selon que le bloc soit dans le menu, le contenu ou encore le footer
'associatedContainer'=>array('defaultContainer','background','withBackgroundContainer') //un conteneur peut utiliser les propriétés d'autres conteneurs. Seules leurs propriétés sont reprises
'isAbstract' => false //un conteneur peut être abstrait, cad ne représenter aucun élément, et être seulement repris par d'autres conteneurs pour ses propriétés. Ce système permet de factoriser les blocs de propriétés qui changent peu d'un élément à un autre
),
Héritage de conteneur
IL y a deux type de conteneurs:
- conteneurs effectifs = un element de page: paragraphe, titre, header, footer, menu...
- conteneurs abstraits = ne représntent rien, mais sont utilisé par les conteneurs effectifs pour leur ensemble de propriétés. Permet de rassembler ainsi toutes les propriétés communes à certains blocs à un seul endroit.
Les conteneur effectifs peuvent hériter de 0..n conteneur abstraits. Seul leur priopriétés sont héritées, les onfirmation sur le conteneur lui meme ne le sont pas.
