Modèle:Bandeau/doc

Description

Le modèle Bandeau permet d'afficher des messages d'information mis en évidence avec une icône et des couleurs adaptées au type de message. Optimisé pour le skin Citizen avec support automatique des modes clair, sombre et automatique via la palette centralisée --nefald-* définie dans MediaWiki:Citizen.css.

Utilisation

Syntaxe de base

{{Bandeau|Votre message}}

Avec paramètres

{{Bandeau
|type=attention
|titre=Titre du bandeau
|Message du bandeau
}}

Paramètres

type

Type de bandeau qui détermine la couleur et l'icône par défaut. Voir la liste des types ci-dessous.

Optionnel, défaut : info

titre

Titre affiché en gras au-dessus du message principal.

Optionnel

icone

Nom de l'icône FontAwesome à utiliser (sans le préfixe "fa-"). Remplace l'icône par défaut du type.

Optionnel

1 (paramètre anonyme)

Le message principal à afficher dans le bandeau.

Requis

Types disponibles

Type	Variables CSS	Icône par défaut	Usage
info	--nefald-info-*	circle-info	Messages informatifs généraux
attention warning	--nefald-warning-*	triangle-exclamation	Avertissements, points d'attention
erreur error danger	--nefald-danger-*	circle-xmark	Erreurs, dangers, interdictions
succes success	--nefald-success-*	circle-check	Confirmations, opérations réussies
note	--nefald-neutral-*	note-sticky	Notes simples, remarques neutres
conseil tip	--nefald-tip-*	lightbulb	Conseils, astuces, recommandations
construction	--nefald-warning-*	hammer	Pages en construction, travaux en cours
important	--nefald-danger-*	star	Informations importantes à ne pas manquer
question	--nefald-question-*	circle-question	Questions, aide, interrogations
nouveau new	--nefald-success-*	sparkles	Nouvelles fonctionnalités, contenu récent
archive	--nefald-neutral-*	box-archive	Contenu archivé, obsolète

Exemples

Bandeau simple

{{Bandeau|Ceci est un message informatif simple}}

Ceci est un message informatif simple

Bandeau avec titre

{{Bandeau|type=attention|titre=Attention|N'oubliez pas de sauvegarder vos modifications}}

Attention

N'oubliez pas de sauvegarder vos modifications

Bandeau de succès

{{Bandeau|type=succes|titre=Opération réussie !|Votre page a été créée avec succès}}

Opération réussie !

Votre page a été créée avec succès

Bandeau avec icône personnalisée

{{Bandeau|type=info|icone=map|titre=Localisation|Consultez la carte pour plus de détails}}

Localisation

Consultez la carte pour plus de détails

Conseil pratique

{{Bandeau|type=conseil|titre=Astuce|Utilisez Ctrl+S pour sauvegarder rapidement}}

Astuce

Utilisez Ctrl+S pour sauvegarder rapidement

Page en construction

{{Bandeau|type=construction|titre=Travaux en cours|Cette page est actuellement en cours de rédaction}}

Travaux en cours

Cette page est actuellement en cours de rédaction

Message important

{{Bandeau|type=important|titre=À lire absolument|Les règles ont été modifiées le 15 janvier 2025}}

À lire absolument

Les règles ont été modifiées le 15 janvier 2025

Erreur ou danger

{{Bandeau|type=danger|titre=Action irréversible|Cette opération supprimera définitivement les données}}

Action irréversible

Cette opération supprimera définitivement les données

Question ou aide

{{Bandeau|type=question|titre=Besoin d'aide ?|Consultez la [[Aide:Sommaire|page d'aide]] pour plus d'informations}}

Besoin d'aide ?

Consultez la page d'aide pour plus d'informations

Nouveau contenu

{{Bandeau|type=nouveau|titre=Nouveauté|Cette fonctionnalité a été ajoutée le 20 janvier 2025}}

Nouveauté

Cette fonctionnalité a été ajoutée le 20 janvier 2025

Contenu archivé

{{Bandeau|type=archive|titre=Archivé|Ce guide concerne une ancienne version du serveur}}

Archivé

Ce guide concerne une ancienne version du serveur

Icônes FontAwesome

Le modèle utilise FontAwesome pour les icônes. Vous pouvez utiliser n'importe quelle icône disponible dans la bibliothèque.

Quelques exemples d'icônes populaires :

• book — Livre
• map — Carte
• shield — Bouclier
• users — Utilisateurs
• gear — Engrenage / paramètres
• rocket — Fusée
• heart — Cœur
• clock — Horloge
• download — Téléchargement
• upload — Upload

Consultez la liste complète des icônes gratuites pour plus d'options.

Caractéristiques techniques

• Palette centralisée : Les couleurs sont définies via les variables --nefald-* de MediaWiki:Citizen.css, jamais en dur dans le CSS du modèle.
• Thèmes automatiques : Le mode sombre (manuel ou système) est géré par la cascade CSS — aucun sélecteur [data-theme] nécessaire.
• Responsive : S'adapte automatiquement aux petits écrans.
• Accessibilité : Contraste suffisant en mode clair et sombre grâce aux valeurs OKLCH calibrées.
• Performance : Utilise TemplateStyles pour un chargement optimisé.
• Icône centrée : L'icône est alignée verticalement au centre du bandeau quelle que soit sa hauteur.

Bonnes pratiques

• Préférer type=conseil à un style inline violet — la variable --nefald-tip-* garantit la cohérence visuelle.
• Ne pas utiliser le paramètre icone pour changer la couleur : seul le paramètre type contrôle la palette.
• Tester le rendu en mode clair et sombre avant publication (Citizen → Apparence → Thème sombre).
• Les types construction et warning partagent la même palette --nefald-warning-* ; de même pour important et danger.

Voir aussi

• MediaWiki:Citizen.css — Palette --nefald-* centralisée
• Aide:Modèle — Guide d'utilisation des modèles