Modèle:Méta bandeau/Documentation : Différence entre versions

De Wikonsult
Sauter à la navigation Sauter à la recherche
m (1 révision importée)
m (1 révision importée)
 
(2 révisions intermédiaires par un autre utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Sous-page de documentation}}
 
{{Sous-page de documentation}}
 
<includeonly>
 
 
{{Avertissement méta-modèle}}
 
{{Avertissement méta-modèle}}
 
{{Modèle utilisant les modules Lua|Bandeau}}
 
{{Modèle utilisant les modules Lua|Bandeau}}
</includeonly>
 
  
 
== Utilisation ==
 
== Utilisation ==
Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux conformes à la charte graphique.
+
<templatedata>
 +
{
 +
"params": {
 +
"forme": {
 +
"description": "Définit la forme du bandeau en fonction de l'utilisation prévue du bandeau",
 +
"type": "line",
 +
"default": "simple",
 +
"suggested": true,
 +
"example": "système, discussion, article..."
 +
},
 +
"niveau": {
 +
"example": "grave, modéré, information ou neutre",
 +
"type": "line",
 +
"default": "neutre",
 +
"suggested": true,
 +
"description": " Définit la couleur du bandeau en fonction de sa gravité."
 +
},
 +
"icône": {
 +
"description": "Icône associée au bandeau, fichier d'image ou image wikifiée.",
 +
"type": "string",
 +
"example": "attention",
 +
"aliases": [
 +
"image"
 +
]
 +
},
 +
"alt": {
 +
"label": "Alternative textuelle",
 +
"type": "content",
 +
"description": "Alternative textuelle de l'image.",
 +
"aliases": [
 +
"légende"
 +
]
 +
},
 +
"domaine public": {
 +
"description": "Définir ce paramètre à oui pour supprimer l'hyperlien sur l’icône (paramètre autorisé seulement si l’icône est dans le domaine public).",
 +
"example": "oui",
 +
"type": "string"
 +
},
 +
"taille icône": {
 +
"description": "Change la taille de l’icône.",
 +
"example": "15",
 +
"type": "string",
 +
"default": "45x45"
 +
},
 +
"texte": {
 +
"required": true,
 +
"suggested": true,
 +
"description": "Texte explicatif du bandeau",
 +
"example": "Cet article ne cite pas suffisamment ses sources.",
 +
"type": "content"
 +
},
 +
"supplément": {
 +
"description": "Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit.",
 +
"example": "Une marche à suivre",
 +
"type": "content"
 +
},
 +
"style": {
 +
"description": "Code CSS permettant de personnaliser le style du bandeau (largeur, couleur, taille de police...).",
 +
"type": "content"
 +
},
 +
"id": {
 +
"description": "Affecte un identificateur au bandeau (correspond à l'attribut « id » en HTML)",
 +
"type": "string"
 +
},
 +
"class": {
 +
"example": "noprint",
 +
"description": "Ajoute une class au bandeau.",
 +
"type": "string"
 +
},
 +
"centrer": {
 +
"description": "Définir ce paramètre à oui pour centrer le bandeau.",
 +
"example": "oui",
 +
"type": "string"
 +
},
 +
"droite": {
 +
"description": "Contenu à ajouter à droite du texte.",
 +
"type": "string"
 +
},
 +
"icône bma": {
 +
"description": "Définir ce paramètre à oui pour ajouter en haut à droite du bandeau une icône liant vers la page Aide:Bandeau (voir modèle {{bma}}).",
 +
"example": "oui",
 +
"type": "string"
 +
}
 +
},
 +
"description": "Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux conformes à la charte graphique.",
 +
"format": "block",
 +
"paramOrder": [
 +
"forme",
 +
"niveau",
 +
"class",
 +
"id",
 +
"style",
 +
"icône",
 +
"taille icône",
 +
"alt",
 +
"texte",
 +
"supplément",
 +
"centrer",
 +
"droite",
 +
"icône bma",
 +
"domaine public"
 +
]
 +
}
 +
</templatedata>
  
 
== Syntaxe ==
 
== Syntaxe ==
 
  <nowiki>{{</nowiki>Méta bandeau
 
  <nowiki>{{</nowiki>Méta bandeau
  | forme = ''article'', ''discussion'', ''système'' ou ''simple'' (facultatif, simple par défaut)
+
  | forme = ''article'', ''discussion'', ''système'' ou ''simple'' (facultatif, simple par défaut)
 
  | niveau = ''grave'', ''modéré'', ''information'' ou ''neutre'' (facultatif, neutre par défaut)
 
  | niveau = ''grave'', ''modéré'', ''information'' ou ''neutre'' (facultatif, neutre par défaut)
  | icône = ''nom de l'image'' (facultatif)
+
  | icône = ''nom de l'image'' (facultatif)
  | alt = ''alternative textuelle de l'icône'' (obligatoire si ''icône'' est le nom d'une image)
+
  | alt   = ''alternative textuelle de l'icône'' (obligatoire si ''icône'' est le nom d'une image)
  | texte = ''texte du bandeau'' (obligatoire)
+
  | texte = ''texte du bandeau'' (obligatoire)
 
  <nowiki>}}</nowiki>
 
  <nowiki>}}</nowiki>
  
 
== Paramètres principaux ==
 
== Paramètres principaux ==
* <code>forme</code> : définit la forme du bandeau (article à bord gauche plus épais, discussion à coins arrondis...) en fonction de l'utilisation prévue du bandeau.
+
* <code>forme</code> : Définit la forme du bandeau (article à bord gauche plus épais, discussion à coins arrondis...) en fonction de l'utilisation prévue du bandeau.
* <code>niveau</code> : définit les couleurs du bandeau.
+
* <code>niveau</code> : Définit les couleurs du bandeau.
* <code>icône</code> : icône associée au bandeau. Cela peut être :
+
* <code>icône</code> : Icône associée au bandeau. Cela peut être :
** le nom d'une image d'arrière-plan par défaut (voir la section exemple) ;
+
** Le nom d'une image d'arrière-plan par défaut (voir la section exemple) ;
** le nom d'une image sera affiché au format 45x45px ;
+
** Le nom d'une image sera affiché au format 45x45px ;
** une ou plusieurs images complète pour un format personnalisé (déconseillé).
+
** Une ou plusieurs images complète pour un format personnalisé (déconseillé).
* <code>alt</code> : alternative textuelle de l'image. Pour l'accessibilité du bandeau, ce paramètre est obligatoire lorsque le nom d'une image est précisé pour l'icône. Si l'image est dans le domaine public, il est possible de simplement précisé <code>|alt = domaine public</code>, ce qui désactive le lien vers la page Commons.
+
* <code>alt</code> : alternative textuelle de l'image.
 
* <code>texte</code> : texte explicatif du bandeau.
 
* <code>texte</code> : texte explicatif du bandeau.
  
Ligne 51 : Ligne 151 :
 
|-
 
|-
 
| <pre>{{Méta bandeau
 
| <pre>{{Méta bandeau
   | forme = simple article
+
   | forme = article
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}</pre>
 
  }}</pre>
Ligne 65 : Ligne 165 :
 
| {{Méta bandeau
 
| {{Méta bandeau
 
   | forme = discussion
 
   | forme = discussion
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <pre>{{Méta bandeau
 +
  | forme = note
 +
  | texte  = texte du bandeau.
 +
}}</pre>
 +
| {{Méta bandeau
 +
  | forme = note
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <pre>{{Méta bandeau
 +
  | forme = section
 +
  | texte  = texte du bandeau.
 +
}}</pre>
 +
| {{Méta bandeau
 +
  | forme = section
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 82 : Ligne 200 :
 
! scope=col style="width: 50%"| Code
 
! scope=col style="width: 50%"| Code
 
! scope=col style="width: 50%"| Rendu
 
! scope=col style="width: 50%"| Rendu
 +
|-
 +
| <pre>{{Méta bandeau
 +
  | niveau = aucun
 +
  | texte  = texte du bandeau.
 +
}}</pre>
 +
| {{Méta bandeau
 +
  | niveau = aucun
 +
  | texte  = texte du bandeau.
 +
}}
 
|-
 
|-
 
| <pre>{{Méta bandeau
 
| <pre>{{Méta bandeau
Ligne 91 : Ligne 218 :
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
 +
|-
 +
| <pre>{{Méta bandeau
 +
  | niveau = detail
 +
  | texte  = texte du bandeau.
 +
}}</pre>
 +
| {{Méta bandeau
 +
  | niveau = detail
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <pre>{{Méta bandeau
 +
  | niveau = ebauche
 +
  | texte  = texte du bandeau.
 +
}}</pre>
 +
| {{Méta bandeau
 +
  | niveau = ebauche
 +
  | texte  = texte du bandeau.
 +
}}
 
|-
 
|-
 
| <pre>{{Méta bandeau
 
| <pre>{{Méta bandeau
Ligne 130 : Ligne 275 :
 
! scope=col style="width: 50%"| Rendu
 
! scope=col style="width: 50%"| Rendu
 
|-
 
|-
| <code><nowiki>| icône = information</nowiki></code>
+
| <code><nowiki>| icône = accessibilite</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = accessibilite
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = ADQ</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = ADQ
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = archives</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = information
+
   | icône = archives
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 142 : Ligne 299 :
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = stop</nowiki></code>
+
| <code><nowiki>| icône = BA</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = BA
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = biblio</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = biblio
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = categorie</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = categorie
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = conflit</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = stop
+
   | icône = conflit
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 154 : Ligne 329 :
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = archives</nowiki></code>
+
| <code><nowiki>| icône = engrenage</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = engrenage
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = general</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = general
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = important</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = important
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = incomplet</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = incomplet
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = information</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = information
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = loupe</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = archives
+
   | icône = loupe
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 169 : Ligne 374 :
 
| {{Méta bandeau
 
| {{Méta bandeau
 
   | icône = protection
 
   | icône = protection
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = protege</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = protege
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = recyclage</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = recyclage
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 178 : Ligne 395 :
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = engrenage</nowiki></code>
+
| <code><nowiki>| icône = sons</nowiki></code>
 +
| {{Méta bandeau
 +
  | icône = sons
 +
  | texte  = texte du bandeau.
 +
}}
 +
|-
 +
| <code><nowiki>| icône = sources</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = engrenage
+
   | icône = sources
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = conflit</nowiki></code>
+
| <code><nowiki>| icône = stop</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = conflit
+
   | icône = stop
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = ADQ</nowiki></code>
+
| <code><nowiki>| icône = travaux</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = ADQ
+
   | icône = travaux
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
 
|-
 
|-
| <code><nowiki>| icône = BA</nowiki></code>
+
| <code><nowiki>| icône = videos</nowiki></code>
 
| {{Méta bandeau
 
| {{Méta bandeau
   | icône = BA
+
   | icône = videos
 
   | texte  = texte du bandeau.
 
   | texte  = texte du bandeau.
 
  }}
 
  }}
Ligne 220 : Ligne 443 :
 
== Voir aussi ==
 
== Voir aussi ==
 
* {{m|Méta bandeau d'avertissement}}
 
* {{m|Méta bandeau d'avertissement}}
 +
* {{m|Méta bandeau de note}}
 
* {{m|Méta bandeau de section}}
 
* {{m|Méta bandeau de section}}
 
 
<includeonly>
 
<includeonly>
 
[[Catégorie:Modèle de bandeau| ]]
 
[[Catégorie:Modèle de bandeau| ]]
 
[[Catégorie:Méta-modèle]]
 
[[Catégorie:Méta-modèle]]
 
</includeonly>
 
</includeonly>

Version actuelle datée du 5 mai 2020 à 17:03

Utilisation

<templatedata> { "params": { "forme": { "description": "Définit la forme du bandeau en fonction de l'utilisation prévue du bandeau", "type": "line", "default": "simple", "suggested": true, "example": "système, discussion, article..." }, "niveau": { "example": "grave, modéré, information ou neutre", "type": "line", "default": "neutre", "suggested": true, "description": " Définit la couleur du bandeau en fonction de sa gravité." }, "icône": { "description": "Icône associée au bandeau, fichier d'image ou image wikifiée.", "type": "string", "example": "attention", "aliases": [ "image" ] }, "alt": { "label": "Alternative textuelle", "type": "content", "description": "Alternative textuelle de l'image.", "aliases": [ "légende" ] }, "domaine public": { "description": "Définir ce paramètre à oui pour supprimer l'hyperlien sur l’icône (paramètre autorisé seulement si l’icône est dans le domaine public).", "example": "oui", "type": "string" }, "taille icône": { "description": "Change la taille de l’icône.", "example": "15", "type": "string", "default": "45x45" }, "texte": { "required": true, "suggested": true, "description": "Texte explicatif du bandeau", "example": "Cet article ne cite pas suffisamment ses sources.", "type": "content" }, "supplément": { "description": "Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit.", "example": "Une marche à suivre", "type": "content" }, "style": { "description": "Code CSS permettant de personnaliser le style du bandeau (largeur, couleur, taille de police...).", "type": "content" }, "id": { "description": "Affecte un identificateur au bandeau (correspond à l'attribut « id » en HTML)", "type": "string" }, "class": { "example": "noprint", "description": "Ajoute une class au bandeau.", "type": "string" }, "centrer": { "description": "Définir ce paramètre à oui pour centrer le bandeau.", "example": "oui", "type": "string" }, "droite": { "description": "Contenu à ajouter à droite du texte.", "type": "string" }, "icône bma": {

"description": "Définir ce paramètre à oui pour ajouter en haut à droite du bandeau une icône liant vers la page Aide:Bandeau (voir modèle

Si ce bandeau n'est plus pertinent, retirez-le. Cliquez pour voir d'autres modèles.

).",

"example": "oui", "type": "string" } }, "description": "Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux conformes à la charte graphique.", "format": "block", "paramOrder": [ "forme", "niveau", "class", "id", "style", "icône", "taille icône", "alt", "texte", "supplément", "centrer", "droite", "icône bma", "domaine public" ] } </templatedata>

Syntaxe

{{Méta bandeau
| forme  = article, discussion, système ou simple (facultatif, simple par défaut)
| niveau = grave, modéré, information ou neutre (facultatif, neutre par défaut)
| icône  = nom de l'image (facultatif)
| alt    = alternative textuelle de l'icône (obligatoire si icône est le nom d'une image)
| texte  = texte du bandeau (obligatoire)
}}

Paramètres principaux

  • forme : Définit la forme du bandeau (article à bord gauche plus épais, discussion à coins arrondis...) en fonction de l'utilisation prévue du bandeau.
  • niveau : Définit les couleurs du bandeau.
  • icône : Icône associée au bandeau. Cela peut être :
    • Le nom d'une image d'arrière-plan par défaut (voir la section exemple) ;
    • Le nom d'une image sera affiché au format 45x45px ;
    • Une ou plusieurs images complète pour un format personnalisé (déconseillé).
  • alt : alternative textuelle de l'image.
  • texte : texte explicatif du bandeau.

Paramètres supplémentaires

Ces paramètres sont présents pour répondre à un maximum de situation, mais leur utilisation est déconseillée.

  • 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é).
  • class : affecte une class au bandeau. Par exemple class = noprint désactivera l'affichage du bandeau lors de l'impression.
  • style : code CSS permettant de personnaliser le style du bandeau (largeur, couleur, taille de police...)
  • 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 le paramètre « texte », sans tenir compte du contenu fourni par le paramètre « supplément ».

Exemples

Les formes

Code Rendu
{{Méta bandeau
  | forme = simple <!-- valeur par défaut -->
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | forme = article
  | texte  = texte du bandeau.
 }}
texte du bandeau.
{{Méta bandeau
  | forme = discussion
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | forme = note
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | forme = section
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | forme = système
  | texte  = texte du bandeau.
 }}

Les niveaux

Code Rendu
{{Méta bandeau
  | niveau = aucun
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | niveau = neutre <!-- niveau par défaut -->
  | texte  = texte du bandeau.
 }}
{{Méta bandeau
  | niveau = detail
  | texte  = texte du bandeau.
}}
{{Méta bandeau
  | niveau = ebauche
  | texte  = texte du bandeau.
}}
{{Méta bandeau
  | niveau = information
  | texte  = texte du bandeau.
}}
{{Méta bandeau
  | niveau = modéré
  | texte  = texte du bandeau.
}}
{{Méta bandeau
  | niveau = grave
  | texte  = texte du bandeau.
}}

Les icônes

Dans le tableau ci-dessous, seul le contenu du paramètre icône est précisé. Le code complet utilisé pour la première ligne est :

{{Méta bandeau
  | icône = information
  | texte  = texte du bandeau.
 }}
contenu du paramètre icône Rendu
| icône = accessibilite
| icône = ADQ
| icône = archives
| icône = attention
| icône = BA
| icône = biblio
| icône = categorie
| icône = conflit
| icône = ebauche
| icône = engrenage
| icône = general
| icône = important
| icône = incomplet
| icône = information
| icône = loupe
| icône = outils
| icône = protection
| icône = protege
| icône = recyclage
| icône = semiprotection
| icône = sons
| icône = sources
| icône = stop
| icône = travaux
| icône = videos
| icône = Puppeter template.svg
| alt = icône représentant un faux-nez
| icône = <span style="white-space:nowrap;">[[Image:Merge-arrow.svg|32px|poubelle]] [[Image:Wikimedia Community Logo.svg|40px|Wikimedia]]</span>

Voir aussi