Einfache Tabellen

für die Liste aller Seiten

Bei PmWiki gibt es zwei Arten von Formatierungsanweisungen für Tabellen. Die auf dieser Seite beschriebene Syntax ist nützlich, um einfache Tabellen mit vielen kleinen Zellen zu erzeugen. Die zweite verfügbare Syntax ist für größere Tabellen oder Tabellen mit mit komplexen Zellinhalten geeignet. Weitere Möglichkeiten, einfache Tabellen zu formatieren, finden sich in den Kochbuch-Rezepten Cookbook:RowspanInSimpleTables und Cookbook:FormattingTables (nur auf Englisch verfügbar).

Grundlagen zu Tabellen

Einfache Tabellen werden mit Hilfe des doppelten 'pipe'-Zeichens || definiert. (Auf deutschen Tastaturen befindet sich das 'pipe'-Zeichen in der Regel links unten auf der Taste mit den Zeichen '<' und '>'. Das 'pipe'-Zeichen lässt sich unter Windows oder Linux normalerweise durch gleichzeitiges Drücken der <AltGr>-Taste und der '<'-Taste erzeugen. Macintosh Nutzer verwenden Wahltaste+7.). Zeilen, die mit || beginnen, zeigen den Beginn einer Tabellenzeile an. Das Auftreten von || innerhalb einer Zeile markiert den Beginn einer neuen Tabellenzelle. Nachfolgende Tabelle enthält zur besseren Sichtbarkeit einen Rand (standardmäßig ist kein Rand sichtbar).

Die erste Zeile im Markup (doppelte senkrechte Striche "||" am Zeilenanfang) ist erforderlich. Nach den Zeichen "||" können Formatierungskommandos für die Tabelle folgen, z. B. border oder width.

|| border=1
|| Zelle 1 || Zelle 2 || Zelle 3 ||
|| Zelle 1 || Zelle 2 || Zelle 3 ||

Kopfzellen können gebildet werden, indem man ! als erstes Zeichen einer Zelle eingibt. Dies sind Tabellenköpfe, keine Überschriften, sodass !! und !!! keine Wirkung haben!

|| border=1
||! Zelle 1 ||! Zelle 2 ||! Zelle 3 ||
||  Zelle 1 ||  Zelle 2 ||  Zelle 3 ||

Tabellen können eine Beschriftung besitzen: ||!Beschriftung!||. Jede Beschriftung muss vor den anderen Zeilen der Tabelle eingefügt werden.

|| border=1
||! Eine besondere Tabelle !||
||! Zelle 1 ||! Zelle 2 ||! Zelle 3 ||
||  Zelle 1 ||  Zelle 2 ||  Zelle 3 ||

Formatierung von Zellinhalten

Zellinhalte dürfen links-, rechtsbündig oder zentriert sein.

• Um Inhalte nach links auszurichten, wird der Zelleninhalt ohne Leerzeichen direkt rechts neben das führende || geschrieben.
• Um Inhalte zu zentrieren, wird jeweils ein Leerzeichen vor und nach dem Zelleninhalt gesetzt.
• Für die rechtsbündige Ausrichtung wird der Zelleninhalt ohne Leerzeichen direkt links neben das folgende || gestellt, wobei vor dem Zelleninhalt ein Leerzeichen eingetippt wird.

|| border=1 width=100%
||!Zelle 1      ||! Zelle 2  ||!     Zelle 3||
||linksbündig   || zentriert || rechtsbündig||

|| border=1 width=100%
||!Zelle standard||!Zelle links ||
||bündig nach Standard||linksbündig ||

Es sei bemerkt, dass die Kopfzellen und die Einzelzellen verschiedene Voreinstellungen haben.

Eine Zelle überspannt mehrere Spalten, wenn der Zelle weitere leere Zellen folgen. (Zur Zeit existiert keine Syntax für das Überspannen von Zeilen.)

|| border=1 width=100%
|| linke Spalte || mittlere Spalte || rechte Spalte ||
|| überspannt zwei Spalten (links und mitte) |||| rechte Spalte ||
|| linke Spalte || überspannt zwei Spalten (mitte und rechts) ||||
|| überspannt die komplette Zeile ||||||

Tabelleneigenschaften

Jede Zeile, welche mit || beginnt, aber nicht mit || endet, setzt die Tabelleneigenschaften für jede der folgenden Tabellen. Diese Eigenschaften können Größe, Position, Rahmen, Hintergrundfarbe und die Zellenabstände in der Tabelle bestimmen. (Tatsächlich handelt es sich hier nur um die in den <table> Ausdruck gesetzten Standard-HTML-Eigenschaften.)

Mit dem width=-Attribut (in Prozent, als absoluter Wert oder als *) wird die Tabellenweite festgelegt.

Siehe auch $SimpleTableDefaultClassName.

|| border=1 width=100% 
|| Zelle 1 || Zelle 2 || Zelle 3 ||
|| z1 || zellezellezellezelle2 || zelle 3 ||
|| border=1 width=400px 
|| Zelle 1 || Zelle 2 || Zelle 3 ||
|| z1 || zellezellezellezelle2 || zelle 3 ||
|| border=1 width=* 
|| Zelle 1 || Zelle 2 || Zelle 3 ||
|| z1 || zellezellezellezelle2 || zelle 3 ||

Das border=-Attribut setzt die Größe der Tabellenränder.

|| border=10 width=70% 
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||

|| border=0 width=70%
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||

Mit align=center, align=left, and align=right wird die Tabelle links-, rechtsbündig oder zentriert ausgerichtet. align=left und align=right erzeugen eine fließende (floating) Tabelle, so dass der Text um die Tabelle herumfließt.

|| border=1 align=center width=70%
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||
Eine mit [@align=center@] ausgerichtete Tabelle wird nicht vom Text umflossen.

|| border=1 align=left width=70%
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||
Der Text fließt rechts um die links ausgerichtete Tabelle.

|| border=1 align=right width=70%
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||
Der Text fließt links um die rechts ausgerichtete Tabelle.

Zu beachten ist, dass man CSS benötigt, um eine Tabelle zwar linksbündig auszurichten, aber als nicht-fließendes Element festzulegen.

Das bgcolor=-Attribute legt die Hintergrundfarbe fest. Im Moment können keine individuellen Farben für Zeilen oder Spalten in einer Tabelle festgelegt werden (siehe aber auch das Kochbuch-Rezept Cookbook:FormattingSimpleTables (nur auf Englisch verfügbar)).

|| border=1 align=center bgcolor=yellow
||!Zelle 1      ||! Zelle 2  ||!       Zelle 3||
||linksbündig || zentriert || rechtsbündig||

Weitere Beispiele

%define=sp padding-right:1em font-weight:bold%
|| border=1
|| [++Events Calendar++] ||||||||||
|| '''May 2005''' || '''June 2005''' || '''July 2005''' || '''August 2005''' || '''September 2005''' ||
||%sp%'''10'''%%6:30 - 8:30 Big Meeting[[<<]][[<<]]%sp%'''17'''%%7:00 - 8:30 Bigger Meeting[[<<]][[<<]]%sp%'''24'''%%7:00 - 8:30 Biggest Meeting|| || || || ||
|| '''October 2005''' || '''November 2005''' || '''December 2005''' || '''January 2006''' || '''February 2006''' ||
|| || || || || ||

Sortierbare Tabellen

Um Besuchern die Möglichkeit zu geben, eine Tabelle umzusortieren, geben Sie ihr das Attribut class="sortable":

|| class="sortable simpletable"
||!   m||!Geographic zone     ||!Highest point     ||!Country  ||
|| 3700||Arctic               ||Gunnbjørn Fjeld    ||Greenland ||
|| 8848||North Temperate Zone ||Mount Everest      ||Nepal     ||
|| 5790||North Tropical Zone  ||Cayambe            ||Ecuador   ||
|| 6768||South Tropical Zone  ||Huáscarán          ||Peru      ||
|| 6960||South Temperate Zone ||Aconcagua          ||Argentina ||
|| 4892||Antarctic            ||Mount Vinson       ||(none)    ||

Bemerkung:

• Diese Möglichkeit muss in der lokalen Konfiguration aktiviert werden, siehe $EnableSortable. Es funktioniert dann sowohl mit einfachen Tabellen wie oben als auch mit Tabellendirektiven mit dem class="sortable"-Attribut.
• Die optionale "simpletable"-Klasse ist im Standard-Skin und möglicherweise auch in anderen Skins verfügbar, sie sollte vernünftige Style für einfache Tabellen definieren.
• Die erste Zeile der Tabelle muss Kopfzellen mit ||!-Separatoren enthalten, die zum Sortieren der Zeilen nach dieser Spalte angeklickt werden können.
• Soll die letzte Zeile Ihrer Tabelle eine Fußzeile sein, die nicht sortiert werden soll, so benutzen Sie die Klasse "sortable-footer" anstatt "sortable". Wenn Sie ||!-Separatoren in der Fußzeile benutzen, kann diese Fußzeile zum Sortieren der Zeilen benutzt werden wie die Kopfzeile.

Datentypen: Per Voreinstellung werden die Zeilen numerisch sortiert, wenn die Zeilen unformatierte numerische Werte enthalten, sonst alphabetisch. Sie können den zu sortierenden Datentyp einer Spalte definieren, indem Sie der Kopfzeilenzelle ein leeres Wikistile-Element hinzufügen:

• %sort-numeric-us%%% – die Zellen der Spalte enthalten US-formatierte Zahlen wie 1,234.56.
• %sort-date%%% – die Zellen der Spalte enthalten SI-formatierte Zahlen wie 1 234,56.
• %sort-date%%% – die Zellen der Spalte enthalten ein Datum oder eine Datum-Zeit, das/die vom Browser analysiert wird. Daten wie "2023-11-19" oder "2023-11-19 14:09:11" sollten korrekt erkannt werden, andere Daten in Englisch könnten korrekt erkannt werden oder auch nicht.
• %sort-time%%% – die Zellen der Spalte enthalten ein <time datetime="..."></time> Element, dessen "datetime"-Wert soll zum Sortieren benutzt werden. Markup wie @2022-01-08T10:07:08Z oder {(ftime "%L" "{*$LastModifiedTime}")} würde ein <time>-Element in der Zeitzone des Besuchers ausgeben mit mehr oder weniger Präzision, abhängig von $EnableLocalTimes, doch die "datetime"-Attribute sollten zu präziser Sortierung führen.

FAQ

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

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

||border="1" cellpadding="10" style="border-collapse:collapse" width=66%
||!Spalte 1 ||! Spalte 2 ||!  Spalte 3||
||Zellen   ||  mit     || 'Padding'||
||und      || dünnen   ||    Linien||

für die Liste aller Seiten