Jump to content

Manuel:Aperçu rapide

From mediawiki.org
This page is a translated version of the page Manual:Live preview and the translation is 100% complete.

L'aperçu rapide est une fonctionnalité de MediaWiki qui permet de montrer une prévisualisation d'un article ou d'une section dans un formulaire de modification sans recharger le reste du code HTML du formulaire.

Elle comporte quelques bogues, voir le bogue de suivi de l'aperçu rapide pour une liste à jour.

Activer l'aperçu rapide

L'aperçu rapide est activé ou non selon un paramètre de l'onglet « modification » de votre page de préférences utilisateur; par défaut il est désactivé.

Avantages

  • moins de trafic entrant : le code wiki et tous les menus ne sont pas de nouveau reçus depuis le serveur
  • temps de réponse plus rapide
  • même position de curseur dans la fenêtre de modification.
  • conserver annuler / refaire l'historique dans la fenêtre d'édition

Inconvénients

Seule la zone de prévisualisation est mise à jour, ce qui implique que :

  • les scripts ne sont pas exécutés s'ils n'utilisent pas l'accroche wikipage.content.
  • certaines parties de l'interface comme les liens interlangues, la liste des transclusions, etc... peuvent ne pas être mises à jour correctement.
  • la navigation dans l'historique du navigateur – avec la prévisualation – ne fonctionne plus

Détails techniques

Un aperçu rapide fait usage de l'API d'analyse syntaxique et de l'option difftotext de l'API de révision, pour soumettre la nouvelle version du texte afin de recevoir la prévisualisation analysée ou l'ensemble des différences dans la page de modification.

Puisque le côté client est dynamique, il nécessite JavaScript pour fonctionner. Et si JavaScript doit être désactivé, l'édition va donner l'aperçu traditionnel (au rechargement de la page), même si cette fonctionnalité est activée. Ceci est une instance de l'amélioration progressive.

Voir aussi