Extension:TemplateStylesExtender/fr

Manuel des extensions MediaWiki

TemplateStylesExtender État de la version : stable
Implémentation	Extension de l'analyseur
Description	Extends Extension:TemplateStyles with new selectors
Auteur(s)	Octfxdiscussion
Dernière version	2.0.0 (2025-06-02)
MediaWiki	1.43+
PHP	>=8.0
Composer	octfx/template-styles-extender
Paramètres $wgTemplateStylesExtenderCustomPropertiesDeclaration $wgTemplateStylesExtenderExtendCustomPropertiesValues $wgTemplateStylesExtenderEnableUnscopingSupport $wgTemplateStylesExtenderUnscopingPermission
Accroches utilisées ParserFirstCallInit TemplateStylesPropertySanitizer TemplateStylesStylesheetSanitizer
License	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	GitHub: page du projet URL du dépôt git historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net .

L'extension TemplateStylesExtender étend Extension:TemplateStyles avec de nouveaux sélecteurs et apparieurs. TemplateStylesExtender is developed based on css-sanitizer 5.5.0, which is being used by MediaWiki 1.43.

Fonctionnalités

• Declare CSS custom properties/variables
• Use CSS custom properties/variables in most properties
• Implement additional properties and values as listed below

Module	Changes	Upstream task
Basic User Interface Module Level 4	Added property: pointer-events	T342271
Box Sizing Module Level 4	Backported for css-sanitizer 5.5.0	T375344
Cascading and Inheritance Level 5	Added value: revert-layer	-
Color Module Level 4	Added: Alpha HEX notation	T265675
Color Module Level 5	Added: Relative color, color()	-
Containment Module Level 3	Added properties: contain, content-visibility	-
Filter Effects Module Level 2	Added property: backdrop-filter	-
Fonts Module Level 4	Added properties: font-optical-sizing, font-variation-settings, ascent-override, descent-override, font-display, line-gap-override	-
Fonts Module Level 5	Added property: size-adjust	-
Masking Module Level 1	Added property: -webkit-mask-image	-
Ruby Annotation Layout Module Level 1	Added properties: ruby-align, ruby-position	T277755
Scroll Snap Module Level 1	Added properties: scroll-margin, scroll-padding, scroll-snap-align, scroll-snap-stop, scroll-snap-type	T271598
Values and Units Module Level 4	Added function: clamp()	T394619

Installation

• Télécharger et placez le(s) fichier(s) dans un répertoire appelé TemplateStylesExtender dans votre dossier extensions/.
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'TemplateStyles' );
  wfLoadExtension( 'TemplateStylesExtender' );
  

• Configurer selon les besoins.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Configuration	Description	Valeur par défaut
$wgTemplateStylesExtenderCustomPropertiesDeclaration	Allow CSS custom properties (CSS variables) to be declared as properties	true
$wgTemplateStylesExtenderExtendCustomPropertiesValues	Allow the CSS custom properties (CSS variables) to be used as values in all properties	true
$wgTemplateStylesExtenderEnableUnscopingSupport	Allows users with unscope permissions to unscope CSS by setting a wrapclass attribute.	false
$wgTemplateStylesExtenderUnscopingPermission	Specify a permission group that is allowed to unscope CSS.	editinterface

Note sur les variables CSS

L'utilisation actuelle des sélecteurs :root ne fonctionne pas car les styles des modèles sont préfixés par .mw-parser-output.

Une correction possible est d'inclure l'ensemble du contenu dans un élément 'div' et d'y ajouter les déclarations, par exemple :

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Wikicode

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

Dévier le CSS

Exemple : fait que le CSS est celui de .mediawiki au lieu d'être celui de .mw-parser-output.

En incluant un tel appel dans la page, vous ne rendez possibles les modifications principalement qu'aux utilisateurs ayant les droits editinterface. Une autre solution est d'inclure l'appel d'un modèle qui inclut les styles.

Voir aussi

• Extension:TemplateStyles