Aide:Gadget-Barre de luxe

Définition, traduction, prononciation, anagramme et synonyme sur le dictionnaire libre Wiktionnaire.
Sauter à la navigation Sauter à la recherche

Le gadget Barre de luxe est un gadget JavaScript, activable par tout utilisateur enregistré dans ses préférences, qui ajoute toute une panoplie de boutons pour faciliter l’édition des pages. Il est compatible avec la barre d’outils de modification.

Ce que fait ce gadget[modifier le wikicode]

Il ajoute une collection de boutons pour aider la contribution. Si vous utilisez la barre d’outils de modification, ils se situent dans l’onglet « Avancé ». Si vous ne l’utilisez pas, les boutons apparaitront au-dessus de la zone d’édition.e

Liste exhaustive des boutons[modifier le wikicode]

Image barre seule Image barre d’outils Action Groupe Caché si barre d’outils activée
Apostrophe.png Upper single apostrophe toolbar symbol.png Apostrophe typographique Format non
Button nbsp 1.png Button nbsp 1.png Espace insécable Format non
Button latinas.png Norwegian quote sign.png Guillemets français Format non
Button redir.png - Redirection (déjà présent dans la barre d’outils) - oui
Button wikipedia.png OOjs UI icon logo-wikipedia.svg Lien vers Wikipédia Liens non
Button accueilA.png Twemoji12 1f603.svg Message de remerciement à une IP Messages non
Button accueilB.png Twemoji12 1f642.svg Message de bienvenue Messages non
Button smiley3.png OOjs UI icon error.svg Message d’avertissement débutant Messages non
Button crocs.png OOjs UI icon error-progressive.svg Message vandale Messages non
Button aviso.png OOjs UI icon error-destructive.svg Message vandale 2 Messages non
Button attendre.png OOjs UI icon cancel-destructive.svg Message de blocage Messages non
Button exclamation 1.png OOjs UI icon alert-warning.svg Message spam Messages non
Button exclamation.png OOjs UI icon alert-destructive.svg Message spam 2 Messages non
Button copy vio.png Orange copyright.svg Message copyvio Messages non
Button copy vio plagio.png Red copyright.svg Message copyvio 2 Messages non
Button broom2.png OOjs UI icon trash-destructive.svg Modèle de suppression immédiate Bandeaux non
Button broom3.png OOjs UI icon trash.svg Bandeau de proposition de suppression Bandeaux non
Button anular voto.png OOjs UI icon stripeFlow-ltr.svg Patron d’entrée en français long Patrons non
Francefilm.png OOjs UI icon stripeSummary-ltr.svg Patron d’entrée en français court Patrons non
Buttonrefvs8.png OOjs UI icon reference.svg Section références Patrons non
Button cite book.png OOjs UI icon quotesAdd-ltr.svg Modèle {{source}} Insérer non
Button interprojet.png Network sans.svg Modèle {{Autres projets}} Liens non

Installation[modifier le wikicode]

Cochez la case suivante dans vos préférences (onglet « Gadget », section « Modification des pages ») :

ClickedCheckbox.jpg Barre de luxe : ajoute des boutons pour insérer des modèles pré-remplis en un clic (pour éditer une page, avertir les débutants, etc.). Nécessite de vider le cache du navigateur. Illustrations : version de base. (page d’aide)

C’est tout Clin d’œil

Ajout de boutons personnalisés[modifier le wikicode]

Deux type de boutons sont disponibles :

  • Un premier qui ajoute du texte de autour du texte sélectionné,
  • Un deuxième qui exécute une fonction personnalisée pour faire des traitements plus complexes.

Pour ajouter un bouton, il faut vous modifier votre page Utilisateur:XXX/common.js et y insérer le code qui définira les boutons et les ajoutera :

mw.loader.using("ext.gadget.Barre_de_luxe").done(function () {
  wikt.gadgets.barreDeLuxe.addButtons([
    // Définition des boutons.
  ]);
});

La liste indiquée par // Définition des boutons. est l’endroit où les boutons doivent être définis.

Pour définir un bouton, il faut déclarer un objet avec les attributs suivants :

  • imageFileName Le chemin de l’icone du bouton sur Commons si la barre d’outils de modification est désactivée (après « commons/ »). Taille recommandée : 23×22 pixels. Si l’extension n’est pas renseignée, le fichier sera considéré comme étant un .PNG.
  • imageFileNameOOUI Le chemin de l’icone du bouton sur Commons pour la barre d’outils de modification (après « commons/ »). Taille recommandée : 24×24 pixels. Optionnel si vous n’utilisez pas cette barre d’outils. S’il n’est pas défini et que vous utilisez la barre d’outils, l’image définie par imageFileName sera utilisée à la place. Si l’extension n’est pas renseignée, le fichier sera considéré comme étant un .PNG.
  • tooltip Le texte apparaissant dans l’infobulle au survol du bouton.
  • buttonId L’identifiant unique du bouton. Il doit n’utiliser que les 26 lettres de l’alphabet, le tiret (-) ou des chiffres.
  • group Le groupe de la barre d’outils de modification dans lequel ranger le bouton. Optionnel si vous n’utilisez pas cette barre d’outils. Les groupes disponibles sont :
    • format : « Format »
    • insert : « Insérer »
    • size : Boutons pour modifier la taille du texte
    • links : « Liens »
    • section_templates : « Patrons »
    • messages : « Messages »
    • headers : « Bandeaux »
    • html_tags : « Balises »
  • toolbarIgnore Si défini avec la valeur true, le bouton ne sera pas ajouté à la barre d’outils de modification.

Bouton simple[modifier le wikicode]

Ce type de bouton nécessite la définition de deux autres attributs :

  • tagOpen Le texte à insérer avant le texte sélectionné.
  • tagClose Le texte à insérer après le texte sélectionné.

Exemple complet (bouton insérant une balise <includeonly>) :

{
  tagOpen: "<includeonly>",
  tagClose: "</includeonly>",
  imageFileName: "9/9f/Button_nowiki_symbol.png",
  imageFileNameOOUI: "thumb/8/8c/OOjs_UI_icon_markup.svg/24px-OOjs_UI_icon_markup.svg.png",
  tooltip: "Balises includeonly",
  buttonId: "includeonly-tag",
  group: "html_tags",
},

Bouton avec fonction[modifier le wikicode]

Ce type de bouton nécessite la définition de trois autres attributs :

  • promptText Le texte à afficher dans le popup de saisie.
  • promptDefault Le valeur par défaut du champ de texte du popup de saisie.
  • action La fonction à exécuter après que l’utilisateur a validé le popup de saisie, qui retourne le texte qui remplacera celui sélectionné par l’utilisateur. Elle prend deux paramètres :
    • selectedText Le texte sélectionné par l’utilisateur.
    • inputText Le texte saisi par l’utilisateur dans le popup.

Exemple complet (bouton pour insérer le modèle {{pron}} dans la langue voulue) :

{
  action: function (selectedText, inputText) {
    return "{{pron|" + selectedText + "|" + inputText + "}}";
  },
  promptText: "Langue",
  promptDefault: "fr",
  imageFileName: "1/13/Button_API_ʃ.png",
  imageFileNameOOUI: "thumb/0/0a/OOjs_UI_icon_feedback-ltr.svg/24px-OOjs_UI_icon_feedback-ltr.svg.png",
  tooltip: "Prononciation",
  buttonId: "pron",
  group: "insert",
},

Exemple complet avec les boutons précédents[modifier le wikicode]

mw.loader.using("ext.gadget.Barre_de_luxe").done(function () {
  wikt.gadgets.barreDeLuxe.addButtons([
    {
      action: function (selectedText, inputText) {
        return "{{pron|" + selectedText + "|" + inputText + "}}";
      },
      promptText: "Langue",
      promptDefault: "fr",
      imageFileName: "1/13/Button_API_ʃ.png",
      imageFileNameOOUI: "thumb/0/0a/OOjs_UI_icon_feedback-ltr.svg/24px-OOjs_UI_icon_feedback-ltr.svg.png",
      tooltip: "Prononciation",
      buttonId: "pron",
      group: "insert",
    },
    {
      tagOpen: "<includeonly>",
      tagClose: "</includeonly>",
      imageFileName: "9/9f/Button_nowiki_symbol.png",
      imageFileNameOOUI: "thumb/8/8c/OOjs_UI_icon_markup.svg/24px-OOjs_UI_icon_markup.svg.png",
      tooltip: "Balises includeonly",
      buttonId: "includeonly-tag",
      group: "html_tags",
    },
  ]);
});

Ancienne syntaxe[modifier le wikicode]

L’ancienne syntaxe de définition est toujours supportée mais déconseillée car moins lisible.

Le bouton est défini dans un tableau plutot que dans un objet :

  • Indice 0 : Le texte à ajouter avant la sélection.
  • Indice 1 : Le texte à ajouter après la sélection.
  • Indice 2 : L’URL de l’icone sur Commons (après « commons/ »).
  • Indice 3 : Le texte qui apparait au survol de la souris.
  • Indice 4 : L’identifiant unique du bouton. Il doit n’utiliser que les 26 lettres de l’alphabet, le tiret (-) ou des chiffres.

Exemple complet (bouton pour insérer une redirection) :

[
  "#REDIRECT[[",
  "]]",
  "4/47/Button_redir",
  "Redirection",
  "redirect",
],

Signaler un problème ou suggérer une amélioration[modifier le wikicode]

→ voir Discussion MediaWiki:Gadget-Barre_de_luxe.js

Annexe — Pour les développeurs du gadget[modifier le wikicode]

Message système (le texte de description dans la page des préférences)
Code JavaScript
Requêtes des utilisateurs