Ce modèle affiche un bouton permettant d'ajouter un sujet de discussion sur une page.
Ce modèle dispose des paramètres suivants :
page : Page sur laquelle le sujet doit être ajouté (par défaut : page en cours).
texte bouton : Texte à afficher sur le bouton (par défaut : "Ajouter un sujet").
titre : Titre de la nouvelle section.
notice : Page contenant une notice d'édition à afficher au dessus de la zone d'édition.
préchargement : Page contenant un texte à précharger dans la zone d'édition.
alignement : Alignement du bouton. Attention, lorsque ce paramètre est renseigné, le bouton s'affiche obligatoirement sur une ligne séparée du reste du texte. Valeurs possibles : left pour aligner à gauche, center pour centrer et right pour aligner à droite.
taille texte : Taille du texte affiché sur le bouton. Peut être exprimée en em, en px ou en %.
masquer champ sujet : Qui permet de ne pas apparaître le champ « Sujet / titre ».
outils de discussion : Qui permet de désactiver les outils de discussion.
Exemples
Cliquez sur un bouton pour voir l'action effectuée.
Code simple
Les paramètres page et texte bouton sont fortement recommandés lors de l'utilisation de ce modèle. Le paramètre page peut être omis si le sujet doit être ajouté sur la page sur laquelle se situe le bouton, mais il reste recommandé de le préciser, car une page peut être inclue dans une autre.
{{Ajouter un sujet|page=Discussion aide:Bac à sable}} : Ajouter un sujet
{{Ajouter un sujet|page=Discussion aide:Bac à sable|texte bouton=Ajouter une section}} : Ajouter une section
Ajustement du contenu de la page de modification
Ces paramètres impactent la page de modification qui s'affiche lorsque l'on clique sur le bouton.
{{Ajouter un sujet|page=Discussion aide:Bac à sable|titre=Nouvelle section}} : Ajouter un sujet
{{Ajouter un sujet|page=Discussion aide:Bac à sable|préchargement=Modèle:Brouillon/chargement}} : Ajouter un sujet
{{Ajouter un sujet|page=Discussion aide:Bac à sable|notice=Modèle:Brouillon/message}} : Ajouter un sujet
Alignement
Le fait de fournir ce paramètre force l'affichage du bouton sur une ligne séparée, même si l'alignement est à gauche. Le bouton peut être à gauche, au centre ou à droite, et la valeur doit être fournie en anglais : left pour aligner à gauche, center pour centrer et right pour aligner à droite.
À gauche : {{Ajouter un sujet|page=Discussion aide:Bac à sable|alignement=left}} : Ajouter un sujet
Au centre :{{Ajouter un sujet|page=Discussion aide:Bac à sable|alignement=center}} : Ajouter un sujet
À droite : {{Ajouter un sujet|page=Discussion aide:Bac à sable|alignement=right}} : Ajouter un sujet
Taille
La taille du texte affiché sur le bouton peut être ajustée, ce qui modifie la taille globale du bouton. Elle peut être exprimée en em, en px ou en %.
{{Ajouter un sujet|page=Discussion aide:Bac à sable|taille texte=2em}} : Ajouter un sujet
{{Ajouter un sujet|page=Discussion aide:Bac à sable|taille texte=150%}} : Ajouter un sujet
Avec tous les paramètres
Lorsque le nombre de paramètres est conséquent, il est conseillé de présenter le code verticalement comme ceci :
{{Ajouter un sujet
|page=Discussion aide:Bac à sable
|texte bouton=Ajouter une section
|titre=Nouvelle section
|préchargement=Modèle:Brouillon/chargement
|notice=Modèle:Brouillon/message
|alignement=center
|taille texte=150%
|masquer champ sujet=true
}}