Manual:$wgResourceModuleSkinStyles/fr

La variable globale $wgResourceModuleSkinStyles permet aux habillages de fournir des feuilles de style supplémentaires pour personnaliser les modules ResourceLoader existants. Les habillages peuvent la modifier en éditant la clé  dans skin.json. Les extensions peuvent adapter les styles de leur module avec les habillages, en initialisant la clé  avec les définitions de leur module ResourceLoader.

Ces deux éléments facilitent (ou rend possible) le remplacement des styles par défaut et réduit l'empreinte du style d'un habillage en ne chargeant pas les styles non utilisés sur la plupart des pages. Par exemple, si un habillage a beaucoup de code CSS pour remplacer la présentation de la page Special:UserLogin, il peut le mettre dans un fichier CSS ou LESS séparé qui remplace 'mediawiki.special.userlogin.login.styles' et ResourceLoader ne chargera ce CSS d'habillage que lorsqu'une page aura besoin de ce module.

$wgResourceModuleSkinStyles est un tableau multidimensionnel. Au premier niveau, on trouve le nom du paquet (habillage ou extension) qui ajoute des styles complémentaires (dans l'exemple suivant appelé « foo »). Au second niveau on trouve les paires clé et valeur :


 * Les clés sont toujours les noms de modules, pour lesquels les styles supplémentaires doivent être utilisés. Par défaut votre définition va ensuite remplacer le fichier CSS/LESS, qui avait déjà défini les styles pour ce module auparavent. If the module name in contrast is prepended by a "+" sign, then your styles will be added to those styles, which had already been defined before, thus not replacing complete files, but preserving all styles and only overwriting/adding those, which you are defining.
 * La valeur est le chemin relatif vers le fichier correspondant. Plusieurs fichiers peuvent être ajoutés à un module en les inscrivant dans un tableau.

Vector est un des habillages qui utilise cette méthode et fournit une bonne démonstration d'utilisation pratique. Vous trouverez la définition sous la clé.

Voir la documentation de pour les informations de base à propos de la définition et de l'utilisation des modules ResourceLoader.

Documentation
La clé  à l'intérieur de skin.json peut être utilisée pour modifier les styles des modules ResourceLoader connus qui ont été définis dans la clé   des autres extensions.

Les styles définis utilisant $wgResourceModuleSkinStyles seront ajoutés ultérieurement à la liste  des modules existants. La liste  ne peut pas être modifiée ni désactivée.

Par exemple, si ceci est la définition du module ResourceLoader bar :

Ensuite voilà comment l'habillage Foo lui fournirait des styles supplémentaires :

Cela équivaut le plus souvent à :

Si le module définit déjà sa propre entrée dans  pour un habillage donné, alors $wgResourceModuleSkinStyles est ignoré.

Si un module définit, l'habillage peut vouloir l'étendre plutôt que de le remplacer. Cela peut être fait en utilisant le préfixe.

Exemple :

Cela équivaut le plus souvent à :

En d'autres termes, si vous êtes l'auteur du module, utilisez la liste  pour les feuilles de style qui ne peuvent pas être désactivées par un habillage. Pour fournir les styles par défaut pouvant être étendus ou remplacés, utilisez.

Comme avec $wgResourceModules, les valeurs par défaut des chemins sont relatives par rapport à la racine de MediaWiki. Vous devez toujours fournir un  et   (ou   /  ).

Exemple :



Effacer les styles de l'interface utilisateur MediaWiki
Le noyau MediaWiki ajoute le CSS des modules MediaWiki UI  en tant que   , ce qui permet aux habillages de réécraser leurs styles. Un exemple extrême, pour éléminer la plupart des styles :