Modèle:Méta bandeau d'avertissement/Documentation

Utilisation modifier

Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux d'avertissements conformes à la charte graphique. NE PAS UTILISER DANS LES ARTICLES !

Paramètres du modèle

La mise en forme multiligne est préférée pour ce modèle.

ParamètreDescriptionTypeÉtat
Niveauniveau

Type de bandeau.

Valeurs suggérées
grave modéré ébauche information
Exemple
grave, modéré, ébauche ou information
Chaîneobligatoire
Classclass

Ajoute une class au bandeau.

Exemple
noprint
Chaînefacultatif
IDid

Affecte un identificateur au bandeau (correspond à l'attribut « id » en HTML). Par exemple, le bandeau {{Titre incorrect}} utilise « id = RealTitleBanner » (voir la documentation de ce modèle pour en comprendre l'utilité).

Chaînefacultatif
Icôneicône

Nom de l'image.

Fichiersuggéré
Alternativealt légende

Alternative textuelle de l'icône (obligatoire si icône est le nom d'une image).

Chaînefacultatif
Icône complexeicône-complexe

À utiliser à la place du paramètre icône, pour remplacer l'image par du contenu quelconque. Par exemple, le modèle {{Ébauche}} utilise un tel paramètre pour afficher plusieurs icônes lorsque plusieurs thèmes lui sont fournis. À utiliser avec parcimonie.

Fichierfacultatif
Titretitre

Titre du bandeau.

Exemple
Attention, cet article n'existe pas !
Chaîneobligatoire
Textetexte

Texte de l'avertissement.

Chaîneobligatoire
Datedate

Affiché à droite du titre, sur la même ligne mais sans formatage.

Chaînesuggéré
Domaine publicdomaine public

aucune description

Exemple
oui
Chaînefacultatif
Icône BMAicône bma

Ajoute en haut à droite du bandeau une icône liant vers : soit Aide:Bandeau (avec icône bma = oui) , soit une autre page au choix (avec icône bma = nom de la page). Voir le modèle {{bma}}.

Valeurs suggérées
oui
Exemple
Modèle:À sourcer
Chaînefacultatif
Supplémentsupplément

Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit. Par exemple, le bandeau {{À fusionner}} utilise un tel paramètre pour afficher la marche à suivre dans une section rétractable. L'icône du bandeau sera centrée sur le contenu fourni par les paramètres « titre » et « texte », sans tenir compte du contenu fourni par le paramètre « supplément ».

Contenufacultatif

Syntaxe modifier

{{Méta bandeau d'avertissement
| niveau = grave, modéré, ébauche, ou information (obligatoire)
| icône = nom de l'image (facultatif)
| alt = alternative textuelle de l'icône (obligatoire si icône est le nom d'une image)
| titre = titre de l'avertissement (obligatoire)
| texte = texte de l'avertissement (facultatif)
}}

D'autre part, le paramètre icône peut être remplacé par un paramètre icône-complexe, et des paramètres id et supplément peuvent être ajoutés.

Paramètres modifier

niveau modifier

Type de bandeau. Voici quelques indications pour choisir le niveau :

  • Niveau « grave » : Nécessité de modification urgente, violation manifeste d'un principe fondateur (non neutralité de point de vue, etc.), ou d'une règle (travail inédit, etc.), disparition prochaine possible de contenu (violation de copyright, débat d'admissibilité, etc.)
  • Niveau « modéré » : Besoin de modification sur l'article (à internationaliser, etc.), annonce de travail en cours (traduction, etc.). (Les avertissements permanents sont exclus.)
  • Niveau « ébauche » : Bandeaux d'ébauche. Un tel paramètre devrait être utilisé uniquement par le modèle {{ébauche}}. Par défaut, le style est le même que pour les bandeaux de niveau « information ».
  • Niveau « information » : Avertissements permanents, y compris les avertissements d'évènement récents ou futurs. (Les bandeaux de maintenance, les annonces de travaux, etc. sont exclus.)

icône modifier

Nom d'une image (sans le préfixe « Image: ») à faire apparaître à gauche du bandeau en guise d'icône. Pour raison d'uniformité de style, la taille ne peut pas être spécifiée : ce sera la plus grande taille qui permet d'insérer l'image dans un rectangle de 45 × 45 pixels. Préférer une icône graphiquement simple et significative. En l'absence de ce paramètre, une icône par défaut dépendant du niveau est fournie.

Par exemple, les icônes des collections Nuvola et Crystal Clear conviennent particulièrement bien du point de vue graphique.

Pour l'accessibilité du bandeau, si un nom d'icône est précisé, il faut renseigner le paramètre alt, alternative textuelle de l'image.

titre et texte modifier

Titre et texte explicatif du bandeau. Idéalement, le titre doit être court et significatif (maximum une ligne), et le texte ou sous-titre doit être bref, en un seul paragraphe. Ne pas enrober le message dans une prose inutilement longue. Limiter les liens aux liens les plus pertinents.

date modifier

Affiché à droite du titre, sur la même ligne mais sans formatage.

Paramètres supplémentaires modifier

  • icône-complexe : À utiliser à la place du paramètre icône, pour remplacer l'image par du contenu quelconque. Par exemple, le modèle {{Ébauche}} utilise un tel paramètre pour afficher plusieurs icônes lorsque plusieurs thèmes lui sont fournis. À utiliser avec parcimonie.
  • id : Affecte un identificateur au bandeau (correspond à l'attribut « id » en HTML). Par exemple, le bandeau {{Titre incorrect}} utilise « id = RealTitleBanner » (voir la documentation de ce modèle pour en comprendre l'utilité).
  • supplément : Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit. Par exemple, le bandeau {{À fusionner}} utilise un tel paramètre pour afficher la marche à suivre dans une section rétractable. L'icône du bandeau sera centrée sur le contenu fourni par les paramètres « titre » et « texte », sans tenir compte du contenu fourni par le paramètre « supplément ».
  • icône bma : Définir ce paramètre à oui pour ajouter en haut à droite du bandeau une icône liant vers Aide:Bandeau (voir modèle {{bma}}).

Exemples modifier

Avec le paramètre icône modifier

Code Rendu
{{Méta bandeau d'avertissement
| niveau = modéré
| icône  = Nuvola apps locale.svg
| alt    = drapeaux
| titre  = Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
| texte  = Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
}}

Sans paramètre icône modifier

Une icône générique est fournie.

Code Rendu
{{Méta bandeau d'avertissement
| niveau = grave
| titre  = Bandeau de niveau grave.
| texte  = Alerte avec icône générique.
}}
{{Méta bandeau d'avertissement
| niveau = modéré
| titre  = Bandeau de niveau modéré.
| texte  = Avertissement avec icône générique.
}}
{{Méta bandeau d'avertissement
| niveau = ébauche
| titre  = Bandeau de niveau ébauche.
| texte  = Ébauche avec icône générique.
}}
{{Méta bandeau d'avertissement
| niveau = information
| titre  = Bandeau de niveau information.
| texte  = Information avec icône générique.
}}

Avec le paramètre date modifier

Code Rendu
{{Méta bandeau d'avertissement
| niveau = modéré
| titre  = Bandeau de niveau modéré.
| date   = octobre 2012
| texte  = Avertissement avec icône générique.
}}

Voir aussi modifier