Plantilla:XCols

Icona de documentació de mòdul Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Plantilla per repartir i mostrar text en columnes:

  • Repartiment automàtic o manual de les línies. En el repartiment es prioritza que l'emplenament sigui segons l'ordre de la columna (així, per exemple, es descarta un repartiment en dues columnes, més ajustades per contingut, en que la segona columna estigués més plena que la primera).
  • Per tal de millorar la lectura el repartiment automàtic en columnes té en compte no trencar:
  • Les línies que contenen "sublínies". Així, les "sublínies" sempre estaran sota de la línia principal i, per tant, en la mateixa columna. Un exemple de línia amb "sublínies" seria:
Línia 1
  • Sublínia 1.1
  • Sublínia 1.2
  • Les agrupacions de línies (vegeu #Agrupant).
  • Pel grup de columnes: es pot definir amplada, encapçalament, peu, color de fons, alineació. L'alineació a dreta o esquerra permet que el text de l'article flueixi per l'altre costat.
  • Per a les columnes, es pot definir:
    • Que l'amplada de cadascuna sigui igual o ajustada al contingut.
    • La separació entre columnes.


SintaxiModifica

El mode més senzill és: {{#invoke:XCols|main|n_cols=|línies=
línia 1
línia 2
..
}}

On:

  • n_cols és el nombre de columnes (per defecte 1)


nom del paràmetre què fa
en anglès en català
lines línies Les línies, únic camp obligatori. Una línia que sigui "---" indica salt de columna manual. Si va seguida d'una mida (en px, em o %), aquesta indica la mida de l'amplada de la columna.
col_n n_cols Nombre de columnes. Es comprovarà que no hi hagi una línia "separadora" (que tingui de començament "---"), si hi és, es considerarà que és un salt de columna manual, llavors el nombre de columnes es calcularà pel nombre de línies "separadores".
width amplada Nombre. Màxim espai ocupat per les columnes. El número pot ser en px, em o %. Per defecte ocupa l'amplada segons l'amplada ocupada per les línies.
same_width id_amplada Booleà, Si és que sí, l'amplada de les columnes serà igual per a totes elles, independentment de l'amplada ocupada per les línies. Per defecte l'amplada depèn de l'amplada ocupada per les línies.
header encapçalament A dalt de les columnes, apareixerà en negreta i centrat.
footer peu A baix de les columnes.
h_align alineació_h Es pot determinar que s'alinei al centre/center, a la dreta/right o a l'esquerra/left. Només té efecte si l'amplada no és del 100%. Si s'alinea a dreta o esquerra, el text de l'article podrà fluir pel costat (com en una imatge inserida).
v_align alineació_v Per defecte s'alinea a dalt, però es pot determinar que s'alinei al centre/center o avall/bottom.
col_sep sep_cols Estableix els marges de separació del text entre les columnes. El número pot ser en px o em. Per defecte és 0.6em per costat de columna.
bg_color color_fons Color de fons. Per defecte és transparent.
free_header encapçalament_lliure A dalt de les columnes. És una alternativa a encapçalament. No té estil definit.
header_bg_color color_fons_encapçalament Color de fons de l'encapçalament. Per defecte és transparent o del color de fons.
footer_bg_color color_fons_peu Color de fons de l'encapçalament. Per defecte és transparent o del color de fons.


ExemplesModifica

Llistes puntejadesModifica

{{XCols|
n_cols = 2|
línies =
*[[Primer]]
*Segon
*Tercer
*Quart
*'''Cinquè'''
*{{color|red|Sisè}}
*Setè
}}
  • Cinquè
  • Sisè
  • Setè


Amb diferents nivellsModifica

{{XCols|
n_cols = 2|
línies =
*Primer
**A
***A1
***A2
**B
*Segon
*Tercer
*Quart
*Cinquè
*Sisè
*Setè
}}

  • Primer
    • A
      • A1
      • A2
    • B

  • Segon
  • Tercer
  • Quart
  • Cinquè
  • Sisè
  • Setè


En aquest exemple (degut a l'ús d'aquest mòdul) no se separen les "sublínies" de "Tercer", per millorar-ne la lectura.

{{XCols|
n_cols = 2|
línies =
*Primer

*Segon

*Tercer
**A
**B
**C

*Quart

*Cinquè

*Sisè

*Setè
}}
  • Primer
  • Segon
  • Tercer
    • A
    • B
    • C

  • Quart
  • Cinquè
  • Sisè
  • Setè


Això és el mateix que l'anterior, però realment, no fa falta posar les separacions:

{{XCols|
n_cols = 2|
línies =
*Primer
*Segon
*Tercer
**A
**B
**C
*Quart
*Cinquè
*Sisè
*Setè
}}
  • Primer
  • Segon
  • Tercer
    • A
    • B
    • C

  • Quart
  • Cinquè
  • Sisè
  • Setè


Observeu que si no es tingués en compte de no separar les "sublínies" (com fa aquest mòdul) es veuria així:

  • Primer
  • Segon
  • Tercer
    • A
    • B
    • C
  • Quart
  • Cinquè
  • Sisè
  • Setè

Amb pitjor lectura, tot i que les columnes serien més igualades.


Llista no puntejadaModifica

{{XCols|
n_cols = 3|
línies =
Primer
Segon
Tercer
Quart
Cinquè
Sisè
Setè
}}

Primer

Segon

Tercer

Quart

Cinquè

Sisè

Setè


Amb agrupació de líniesModifica

Fent tres grups de línies (primer en una sola columna):

{{XCols|
línies =
Primer
Segon

Tercer
Quart
Cinquè

Sisè
Setè
}}

Primer
Segon

Tercer
Quart
Cinquè

Sisè
Setè


Amb dues columnes:

{{XCols|
n_cols = 2|
línies =
Primer
Segon

Tercer
Quart
Cinquè

Sisè
Setè
}}

Primer
Segon

Tercer
Quart
Cinquè

Sisè
Setè



Llista amb salt de columna manualModifica

SenzillModifica

{{XCols|
línies =
Primer
Segon
---
Tercer
Quart
Cinquè
---
Sisè
Setè
}}

Primer

Segon

Tercer

Quart

Cinquè

Sisè

Setè


AgrupantModifica

{{XCols|
línies =
Primer
Segon

---
Tercer

Quart
Cinquè

---
Sisè
Setè
}}

Primer
Segon

Tercer

Quart
Cinquè

Sisè
Setè

Vegeu també: #Amb encapçalaments.


Alineació horitzontalModifica

{{XCols|
n_cols = 3|
alineació_h = centre|
línies =
Primer
Segon
Tercer
Quart
Cinquè
Sisè
Setè
}}

Primer

Segon

Tercer

Quart

Cinquè

Sisè

Setè


Alineació verticalModifica

{{XCols|
n_cols = 3|
alineació_v = centre|
línies =
Primer
Segon
Tercer
Quart
Cinquè
Sisè
Setè
}}

Primer

Segon

Tercer

Quart

Cinquè

Sisè

Setè


Text al costatModifica

No utilitzeu el text al costat per a més d'una o dues columnes.

{{XCols|
alineació_h = dreta|
línies =
---30px
[[File:Baseball bat (1904).jpg|30px]]
---100px
En el [[beisbol]], el '''[[bat de beisbol|bat]]''' és el bastó que es fa servir per colpejar la pilota llançada pel [[pitcher]] o llançador. El que utilitza el bat, s'anomena batedor, i forma part de l'equip ofensiu.
}}
{{lorem|3}}

Baseball bat (1904).jpg

En el beisbol, el bat és el bastó que es fa servir per colpejar la pilota llançada pel pitcher o llançador. El que utilitza el bat, s'anomena batedor, i forma part de l'equip ofensiu.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.


{{XCols|
alineació_h = esquerra|
n_cols = 2|
encapçalament = Explicació|
línies =
'''Primer'''
Nota

'''Segon'''
Nota 1
Nota 2
}}
{{lorem|2}}
Explicació

Primer
Nota

Segon
Nota 1
Nota 2

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.


Color de fonsModifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una
Dues
Tres
Quatre
}}

Una

Dues

Tres

Quatre


Llista no puntejada amb encapçalament i peuModifica

Estil predefinit de l'encapçalamentModifica

{{XCols|
n_cols = 3|
encapçalament = Encapçalament|
línies =
Primer
Segon
Tercer<ref>Referència al peu d'aquestes columnes</ref>
Quart
Cinquè
Sisè
Setè|
peu=<references/>
}}
Encapçalament

Primer

Segon

Tercer[1]

Quart

Cinquè

Sisè

Setè

  1. Referència al peu d'aquestes columnes


Estil d'encapçalament definit per l'usuariModifica

{{XCols|
n_cols = 3|
color_fons = Snow|
encapçalament_lliure = '''{{color|green|Encapçalament}}'''
<small>(amb una nota a sota, amb text petit)</small>|
color_fons_encapçalament = Lavender|
línies =
Primer
Segon
Tercer
Quart
Cinquè
Sisè
Setè|
peu = Aquesta és una nota al peu de les columnes|
color_fons_peu = Lavender|
}}
Encapçalament
(amb una nota a sota, amb text petit)

Primer

Segon

Tercer

Quart

Cinquè

Sisè

Setè

Aquesta és una nota al peu de les columnes


Modificant l'ampladaModifica

Amplada de les columnes proporcional al contingutModifica

{{XCols|
n_cols = 2|
amplada = 50%|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra
}}

Una línia, més o menys llarga

Altra


Amplada de les columnes proporcional a l'amplada totalModifica

{{XCols|
n_cols = 2|
amplada = 50%|
id_amplada = sí|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra
}}

Una línia, més o menys llarga

Altra


Modificant el marge de les columnesModifica

Sense modificarModifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra
}}

Una línia, més o menys llarga

Altra


Modificant-loModifica

{{XCols|
n_cols = 2|
sep_cols = 1.2em|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra
}}

Una línia, més o menys llarga

Altra


Línies heterogèniesModifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Amb la 1ª
També amb la 1ª

Altre

Final
}}

Una línia, més o menys llarga
Amb la 1ª
També amb la 1ª

Altre

Final


{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
:Amb la 1ª
:També amb la 1ª

Altre
*Altre 1
*Altre 2

;Final: I ja està
}}

Una línia, més o menys llarga

Amb la 1ª
També amb la 1ª

Altre

  • Altre 1
  • Altre 2

Final
I ja està


{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra

Tercera

Quarta
}}

Una línia, més o menys llarga
Altra

Tercera

Quarta


{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Una línia, més o menys llarga
Altra
}}

Una línia, més o menys llarga

Altra


{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
*Una línia, més o menys llarga
*Altra
}}
  • Una línia, més o menys llarga
  • Altra


Una línia massa llargaModifica

El problemaModifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Primer
Segon, amb un comentari que pot resultar massa llarg
Tercer
Quart
}}

Primer

Segon, amb un comentari que pot resultar massa llarg

Tercer

Quart


Solució 1Modifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Primer
Segon, amb un comentari<br>que pot resultar massa llarg
Tercer
Quart
}}

Primer

Segon, amb un comentari
que pot resultar massa llarg

Tercer

Quart


Solució 2Modifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
Primer

Segon, amb un comentari
que pot resultar massa llarg

Tercer

Quart
}}

Primer

Segon, amb un comentari
que pot resultar massa llarg

Tercer

Quart


Solució 3Modifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
amplada = 20%|
línies =
---80%
Primer
Segon, amb un comentari que pot resultar massa llarg
---20%
Tercer
Quart
}}

Primer

Segon, amb un comentari que pot resultar massa llarg

Tercer

Quart


Solució 4Modifica

{{XCols|
n_cols = 2|
color_fons = LightYellow|
línies =
---200px
Primer
Segon, amb un comentari que pot resultar massa llarg
---50px
Tercer
Quart
}}

Primer

Segon, amb un comentari que pot resultar massa llarg

Tercer

Quart


Amb encapçalamentsModifica

Rarament útil. Més que res per a llistes ordenades alfabèticament, i així permetent que apareguin en la taula de continguts; com en l'exemple:

Ciutats de Moldàvia
{{XCols
|alineació_h = centre
|n_cols = 4
|línies =
====A====
*[[Anenii Noi]]

====B====
*[[Basarabeasca]]
*[[Bălți]]
*[[Biruința]]
*[[Briceni]]
*[[Bucovăț]]

====C====
*[[Cahul]]
*[[Camenca]]
*[[Cantemir]]
*[[Căinari]]
*[[Călărași]]
*[[Căușeni]]
*[[Ceadîr-Lunga]]
*[[Chișinău]]
*[[Cimișlia]]
*[[Codru]]
*[[Comrat]]
*[[Cornești]]
*[[Costești]]
*[[Crasnoe]]
*[[Cricova]]
*[[Criuleni]]
*[[Cupcini]]

====D====
*[[Dnestrovsc]]
*[[Dondușeni]]
*[[Drochia]]
*[[Dubăsari]]
*[[Durlești]]

====E====
*[[Edineț]]

====F====
*[[Fălești]]
*[[Florești]]
*[[Frunză]]

====G====
*[[Ghindești]]
*[[Glodeni]]
*[[Grigoriopol]]

====H====
*[[Hîncești]]

====I====
*[[Ialoveni]]
*[[Iargara]]

====L====
*[[Leova (Moldàvia)|Leova]]
*[[Lipcani]]

====M====
*[[Maiac (Moldàvia)|Maiac]]
*[[Mărculești]]

====N====
*[[Nisporeni]]

====O====
*[[Ocnița]]
*[[Orhei]]
*[[Otaci]]

====R====
*[[Rezina]]
*[[Rîbnița]]
*[[Rîșcani]]

====S====
*[[Sîngera]]
*[[Sîngerei]]
*[[Slobozia]]
*[[Soroca]]
*[[Strășeni]]

====Ş====
*[[Șoldănești]]
*[[Ștefan Vodă]]

====T====
*[[Taraclia]]
*[[Telenești]]
*[[Bender|Tighina (Bender)]]
*[[Tiraspol]]
*[[Tiraspolul Nou]]
*[[Tvardița]]

====U====
*[[Ungheni]]

====V====
*[[Vadul lui Vodă]]
*[[Vatra]]
*[[Vulcănești]]
}}

A

B

C

D

E

F

G

H

I

L

M

N

O

R

S

Ş

T

U

V


Comparança XCols vs Llista de columnesModifica

Vegeu aquí

TemplateDataModifica

Plantilla per repartir i mostrar text en columnes

Paràmetres de la plantilla

Aquesta plantilla prefereix el format dels paràmetres en diferents línies.

ParàmetreDescripcióTipusEstat
Línieslínies lines

Les línies, únic camp obligatori. Una línia que sigui "---" indica salt de columna manual. Si va seguida d'una mida (en px, em o %), aquesta indica la mida de l'amplada de la columna.

Cadenaobligatori
Nombre de columnesn_cols col_n

Es comprovarà que no hi hagi una línia "separadora" (que tingui de començament --), si hi és es considerarà que és un salt de columna manual, llavors el nombre de columnes es calcularà pel nombre de línies "separadores".

Nombreopcional
Ampladaamplada width

Màxim espai ocupat per les columnes. El número pot ser en px, em o %. Per defecte ocupa l'amplada segons l'amplada de ocupada per les línies.

Líniaopcional
Alineació horitzontalalineació_h h_align

Es pot determinar que s'alinei al centre/center, a la dreta/right o a l'esquerra/left. Només té efecte si l'amplada no és del 100%. Si s'alinea a dreta o esquerra, el text de l'article podrà fluir pel costat (com en una imatge inserida).

Líniaopcional
Color de fonscolor_fons bg_color

Per defecte és transparent.

Líniaopcional
Columnes d'igual ampladaid_amplada same_width

Si és que sí, l'amplada de les columnes serà igual per a totes elles, independentment de l'amplada ocupada per les línies. Per defecte l'amplada depèn de l'amplada ocupada per les línies.

Booleàopcional
Text d'encapçalamentencapçalament header

A dalt de les columnes, apareixerà en negreta i centrat.

Líniaopcional
Text al peupeu footer

A baix de les columnes.

Líniaopcional
Separació de columnessep_cols col_sep

Estableix els marges de separació del text entre les columnes. El número pot ser en px o em. Per defecte és 0.6em per costat de columna.

Líniaopcional
Alineació verticalalineació_v v_align

Per defecte s'alinea a dalt, però es pot determinar que s'alinei al centre/center o avall/bottom.

Líniaopcional
Text d'encapçalament alternatiuencapçalament_lliure free_header

A dalt de les columnes. És una alternativa a encapçalament. No té estil definit.

Líniaopcional
Color de fons de l'encapçalamentcolor_fons_encapçalament header_bg_color

Per defecte és transparent o del color de fons.

Líniaopcional
Color de fons del peucolor_fons_peu footer_bg_color

Per defecte és transparent o del color de fons.

Líniaopcional

Plantilles de columnesModifica

Plantilla/es Partició de
columnes
Amplada de columnes Indicació Color de fons i
Separació entre columnes
{{XCols}}[a] Automàtic
o manual
Igual o
Personalitzable o
Ajustat al contingut
General
{{Div col}} - {{Div col end}} Automàtic Personalitzable
i igual per totes les columnes
No
{{Llista de columnes}}
{{Auto Columnes}} Llista de referències
{{Amaga Auto Columnes}}
{{Columns}} Manual Igual o

Si no es determina l'amplada global:
    ajustat al contingut

General
{{Columnes}} - {{Columna nova}} - {{Final columnes}} No
{{Col-begin}} - {{Col-break}} - {{Col-end}} Igual per totes les columnes o
diferent per a cada columna
(automàtica desaconsellable)
  1. Altres:
    • Utilitzable amb l'editor visual (TemplateData).
    • Encapçalament i peu de grup de columnes.
    • Alineació, amb text fluent a cada costat.