Centre des communautés
Advertisement

Cette page d'aide vous présente les différentes façons recommandées d'inclure du CSS et du JavaScript supplémentaires sur votre communauté.

ImportJS[]

MediaWiki:ImportJS fournit une interface pour inclure des pages qui contiennent des scripts - qu'ils soient locaux ou sur Fandom Developers Wiki - sur une communauté.

Il n'est pas nécessaire que le JS personnalisé soit activé sur le wiki pour que ImportJS fonctionne.

Utilisation[]

MediaWiki:ImportJS fournit un article en format brut dans lequel vous pouvez indiquer des noms de pages JavaScript. Les fichiers locaux devront être dans l'espace de noms MediaWiki. Les imports depuis Fandom Developers Wiki devront aussi être dans l'espace de noms MediaWiki pour fonctionner. Quand vous voulez importer des fichiers, l'espace de noms MediaWiki n'a pas besoin d'être inclus. Exemple :

// Fichier local JS
Cat.js

// Script de Fandom Developers Wiki
dev:UploadMultipleFiles.js


La fonctionnalité d'ImportJS est similaire à la méthode importArticles, qui permet d'importer des articles locaux ou de communautés externes, de les regrouper dans une seule requête et de les minifier. importArticles et ImportJS réduisent tous deux la taille des page et le trafic web, permettant de ce fait à une communauté possédant un grand nombre de fichier additionnels de se charger plus rapidement.

Ordre de chargement[]

Quand vous utilisez ImportJS, les pages s'y trouvant seront chargées en dernier. L'ordre global de chargement est :

  1. Common.js
  2. Fandomdesktop.js
  3. Scripts importés via Common.js
  4. Scripts importés via Fandomdesktop.js
  5. ImportJS

Imports de CSS[]

Méthode @import[]

En utilisant @import, des styles peuvent être importés depuis n'importe quel fichier CSS hébergé sur un wiki ou tout autre site internet (se terminant par .css dans l'url et contenant des modification pour le thème par défaut dans le fichier). La syntaxe est la suivante :

@import "chemin_du_fichier_a_importer.css"

Dans l'exemple ci-dessus, pour importer Local.css dans le fichier Common.css, placez ceci en haut de votre fichier Common.css (il doit être placé avant tout autre règles) :

@import "/index.php?title=MediaWiki:Local.css&action=raw&ctype=text/css";

Une manière alternative, qui rendra plus facile de repérer les fichiers chargés dans l'onglet « Réseau » de l'« Outil de Développement Web » de votre navigateur, est d'utiliser :

@import url("/MediaWiki:Local.css?ctype=text/css&action=raw");

De plus amples informations sur cette méthode sont disponibles ici.

importArticles[]

Au lieu de la méthode ci-dessus, on ne parlera ici de importArticles qu'en rapport aux imports de CSS. Pour les imports de JS, merci de consulter cette page.

importArticles peut aussi être utilisé pour importer des styles CSS. Cependant, ils seront soumis au processus de vérification du JS car il faut utiliser du JavaScript pour le faire. De plus, le chargement de CSS via cette méthode crée un effet de scintillation du fait que le CSS est appliqué après que la page est initialement affichée. Pour de meilleurs résultats, utilisez la méthode @import.

Exemple[]

Importer un fichier CSS local via importArticles :

importArticles({
    type: "style",
    article: "MediaWiki:Local.css"
});

Voir aussi[]

Plus d'aide

Advertisement