Modèle:titre incorrect
- Cette documentation est incluse depuis Modèle:titre incorrect/Documentation. [rafraîchir] · [modifier] · [historique]
Ce modèle modifie le titre visible rendu par MediaWiki.
Utilisation
Ce modèle est utilisé lorsque MediaWiki est incapable de restituer le véritable titre à l’article ou des incertitudes orthographiques ou de codage conduisent à y substituer certains caractères. (Par exemple, présence d’un caractère non autorisé ou préfixe réservé dans la syntaxe Wiki ; etc.) Si le titre indiqué modifie le titre effectif de la page stockée dans MediaWiki, la page est automatiquement catégorisée dans Catégorie:Pages avec titre incorrect corrigé pour le suivi de ces modifications visuelles.
Syntaxe de base
{{titre incorrect|Titre réel corrigé}}{{titre incorrect|1=Titre réel corrigé}}
La numérotation explicite du paramètre (« 1=… ») est nécessaire lorsque le titre corrigé contient le symbole « = ».
Note : Si le titre corrigé comprend seulement les modèles et les balises suivantes, ce modèle n’utilise pas JavaScript et ne tient pas compte des paramètres supplémentaires :
Paramètres supplémentaires
Le modèle prend en charge les paramètres supplémentaires suivants :
2=explication: affiche une explication supplémentaire dans le bandeau lorsqu’il est affiché.invisible=non vide: n’affiche pas le bandeau d’avertissement, même lorsque le titre corrigé n’a pas pu être restitué (par exemple lorsque JavaScript est désactivé) ; cette option est utile lorsque la correction est uniquement de type cosmétique.nocorr=non vide: désactive la correction par défaut du titre et le masquage du bandeau par JavaScript.
Exemples
{{titre incorrect|I{{er}}|L’indicateur d’ordinal ''er'' devrait être en exposant.|nocorr=1}}
Le bandeau reste visible et le titre de cette page n’est pas corrigé à cause du paramètre nocorr.
{{titre incorrect|I{{er}}|invisible=oui}}
n’affiche pas de bandeau, mais le titre de la page est corrigé si JavaScript est activé.
Fonctionnement
Le titre correct est substitué à l’aide d’une fonction JavaScript (sauf en cas d’utilisation du paramètre « nocorr »). Sur les navigateurs n’ayant pas le JavaScript activé, un bandeau est affiché avertissant de l’orthographe correcte (sauf en cas d’utilisation du paramètre « invisible »).
Informations techniques
Le script JavaScript responsable de la correction du titre se trouve dans MediaWiki:Common.js ; il s’agit de la méthode rewritePageH1(), laquelle, au chargement de la page,
- détecte la présence du bandeau dans la page, identifiable par un élément avec
id="RealTitleBanner"(actuellement c'est un élément de type "div") ; - vérifie si un élément de la page (actuellement un "span", mais le javascript ne tient pas compte du type de cet élément qui peut aussi être une table, un span, etc.) a un attribut
id="DisableRealTitle"(un tel attribut est ajouté en cas d’utilisation du paramètrenocorr, mais il peut aussi être ajouté manuellement). Si tel est le cas le script s’arrête ici ; - récupère le titre réel corrigé, en recherchant dans l'élément bandeau trouvé un élément identifié par
id="RealTitle"; - utilise uniquement son contenu (pas ses attributs) pour remplacer le titre du premier élément
<h1>de la page ; - masque enfin le bandeau trouvé en modifiant son style CSS avec "display:none".
Ce comportement est effectif dès que des éléments avec attributs id="RealTitleBanner" et id="RealTitle" sont présents et inclus l’un dans l’autre, ce qui permet d’en tirer parti sans passer nécessairement par un appel à {{titre incorrect}}.