Manual:$wgResourceModuleSkinStyles/fr

La variable globale $wgResourceModuleSkinStyles permet aux habillages de fournir des feuilles de style supplémentaires pour personnaliser les modules ResourceLoader existants. Skins can modify it by editing the ResourceModuleSkinStyles key in skin.json. Extensions can make their module styles customizable by skins by setting the skinStyles key on their ResourceLoader module definitions.

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. By default, your definition will then replace the CSS/LESS file, which has already defined styles for this module before. 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
The ResourceModuleSkinStyles key inside skin.json can be used to alter the styles of known ResourceLoader modules that have been defined in the ResourceModules key of other extensions.

The styles defined using $wgResourceModuleSkinStyles are later added to the  list of the existing module. La liste  ne peut pas être modifiée ni désactivée.

For example, if this is the definition of the ResourceLoader module bar:

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

Cela équivaut le plus souvent à :

If the module already defines its own entry in  for a given skin, then $wgResourceModuleSkinStyles is ignored.

If a module defines a  the skin may want to extend that instead of replacing them. 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 :