Modèle:Avancement

Documentation[voir] [modifier] [historique] [purger]

Le modèle {{Avancement}} permet d’afficher une barre de progression calibrée de 0 à 100 %, idéale pour afficher :

les résultats d’un sondage ;
l’état d’avancement d'une traduction ;
etc.

Il peut être utilisé dans un tableau pour ajouter des commentaires, avant ou après le modèle.

Utilisation

Vous pouvez placer ce modèle n’importe où, en utilisant les deux syntaxes suivantes.

Syntaxe simple

La syntaxe simple permet d’utiliser rapidement le modèle. Les paramètres doivent être spécifiés dans un ordre précis.

syntaxe minimale :

{{avancement|25}} donne :

25 %

{{avancement|40}} donne :

40 %

etc.

syntaxe simple :

{{avancement|''avancement''|couleur|fond|barre|texte|alt|inv|inline}}

Le paramètre avancement est un nombre de 0 à 100. Le séparateur décimal éventuel doit être un point au lieu de la virgule habituelle : n'écrivez pas ~~23,9~~ mais 23.9

Consultez les exemples d’utilisation pour comprendre l’utilisation de cette syntaxe.

Syntaxe complexe

La syntaxe complexe permet d’éviter l’utilisation des caractères « | » et peut s’avérer plus facile d’utilisation dans certains cas de barre de progression complexes. En remplissant chaque champ connu (après le signe « = ») avec la valeur adaptée. Seul le premier paramètre est obligatoire, les autres paramètres sont optionnels et ont une valeur par défaut.

{{Avancement
| avancement=
| couleur=
| fond=
| barre=
| texte=
| alt=
| inv=
| inline=
}}

Paramètres

La signification des paramètres est la suivante :

Paramètre	Description	Type	Format
`avancement`	Avancement	Obligatoire	Numérique.
`couleur`	Couleur de la barre d’avancement. Par défaut la couleur de la barre d’avancement est en fonction du paramètre d’avancement (dégradé de rouge (0 %) à vert (100 %)).	Facultatif	Couleur (aide).
`fond`	Style du fond de la barre d’avancement. Par défaut « gris clair » avec une bordure « grise foncée ».	Facultatif	Style CSS.
`barre`	Style de la barre d’avancement. La couleur ne devrait pas être spécifiée ici mais par le paramètre couleur. Vous pourriez y spécifier un style supplémentaire à la barre d’avancement (marges, bordures, etc).	Facultatif	Style CSS.
`texte`	Style du texte affiché. Par défaut reprend le style de texte de la section où est inséré le modèle.	Facultatif	Style CSS.
`alt`	Texte alternatif. Par défaut affiche l’avancement suivi du signe « % »	Facultatif	Chaîne de caractères
`inv`	Dégradé inversé. Passant du vert (0 %) au rouge (100 %). Par défaut affiche le dégradé dans son ordre « logique ».	Facultatif	"1" pour activer (voir exemples)
`inline`	Permet un affichage intégré dans le flux du texte (mode d’affichage CSS « inline »). Notez que cette option désactive les styles définis pour les barres d’avancement dans votre monobook CSS (voir personnalisation). L’utilisation de cette option peut donner des résultats variables, voire inattendus sur certains navigateurs.	Facultatif	"1" pour activer (voir exemples)

Dégradés

Normal	Inverse
5 % 10 % 15 % 20 % 25 % 30 % 35 % 40 % 45 % 50 % 55 % 60 % 65 % 70 % 75 % 80 % 85 % 90 % 95 % 100 %	5 % 10 % 15 % 20 % 25 % 30 % 35 % 40 % 45 % 50 % 55 % 60 % 65 % 70 % 75 % 80 % 85 % 90 % 95 % 100 %

Exemples d’utilisation

Syntaxe simple

{{Avancement|''avancement''|couleur|fond|barre|texte|alt|inv|inline}}

Barre simple (dégradé par défaut) :
- {{Avancement|25}}
  25 %
- {{Avancement|46}}
  46 %
- {{Avancement|77}}
  77 %
Paramètre couleur de barre spécifié :
- {{Avancement|75|lightgreen}}
  75 %
- {{Avancement|75|#8080FF}}
  75 %
Paramètre style de fond spécifié :
- {{Avancement|75||border:0;}}
  75 %
- {{Avancement|75||background-color:yellow;}}
  75 %
- {{Avancement|75||margin-top:10px;margin-bottom:10px;}}
  75 %
Paramètre style de la barre spécifié :
- {{Avancement|75|||border-right:solid 2px red;}}
  75 %
- {{Avancement|75|||border:solid 2px #FF8000;}}
  75 %
Paramètre style du texte spécifié :
- {{Avancement|75||||font-weight:bold;}}
  75 %
- {{Avancement|75||||color:red;}}
  75 %
Paramètre texte alternatif spécifié :
- {{Avancement|25|||||¼ L}}
  ¼ L
- {{Avancement|70|||||En cours}}
  En cours
Paramètre d’inversion spécifié :
- {{Avancement|25||||||1}}
  25 %
- {{Avancement|75||||||1}}
  75 %
Paramètre inline spécifié :
- {{Avancement|50|||||||1}} Traduction effectuée à ██████████50 %
- {{Avancement|100|||||||1}} Je suis d’accord à ██████████100 % !
Exemple d’utilisation de multiples paramètres (style du texte, style de la barre et texte alternatif spécifiés) :
- {{Avancement|50|||border:solid 1px black;|font-style:italic;|½ portion}}
  ½ portion

Syntaxe complexe

{{Avancement
| avancement=
| couleur=
| fond=
| barre=
| texte=
| alt=
| inv=
| inline=
}}

Barre simple (dégradé par défaut) :
- {{Avancement|avancement=25}}
  25 %
- {{Avancement|avancement=46}}
  46 %
- {{Avancement|avancement=77}}
  77 %
Paramètre couleur de barre spécifié :
- {{Avancement|avancement=75|couleur=lightgreen}}
  75 %
- {{Avancement|avancement=75|couleur=#8080FF}}
  75 %
Paramètre style de fond spécifié :
- {{Avancement|avancement=75|fond=border:0;}}
  75 %
- {{Avancement|avancement=75|fond=background-color:yellow;}}
  75 %
- {{Avancement|avancement=75|fond=margin-top:10px;margin-bottom:10px;}}
  75 %
Paramètre style de la barre spécifié :
- {{Avancement|avancement=75|barre=border-right:solid 2px red;}}
  75 %
- {{Avancement|avancement=75|barre=border:solid 2px #FF8000;}}
  75 %
Paramètre style du texte spécifié :
- {{Avancement|avancement=75|texte=font-weight:bold;}}
  75 %
- {{Avancement|avancement=75|texte=color:red;}}
  75 %
Paramètre texte alternatif spécifié :
- {{Avancement|avancement=25|alt=¼ L}}
  ¼ L
- {{Avancement|avancement=70|alt=En cours}}
  En cours
Paramètre d’inversion spécifié :
- {{Avancement|avancement=25|inv=1}}
  25 %
- {{Avancement|avancement=75|inv=1}}
  75 %
Paramètre inline spécifié :
- {{Avancement|avancement=50|inline=1}} Traduction effectuée à ██████████50 %
- {{Avancement|avancement=100|inline=1}} Je suis d’accord à ██████████100 % !
Exemple d’utilisation de multiple paramètres (style du texte, style de la barre et texte alternatif spécifiés) :
- {{Avancement|avancement=50|barre=border:solid 1px black;|texte=font-style:italic;|alt=½ portion}}
  ½ portion

Personnalisation

Ce modèle peut être également personnalisable via le monobook CSS grâce aux deux classes suivantes :

#avance_boite { }
#avance_barre { }

Exemple d’utilisation :

#avance_boite
{
   width: 100px; // largeur de la boite
   background-color: lightgray; // couleur du fond
   border: solid 1px gray; // style, taille et couleur de la bordure
}
#avance_barre
{
   background-color: #A0FFA0; // couleur de la barre
   text-align: right; // alignement du texte
   font-size: 100%; // taille du texte
   font-weight: bold; // epaisseur du texte
}

Notez que cette personnalisation est inutile dans le cas de l’utilisation du paramètre inline.

TemplateData

Affiche une barre de progression calibrée de 0 à 100 %.

Paramètres du modèle[Modifier les données du modèle]
La mise en forme sur une seule ligne est préférée pour ce modèle.
Paramètre		Description	Type	État
Avancement	`avancement` `1`	Avancement en pourcentage Exemple 42	Nombre	obligatoire
Texte de remplacement	`alt` `6`	Permet de mettre un texte autre que le signe « % ». Par défaut % Exemple alt=½ portion	Ligne de texte	facultatif
Couleur	`couleur` `2`	Couleur de la barre d’avancement. Par défaut Dégradé de rouge (0 %) à vert (100 %). Exemple lightgreen	Ligne de texte	facultatif
Inversé	`inv` `7`	Inverse le dégradé. Passant du vert (0 %) au rouge (100 %). Laisser vide pour inverser le dégradé. Par défaut 1 Valeur automatique	Ligne de texte	facultatif
Fond	`fond` `3`	Style du fond de la barre d’avancement. Par défaut « gris clair » avec une bordure « grise foncée » Exemple border:0	Ligne de texte	facultatif
Texte	`texte` `5`	Style du texte affiché. Par défaut reprend le style de texte de la section où est inséré le modèle. Exemple texte=font-weight:bold	Ligne de texte	facultatif
Style	`barre` `4`	Style de la barre d’avancement. La couleur ne devrait pas être spécifiée ici mais par le paramètre couleur. Vous pourriez y spécifier un style supplémentaire à la barre d’avancement (marges, bordures, etc). Exemple border-right:solid 2px	Ligne de texte	facultatif
Inline	`inline` `8`	Permet un affichage intégré dans le flux du texte (mode d’affichage CSS « inline »). Notez que cette option désactive les styles définis pour les barres d’avancement dans votre monobook CSS.. L’utilisation de cette option peut donner des résultats variables, voire inattendus sur certains navigateurs. Valeurs suggérées `1`	Ligne de texte	facultatif

Voir aussi

La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.