Modèl:Avançament/Documentacion

Aquò es la pagina de documentacion del Modèl:Avançament.
Aquesta pagina es pas destinada a èsser visualizada dirèctament. Los ligams qu'utilizan de pseudovariablas pòdon paréisser romputs (en roge) ; los remplacetz pas per de noms de paginas encodats en dur ni per d'URL.

Lo modèl {{Avançament}} permet d’afichar una barra de progression calibrada de 0 a 100 %, ideala per afichar :

los resultats d’un sondatge ;
l’estat d’avançament d'una traduccion ;
l’estat d’evaluacion dels articles d’un projècte ;
etc.

Se pòt utilizar aisidament dins un tablèu per apondre de comentaris, abans o aprèp lo modèl.

Utilizacion

Podètz plaçar aqueste modèl ont que siá, en utilizant las doas sintaxis seguentas.

Sintaxi simpla

La sintaxi simpla permet d’utilizar rapidament lo modèl. Los paramètres se devon especificar dins un òrdre precis.

{{Avançament|''avançament''|color|fons|barra|tèxt|alt|inv|inline}}

Consultatz los exemples d’utilizacion per comprene l’utilizacion d'aquela sintaxi.

Sintaxi complèxa

La sintaxi complèxa permet d’evitar l’utilizacion dels caractèrs « | » e se pòt que siá pus aisit de l’utilizar dins d'unes cases de barra de progression complèxes. En emplenant cada camp conegut (aprèp lo signe « = ») amb la valor adaptada. Sol lo primièr paramètre es obligatòri, los autres paramètres son opcionals e an una valor per defaut.

{{Avançament
| avançament=
| color=
| fons=
| barra=
| tèxt=
| alt=
| inv=
| inline=
}}

Paramètres

La significacion dels paramètres es la seguenta :

Paramètre	Descripcion	Tipe	Format
`avançament`	Avançament	Obligatòri	Numeric.
`color`	Color de la barra d’avançament. Per defaut la color de la barra d’avançament es en foncion del paramètre d’avançament (degradat de roge (0 %) a verd (100 %)).	Facultatiu	Color (ajuda).
`fons`	Estil del fons de la barra d’avançament. Per defaut « gris clar » amb una bordadura « gris escur ».	Facultatiu	Estil CSS.
`barra`	Estil de la barra d’avançament. La color deuriá pas èsser especificada aicí mas pel paramètre color. I poiriatz especificar un estil suplementari a la barra d’avançament (marges, bordaduras, etc).	Facultatiu	Estil CSS.
`tèxt`	Estil del tèxt afichat. Per defaut repren l'estil de tèxt de la seccion ont es inserit lo modèl.	Facultatiu	Estil CSS.
`alt`	Tèxte alternatiu. Per defaut aficha l’avançament seguit del signe « % »	Facultatiu	Cadena de caractèrs
`inv`	Degradat inversat. Passant del verd (0 %) al roge (100 %). Per defaut aficha lo degradat dins son òrdre « logic ».	Facultatiu	"1" per activar (vejatz exemples)
`inline`	Permet un afichatge integrat dins lo flux del tèxt (mòde d’afichatge CSS « inline »). Notatz qu'aquela opcion desactiva los estils definits per las barras d’avançament dins vòstre monobook CSS (vejatz personalizacion). L’utilizacion d'aquela opcion pòt balhar de resultats variables, o quitament inesperats sus d'unes navegadors.	Facultatiu	"1" per activar (vejatz exemples)

Degradats

Normal	Invèrs
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’utilizacion

Sintaxi simpla

{{Avançament|''avançament''|color|fons|barra|tèxt|alt|inv|inline}}

Barra simpla (degradat per defaut) :
- {{Avançament|25}}
  25%
- {{Avançament|46}}
  46%
- {{Avançament|77}}
  77%
Paramètre color de barra especificat :
- {{Avançament|75|lightgreen}}
  75%
- {{Avançament|75|#8080FF}}
  75%
Paramètre estil de fons especificat :
- {{Avançament|75||border:0;}}
  75%
- {{Avançament|75||background-color:yellow;}}
  75%
- {{Avançament|75||margin-top:10px;margin-bottom:10px;}}
  75%
Paramètre estil de la barra especificat :
- {{Avançament|75|||border-right:solid 2px red;}}
  75%
- {{Avançament|75|||border:solid 2px #FF8000;}}
  75%
Paramètre estil del tèxt especificat :
- {{Avançament|75||||font-weight:bold;}}
  75%
- {{Avançament|75||||color:red;}}
  75%
Paramètre tèxt alternatiu especificat :
- {{Avançament|25|||||¼ L}}
  ¼ L
- {{Avançament|70|||||En cors}}
  En cors
Paramètre d’inversion especificat :
- {{Avançament|25||||||1}}
  25%
- {{Avançament|75||||||1}}
  75%
Paramètre inline especificat :
- {{Avançament|50|||||||1}} Traduccion efectuada a ██████████50%
- {{Avançament|100|||||||1}} Soi d’acòrdi a ██████████100% !
Exemple d’utilizacion de paramètres multiples (estil del tèxt, estil de la barra e tèxt alternatiu especificats) :
- {{Avançament|50|||border:solid 1px black;|font-style:italic;|½ portion}}
  ½ portion

Sintaxi complèxa

{{Avançament
| avançament=
| color=
| fons=
| barra=
| tèxt=
| alt=
| inv=
| inline=
}}

Barra simpla (degradat per defaut) :
- {{Avançament|avançament=25}}
  25%
- {{Avançament|avançament=46}}
  46%
- {{Avançament|avançament=77}}
  77%
Paramètre color de barra especificat :
- {{Avançament|avançament=75|color=lightgreen}}
  75%
- {{Avançament|avançament=75|color=#8080FF}}
  75%
Paramètre estil de fons especificat :
- {{Avançament|avançament=75|fons=border:0;}}
  75%
- {{Avançament|avançament=75|fons=background-color:yellow;}}
  75%
- {{Avançament|avançament=75|fons=margin-top:10px;margin-bottom:10px;}}
  75%
Paramètre estil de la barra especificat :
- {{Avançament|avançament=75|barra=border-right:solid 2px red;}}
  75%
- {{Avançament|avançament=75|barra=border:solid 2px #FF8000;}}
  75%
Paramètre estil del tèxt especificat :
- {{Avançament|avançament=75|tèxt=font-weight:bold;}}
  75%
- {{Avançament|avançament=75|tèxt=color:red;}}
  75%
Paramètre tèxt alternatif especificat :
- {{Avançament|avançament=25|alt=¼ L}}
  ¼ L
- {{Avançament|avançament=70|alt=En cors}}
  En cors
Paramètre d’inversion especificat :
- {{Avançament|avançament=25|inv=1}}
  25%
- {{Avançament|avançament=75|inv=1}}
  75%
Paramètre inline especificat :
- {{Avançament|avançament=50|inline=1}} Traduccion efectuada a ██████████50%
- {{Avançament|avançament=100|inline=1}} Soi d’acòrdi a ██████████100% !
Exemple d’utilizacion de multiple paramètres (estil del tèxt, estil de la barra e tèxt alternatiu especificats) :
- {{Avançament|avançament=50|barra=border:solid 1px black;|tèxt=font-style:italic;|alt=½ portion}}
  ½ portion

Personalizacion

Aquel modèl tanben pòt èsser personalizable via lo monobook CSS gràcias a las doas classas seguentas :

.avanca_boita { }
.avanca_barra { }

Exemple d’utilizacion :

.avanca_boita
{
   width: 100px; // largor de la boita
   background-color: lightgray; // color del fons
   border: solid 1px gray; // estil, talha e color de la bordadura
}
.avanca_barra
{
   background-color: #A0FFA0; // color de la barra
   text-align: right; // alinhament del tèxt
   font-size: 100%; // talha del tèxt
   font-weight: bold; // espessor del tèxt
}

Notatz qu'aquela personalizacion es inutila dins lo cas de l’utilizacion del paramètre inline.

Vejatz tanben

{{Progression}}
{{0/4}}, {{1/4}}, {{2/4}}, {{3/4}}, {{4/4}}