FANDOM


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é.

ImportJSModifier

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.

Cette fonctionnalité est similaire à la méthode existante 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. ImportJS impacte tous les thèmes tout comme Common.js.

Bulb

Vérification du JavaScript

La fonctionnalité ImportJS permet de contourner le besoin de passer par une vérification du JavaScript. Cela permet l'ajout ou la suppression immédiate des imports de JavaScript pour la communauté !

Utilisation Modifier

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:AjaxRC.js

Ordre de chargement Modifier

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

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

Imports de CSS Modifier

importArticles Modifier

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.

Exemple Modifier

Importer un fichier CSS local via importArticles :

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

Méthode @import Modifier

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 Wikia.css, placez ceci en haut de votre fichier Wikia.css (du fait de l'ordre de chargement et des différences avec le chargement de Common.css, il peut être nécessaire que des imports soient ajoutés à votre fichier Common.css afin que ça fonctionne correctement) :

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

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

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

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

Voir aussi Modifier

Plus d'aideModifier

Sauf mention contraire, le contenu de la communauté est disponible sous licence CC-BY-SA  .