Tabeldirektiver

Der er seks direktiver til tabelbehandling. Alle skal være i starten af en linje for at have nogen virkning.

(:table [attr...]:)

Genererer et nyt HTML <table>-mærke med attributterne angivet i attr.... Lukker den foregående tabel, hvis der var nogen. Gyldige attributværdier er:

• border (et positivt heltal)
• bordercolor (et farvenavn eller et hexadecimalt tal; vises ikke i alle browsere)
• cellspacing (et positivt heltal, der angiver afstanden mellem celler)
• cellpadding (et positivt heltal, der angiver en celles interne ramme)
• width (et positivt heltal, eller en procent)
• bgcolor (et farvenavn eller et hexadecimalt tal)
• align (left, center eller right)
• summary (vises ikke; primært brugt til at hjælpe synshandicappede til at navigere)

(:cellnr [attr...]:), (:cell [attr...]:), (:headnr [attr...]:), (:head [attr...]:)

• Direktivet (:head:) åbner en ny "overskriftcelle" i tabellen (laver et <th>-mærke i HTML).
• Direktivet (:cell:) åbner en ny "almindelig celle" i tabellen (laver et <td>-mærke i HTML).
• Direktiverne (:headnr:) og (:cellnr:) åbner en ny celle på en ny række i tabellen.

Disse direktiver lukker en foregående celle og/eller række. Bemærk at direktiverne (:head:) og (:headnr:) findes i PmWiki version 2.2.11 eller nyere.

Gyldige attributter og værdier er:

• align (left, center eller right)
• valign (top, midten eller bund) * standard er "top", se note herunder
• colspan (et positivt heltal)
• rowspan (et positivt heltal)
• bgcolor (et farvenavn eller et hexadecimalt tal)
• width (et positivt heltal, eller en procent)
• class (en CSS-klasse for cellen)
• style (brugerdefineret CSS-typografi for cellen)

(:tableend:)

Lukker den foregående tabelcelle og lukker en evt. tabel. Genererer nødvendige </th>, </td>, </tr>, og </table>-mærker.

* attibutten valign

Hvis ikke den allerede er indstillet, vil PmWiki inkludere attributten valign='top' sammen med alle (:cell[nr]:) og (:head[nr]:). Pm sagde "Tabeldirektiver blev lavet med det formål at kunne lave layout, og i det tilfælde giver det mest mening at hver celle (kolonne) har sit eget indhold i toppen af rækken. Attributten sættes i hver celle, og ikke i hver række, fordi nogle browsere ikke genkendte valign='top' i række-mærket."

Se $EnableTableAutoValignTop for hvordan man deaktiverer den automatiske inkludering af attributten.

Noter

Til table-, cell- og cellnr-mærkerne kan forfatteren angive alle attributer som ville være gyldige i HTML-mærkerne <table> eller <td>. Du kan derfor angive argumenter for rowspan, colspan, osv, for at opbygge vilkårlige tabeller. Det er dog ikke muligt at have et (:table:) inden i et (:cell:) eller (:cellnr:) -- det næste afsnit forklarer hvorfor.

Mange spørger sikkert hvorfor vi ikke blot brugte den almindelige HTML tabelopmærkning (<table>, <tr>, <td>, <th>) i stedet for at lave ny opmærkning, og tillade tabeller inden i tabeller, som et resultat deraf. Der er to svar: først, HTML tabelopmærkningen er meget grim for naive forfattere (se PmWiki.Audiences og PmWikiPhilosophy #2), og for det andet ville det være meget nemt for forfattere at lave tabeller der er forkert HTML, og som vises forkert (eller slet ikke) i nogle browsere. Selv øvede web-professionelle laver nogle gange forkert tabelopmærkning, så det er en smule urealistisk at forvente at den gennemsnitlige forfatter altid gør det rigtigt, eller være i stand til at læse vilkårlig HTML-opmærkning som en anden har lavet.

Det er svært at skrive den kode der skal til for at få PmWiki til at forstå og fikse vilkårlig tabelopmærkning, så PmWiki bruger den forenklede version herover. Den version er dog i stand til at håndtere de fleste krav til tabeller (med den mulige undtagelse af tabeller i tabeller).

Det betyder ikke at HTML-'tabeller i tabeller' er umulige i PmWiki - de kan bare ikke laves særligt nemt af wikiforfattere ved brug af standard wikiopmærkning. En webstedsadministrator kan selvfølgelig lave hoved/fod-HTML-kode, og andre lokale tilpasninger, som gør brug af tabeller i tabeller.

Eksempel 1. En tabel med opmærkning med tabeldirektiver.

" " er et mellemrum der ikke ombryder linjen i HTML. Placer det i en celle hvis cellen skal være tom, ellers bliver cellens ramme ikke tegnet rigtigt.

(:table border=1 cellpadding=5 cellspacing=0:)
(:head:) a1
(:cell:) b1
(:cell:) c1
(:cell:) d1
(:headnr:) a2
(:cell:) b2
(:cell:) c2
(:cell:)  
(:tableend:)

I HTML er det det samme som

<table border='1' cellpadding='5' cellspacing='0'>
  <tr>
    <th>a1</th>
    <td>b1</td>
    <td>c1</td>
    <td>d1</td>
  </tr>
  <tr>
    <th>a2</th>
    <td>b2</td>
    <td>c2</td>
    <td>&nbsp;</td>
  </tr>
</table>

Flydende tabel med navigationsliste af punktliste

Hvad hvis du ville lave en fin lille tabel, som en indholdsfortegnelse, i en side som denne? I dette eksempel, flyder tabellen til højre, og indeholder nogle links i en punkliste. Dette er en fin demonstration af hvordan det er muligt at opbygge en lille indholdsfortegnelse i siden, som måske kun navigerer til andre sider kun inden for den samme wikigruppe. Bemærk at det at have en punktliste ikke vil virke i en almindelig tabel - det virker kun i en tabel lavet med tabeldirektiver, som eksempelkoden her.

(:table border=1 width=30% align=right bgcolor=#cccc99 cellspacing=0 :)
(:cellnr:)
'''Navigationslinks'''
(:cellnr:)
*[[Tables|Tabeller]]
*[[TableDirectives|Tabeldirektiver]]
(:tableend:)

(:table border=1 width=30% align=right bgcolor=#cccc99 cellspacing=0 :)
(:cellnr colspan=2 align=center:)
'''Navigationslinks'''
(:cellnr align=center:)
[[Tables|Tabeller]]
(:cell align=center:)
[[TableDirectives|Tabeldirektiver]]
(:tableend:)

Bemærk at vi har brugt en #cccc99 hexadecimal farve til tabelbaggrunden. Bemærk også at opmærkningen (:cellnr:) laver en ny række, en ny celle, og lukker rækken i enden.

Du kan strække dette koncept videre: hvis du vil have hver side i gruppen til at indeholde den samme indholdsfortegnelse, kan du lave EN tabel som den ovenover og putte den på sin egen side. Brug derefter en include på enhver af dine sider, for at benytte tabellen. Den flydende (justerede) egenskab vil blive benyttet på hver side hvor den er inkluderet.