Plantilla:Barra composició
Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ] | Aquesta plantilla utilitza una crida a un mòdul de tipus Lua, nom que li ve del llenguatge Lua que utilitza. Per tant, si volguéssiu modificar-la, abans hauríeu d'estar familiaritzats amb aquest llenguatge i les funcions de l'extensió Scribunto. Vegeu com fer proves de plantilles.
Aquesta plantilla utilitza el següent mòdul: |
Descripció
[modifica]Plantilla per dibuixar una barra horitzontal.
Referit a la {{Barra escons}}:
- Afegeix una barra de transparència darrera el text si és necessari.
- Afegeix una línia de límit per la barra si el color és molt clar i seria difícil de distingir del color de fons.
|border=admetnonecom la versió anglesa
Nous paràmetres:
|lang=per a visualització amb idiomes diferents (per tal de visualitzar el format dels números i la direcció de la barra.|style=|txt_end=
En cas de faltar el primer o segon paràmetre:
{{Barra composició | |1500 |red |width=200}}dóna:cap valor / 1.500{{Barra composició |150 | |red |width=200}}dóna:150 / cap valor{{Barra composició |150 | |red |width=200 |per=1}}dóna:150 / cap valor{{Barra composició | | |red |width=200 |per=1}}dóna:cap valor
Detecció d'errors, per exemple:
{{Barra composició |200 |150 |red}}dóna:Error de Lua: #1 = 200 és major de 150.
Syntaxi
[modifica]En la determinació dels colors dels paràmetres següents és admès:
- nom de color HTML
- format #nnnnnn (notació RGB)
- rgb(0–255,0–255,0–255)
En la determinació de la mida en els paràmetres següents és admès:
- px, on si no s'especifica s'entén com a píxel
- em
- % en el cas de la mida del text.
Versió mínima
[modifica]{{Composition bar |1 |2 |3}}
- Descripció
Els paràmetres, tots OBLIGATORIS, són:
- 1: nombre de subunitats a representar.
- 2: nombre total de subunitats possibles.
- 3: color de la barra dibuixada.
Versió complerta
[modifica]{{Composition bar |1 |2 |3
|width=
|height=
|background-color=
|border-color=
|border-width=
|color=
|style=
|valuestyle=
|per=
|parenthesis=
|perstyle=
|round=
|nodivisor=
|void=
|lang=
|txt_end=
}}
- Descripció
Els 3 primers paràmetres obligatoris anteriors
- Opcionals
- width: llargada caixa. Per defecte, 100px
- height: alçada caixa. Per defecte, 1.5em
- background-color: color de fons de la caixa. Per defecte, #f0f0f0
- border-color: color del marc de la caixa. Per defecte, #c0c0c0
- border-width: gruix del marc de la caixa. Per defecte, 1px
- color: Color de la lletra. Per defecte, negra
- style: estil de text tant pels valors com pel percentatge. Llavors
|valuestyle=i|perstyle=complementen|style=si és defineix aquest últim.
{{Barra composició |1000 |1500 |red |nodivisor=true |style=font-size:85% |perstyle=color:blue |per=1}}dóna:1.000 / 1.500
- valuestyle: permet aplicar un format al text, més enllà del color. (ex: font-size:85%;)
- per: mostrar %. 0=no, 1=el % del paràmetre 1 sobre el 2, 2=el complement.
- parenthesis: Si s'informa (ex.:
parenthesis=n o no) oculta els parèntesis del percentatge. Per defecte, quan hi hagi % sortirà entre parèntesi. - perstyle: permet aplicar un format al text del %. (ex:font-size:85%;)
- round: nombre de decimals per fer l'arrodoniment. Per defecte és 1
- nodivisor: El format del text std. mostrat és valor/divisor (params. 1 i 2) per donar context de "quants en té d'entre quants disponibles". Quan no es vol mostrar el valor de referència o divisor, per exemple perquè ja es conegut o està informat fora de la barra, indicar
nodivisor=x. - void: evita mostrar el text valor/divisor (1 i 2). Només mostra la barra amb text valor/divisor; el percentatge es mostra o no si s'ha informat el paràmetre "per".
- lang: per a simulació en d'altres idiomes.
- txt_end: ajusta el text al final de la barra (que és l'esquerra en els idiomes de dreta a esquerra). Això facilita la lectura en una sèrie.
txt_end=true txt_end=false 10.000.000 / 15.000.000900.000 / 15.000.0005.000.000 / 15.000.00010.000.000 / 15.000.000900.000 / 15.000.0005.000.000 / 15.000.000
- above_text: posa les dades a sobre la barra envers de la barra, per imitació a la versió més estesa, d'altres Viquipèdies.
{{Barra composició |10000000 |15000000 |red |width=200 |height=10 |above_text=true |bold=false}}dóna:10.000.000 / 15.000.000 {{Barra composició |10000000 |15000000 |red |width=200 |height=10 |above_text=true |nodivisor=true |per=1}}dóna:10.000.000 / 15.000.000 {{Barra composició |10000000 |15000000 |red |width=200 |height=10 |above_text=true |nodivisor=true |per=1 |perstyle=color:blue}}dóna:10.000.000 / 15.000.000
Exemples
[modifica]Amb mida més petita
{{Barra composició |350 |630 |blue |height=16 |valuestyle=font-size:80%}}
|
350 / 630 |
Color barra en model de color RGB
{{Barra composició |150 |630 |rgb(152,237,152)}}
|
150 / 630 |
Color barra en colors HTML
{{Barra composició |150 |630 |#98FB98 |height=1.1em}}
|
150 / 630 |
Sense vora
{{Barra composició |150 |630 |#98FB98 |height=1.1em |border-color=none}}
|
150 / 630 |
Mostrar % dins caixa (paràmetre per)
{{Barra composició |150 |630 |#98FB98 |per=1 |perstyle=font-size:85%;color:red; |round=2 |width=200}}
|
150 / 630 |
Mostrar % complementari (paràmetre per)
{{Barra composició |150 |630 |#98FB98 |per=2 |perstyle=font-size:85%;color:blue; |width=200}}
|
150 / 630 |
Ample barra a elecció (paràmetre width)
{{Barra composició |150 |630 |#98FB98 |width=200}}
|
150 / 630 |
Color lletra a elecció (paràmetre color. Sense xifres a l'interior)
{{Barra composició |150 |630 |#98FB98 |width=200 |void=y}}
|
|
Color lletra a elecció (paràmetre color)
{{Barra composició |150 |630 |#98FB98 |width=200 |color=purple}}
|
150 / 630 |
Color fons caixa a elecció (paràmetre background-color)
{{Barra composició |350 |630 |green |width=200 |color=purple |background-color=yellow |nodivisor=y}}
|
350 / 630 |
Color marc caixa elecció (paràmetre border-color)
{{Barra composició |350 |630 |green |width=200 |color=purple |background-color=yellow |border-color=red}}
|
350 / 630 |
Gruix marc caixa elecció (paràmetre border-width)
{{Barra composició |350 |630 |green |width=200 |color=purple |background-color=yellow |border-color=red |border-width=3px}}
|
350 / 630 |
En diferents mides
[modifica]Mida de 10
{{Barra composició |150 |630 |blue |height=20 |width=300 |valuestyle=font-size:10px}}
|
150 / 630 |
Mida de 20
{{Barra composició |150 |630 |blue |height=40 |width=300 |valuestyle=font-size:20px}}
|
150 / 630 |
Mida de 40
{{Barra composició |150 |630 |blue |height=60 |width=300 |valuestyle=font-size:40px}}
|
150 / 630 |
Mida de 40
{{Barra composició |150000 |630000 |blue |height=60 |width=600 |valuestyle=font-size:40px}}
|
150.000 / 630.000 |
En altres idiomes
[modifica]{{Barra composició |30000 |51111 |red |lang=en}}
|
30,000 / 51,111 |
{{Barra composició |30000 |51111 |red |lang=ar}}
|
٣٠٬٠٠٠ / ٥١٬١١١ |
{{Barra composició |30000 |51111 |red |lang=he}}
|
30,000 / 51,111 |
Segons lluminositat del color
[modifica]| Lluminositat intermitja -> Opacitat 0.5: | |
{{Barra composició |30000 |51111 |red}}
|
30.000 / 51.111 |
{{Barra composició |3000000 |5000000 |#49fffe}}
|
3.000.000 / 5.000.000 |
| Colors foscos -> Opacitat 0.8: | |
{{Barra composició |1000000 |15000000 |blue}}
|
10.000.000 / 15.000.000 |
{{Barra composició |3000 |5000 |black}}
|
3.000 / 5.000 |
| En ser color molt lluminós, sols la ratlleta:
|
2.000.000 / 5.000.000 |
{{Barra composició |2000000 |5000000 |white}}
|
2.000.000 / 5.000.000 |
La documentació de més amunt està transclosa de Plantilla:Barra composició/ús. (modifica | historial)
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.