Introduzione alle tabelle

PmWiki accetta due tipi di markup per creare tabelle. Il markup descritto in questa pagina serve a creare tabelle con molte celle di piccole dimensioni; le direttive per tabelle, invece, sono utili per tabelle di grandi dimensioni.

Per creare una tabella si usano due barre verticali: ||. Le linee che iniziano con questo markup indicano righe di una tabella; all’interno di tali linee, le due barre verticali sono utilizzate per delimitare le celle. Negli esempi che seguono è aggiunto un bordo per mostrare meglio l’effetto (di default non viene disegnato nessun bordo).

|| border=1
|| cella 1 || cella 2 || cella 3 ||
|| cella 1 || cella 2 || cella 3 ||

È possibile creare celle di intestazione, inserendo ! come primo carattere nel testo della cella. Esiste un solo livello di intestazione per tabelle, quindi non ha senso usare !!, !!! ecc.

|| border=1
||! cella 1 ||! cella 2 ||! cella 3 ||
|| cella 1  ||  cella 2 ||  cella 3 ||

Una tabella può avere una didascalia, indicata così: ||!didascalia!||. Le didascalie devono essere inserite prima delle righe della tabella.

|| border=1
||! Una tabella speciale !||
||! cella 1 ||! cella 2 ||! cella 3 ||
|| cella 1  ||  cella 2 ||  cella 3 ||

Formattazione del contenuto

Il contenuto delle celle può essere allineato a sinistra, al centro o a destra.

• Per allineare il contenuto a sinistra, inserirlo subito dopo le prime ||.
• Per centrare il contenuto, lasciare uno spazio dopo prima e dopo di esso.
• Per allineare il contenuto a destra, lasciare uno spazio dopo le prime || e nessuno spazio dopo il contenuto.

|| border=1 width=100%
||!cella 1      ||! cella 2  ||!       cella 3||
||sinistra || centro || destra||

|| border=1 width=100%
||!default||!sinistra ||
||default||sinistra ||

Si noti che l’allineamento di default è diverso per le celle di intestazione.

Per far sì che una cella comprenda più colonne, farla seguire da celle vuote. (Attualmente non è possibile che una cella comprenda più righe).

|| border=1 width=100%
|| |||| colonna destra ||
|| || colonna centrale ||||
|| colonna sinistra ||||||
|| colonna sinistra || colonna centrale || colonna destra ||

Attributi delle tabelle

Una linea che inizi per || e non sia chiusa da altre || imposta gli attributi per tutte le tabelle che seguono. Questi attributi possono controllare la dimensione e la posizione della tabella, i bordi, il colore di sfondo e la spaziatura tra le celle. (Di fatto, questi sono solo attributi HTML standard che vengono inseriti nel tag <table>).

L’attributo width= imposta la larghezza di una tabella, che può essere specificata con un valore percentuale, una dimensione assoluta oppure *.

|| border=1 width=100% 
|| cella 1 || cella 2 || cella 3 ||
|| c1 || cellacellacellacella2 || cella 3 ||

L’attributo border= definisce la dimensione dei bordi di una tabella.

|| border=10 width=70%
||!cella 1      ||! cella 2  ||!      
cella 3||
||sinistra || centro || destra||

|| border=0 width=70%
||!cella 1      ||! cella 2  ||!      
cella 3||
||sinistra || centro || destra||

Gli attributi align=center, align=left e align=right allineano la tabella rispettivamente al centro, a sinistra e a destra. Si noti che align=left e align=right creano una tabella flottante, tale che il testo le scorra intorno.

|| border=1 align=center width=70%
||!cella 1      ||! cella 2  ||!      
cella 3||
||sinistra || centro || destra||
Si noti come il testo non scorra intorno
a una tabella allineata al centro.

|| border=1 align=left width=70%
||!cella 1      ||! cella 2  ||!      
cella 3||
||sinistra || centro || destra||
Si noti come il testo scorra intorno a
una tabella allineata a sinistra.

|| border=1 align=right width=70%
||!cella 1      ||! cella 2  ||!      
cella 3||
||sinistra || centro || destra||
Si noti come il testo scorra intorno a
una tabella allineata a destra.

Nota: per far sì che una tabella sia allineata a sinistra, senza essere “flottante”, bisogna usare attributi CSS, come

L’attributo bgcolor= imposta il colore di sfondo per una tabella.

|| border=1 align=center bgcolor=yellow
width=70%
||!cella 1    ||! cella 2 ||!     cella
3||
||sinistra || centro  || destra||

Altri esempi

%define=sp padding-right:1em font-weight:bold%
|| border=1
|| [++Calendario eventi++] ||||||||||
|| '''Maggio 2005''' || '''Giugno 2005''' || '''Luglio 2005''' || '''Agosto
2005''' || '''Settembre 2005''' ||
||%sp%'''10'''%%6:30 - 8:30 Grande riunione\\\
%sp%'''17'''%%7:00 - 8:30 Riunione più grande\\\
%sp%'''24'''%%7:00 - 8:30 Riunione grandissima|| || || || ||
|| '''Ottobre 2005''' || '''Novembre 2005''' || '''Dicembre 2005''' ||
'''Gennaio 2006''' || '''Febbraio 2006''' ||
|| || || || || ||

|| border=1 rules=rows frame=hsides
|| cella 1 || cella 2 || cella 3 ||
|| cella 1 || cella 2 || cella 3 ||

|| border=1 rules=cols frame=vsides
||! cella 1 ||! cella 2 ||! cella 3 ||
|| cella 1  ||  cella 2 ||  cella 3 ||