Voir la source de Modèle:Méta bandeau d'avertissement/Documentation

{{Documentation modèle en sous-page}}
Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux d'avertissements conformes à la charte graphique. Il n'est pas destiné à être utilisé directement dans les articles.
== Syntaxe ==
 <nowiki>{{</nowiki>Méta bandeau d'avertissement
 | niveau = ''grave'', ''modéré'', ''ébauche'', ou ''information'' (obligatoire)
 | icône = ''nom de l'image'' (facultatif)
 | titre = ''titre de l'avertissement'' (obligatoire)
 | texte = ''texte de l'avertissement'' (facultatif)
 <nowiki>}}</nowiki>

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é.

== Explication des paramètres ==
=== Paramètre « niveau » ===
Type de bandeau. Voici quelques indications pour choisir le '''niveau''' :

;niveau « grave »
Nécessité de modification urgente, violation manifeste d'un [[:Catégorie:Principe fondateur de Wikipédia|principe fondateur]] (non neutralité de point de vue, etc.), ou d'une [[:Catégorie:Règle officielle de Wikipédia|règle officielle]] (travail inédit, etc.), disparition prochaine possible de contenu (violation de copyright, proposition de suppression, 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 {{m|ébauche}}. Par défaut, le style est le même que pour les bandeaux de niveau « information ».

;niveau « information »
Avertissements permanents, y compris les avertissement d'évènement récents ou futurs. (Les bandeaux de maintenance, les annonces de travaux, etc. sont exclus.)

=== Paramètres « icône » ===
Nom d'une image (sans le préfixe « Image: ») à faire apparaitre à 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 pixels de large et 35 pixels de hauteur . 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 [[:commons:Nuvola/all|Nuvola]] et [[:commons:Crystal Clear|Crystal Clear]] conviennent particulièrement bien du point de vue graphique.

=== Paramètres « titre » et « texte » ===
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.

=== Paramètres supplémentaires : « icône-complexe », « id » et « supplément » ===
;icône-complexe
: À utiliser à la place du paramètre ''icône'', pour remplacer l'image par du contenu quelconque. Par exemple, le modèle {{m|É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 {{m|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 {{m|À 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 ».

== Exemples d’utilisation ==

=== Avec le paramètre « icône » ===
{|width="100%" border="1" cellspacing="0" cellpadding="2" style="border:1px solid #aaa;border-collapse:separate"
|-
!width="50%"|Code
!width="50%"|Rendu
|-
|width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''modéré'''<nowiki>
|icône=Nuvola apps locale.png
|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] !
}}</nowiki></poem>
|width="50%"|
{{Méta bandeau d'avertissement
|niveau=modéré
|icône=Nuvola apps locale.png
|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 » ===
Une icône générique est fournie
{|width="100%" border="1" cellspacing="0" cellpadding="2" style="border:1px solid #aaa;border-collapse:separate"
|-
!width="50%"|Code
!width="50%"|Rendu
|-
|width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''grave'''<nowiki>
|titre=Bandeau de niveau grave.
|texte=Alerte avec icône générique.
}}</nowiki></poem>
|width="50%" style="border-left:1px solid #aaa;border-top:1px solid #aaa"|
{{Méta bandeau d'avertissement
|niveau=grave
|titre=Bandeau de niveau grave.
|texte=Alerte avec icône générique.
}}
|-
|width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''modéré'''<nowiki>
|titre=Bandeau de niveau modéré.
|texte=Avertissement avec icône générique.
}}</nowiki></poem>
|width="50%"|
{{Méta bandeau d'avertissement
|niveau=modéré
|titre=Bandeau de niveau modéré.
|texte=Avertissement avec icône générique.
}}
|-
|width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''ébauche'''<nowiki>
|titre=Bandeau de niveau ébauche.
|texte=Ébauche avec icône générique.
}}</nowiki></poem>
|width="50%"|
{{Méta bandeau d'avertissement
|niveau=ébauche
|titre=Bandeau de niveau ébauche.
|texte=Ébauche avec icône générique.
}}
|-
|width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''information'''<nowiki>
|titre=Bandeau de niveau information.
|texte=Information avec icône générique.
}}</nowiki></poem>
|width="50%"|
{{Méta bandeau d'avertissement
|niveau=information
|titre=Bandeau de niveau information.
|texte=Information avec icône générique.
}}
|}
<includeonly>
[[Catégorie:Modèles|Documentation modèle|"]]
[[Catégorie:Documentation de modèle|"]]
[[Catégorie:Modèle de bandeau|*]]
[[Catégorie:Méta-modèle|Bandeau d'avertissement]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->
</includeonly>