Vorlage:SortKeyColspan/Doku

Fehler beim Erstellen des Vorschaubildes: Datei fehlt

Diese Seite ist die Dokumentations-Unterseite der Vorlage:SortKeyColspan.

Diese Vorlage dient dazu in sortierbaren Tabellen Zellen in einer Zeile spaltenweise miteinander zu verbinden (Attribut colspan des td-Elements).

Dabei sind einige Einschränkungen zu beachten:

• Die zu verbindenden Spalten müssen eine feste Breite haben

  Empfehlung: Auch wenn das eigentlich nicht notwendig ist, sollten den betroffenen Spalten im Tabellenkopf mit Hilfe der CSS-Eigenschaften min-width und max-width eine feste Breite zugewiesen werden.

• Die Vorlage unterstützt maximal zehn miteinander zu verbindende Spalten

  Benötigst du mehr Spalten stellt das kein Problem dar, melde dich hierfür einfach auf der Diskussionsseite.

• Bei einer veränderten Benutzeroberfläche (Stil) kann es in sehr seltenen Fällen zu einer fehlerhaften Darstellung kommen

  Der Standardstil Vector, die mobile Ansicht sowie alle in den Einstellungen verfügbaren Stile (Einstellungen → Aussehen → Benutzeroberfläche) funktionieren problemlos und ohne jegliche Einschränkungen. Wird die in der Wikipedia übliche CSS-Klasse wikitable für Tabellen verwendet sind Probleme eigentlich so gut wie ausgeschlossen. Hast du Probleme versuche es zunächst damit. Dennoch, in einigen wenigen und eher exotischen Konfigurationen, verursacht entweder durch benutzerdefiniertes CSS/JavaScript des Betrachters oder durch exzessiv genutzte (und in den seltensten Fällen sinnvolle) zusätzliche CSS-Eigenschaften im Artikel, kann es zu Problemen kommen und die Darstellung verschoben sein. Ist das bei dir der Fall melde dich bitte auf der Diskussionsseite – die Probleme lassen sich meist ohne größere Probleme beheben.

Die einzige in der Praxis wirklich relevante Einschränkungen ist hierbei dass den Spalten eine feste Breite zugewiesen werden muss, meist ist dies aber ohne größere Probleme möglich.

Kopiervorlage

{{SortKeyColspan |colspan= |width= |widthSum= |key=}}
{{SortKeyColspan |colspan= |width= |widthSum= |key= |txt=}}

Parameter

Unterstrichene Parameter sind Pflicht-Parameter.

colspan

Anzahl der miteinander zu verbindenden Spalten

width

Breite der Spalten die miteinander verbunden werden sollen. Die Maßeinheit wird mit Hilfe des widthMeasurementUnit-Parameters beeinflusst und muss für alle Spalten identisch sein.

width[n]

Für die n'te Spalte eine abweichende Breite verwenden. Die Breite der letzten Spalte lässt sich nur mit dem width-Parameter beeinflussen. Optionaler Parameter; Standard: Wert des width-Parameters

widthMeasurementUnit

Maßeinheit für die Angabe der Spaltenbreiten (mögliche Werte: pt, pc, px, in, cm, mm, ex, em). Prozentangaben sind leider nicht möglich. Optionaler Parameter; Standard: em

widthSum

Kumulierte Breite aller miteinander zu verbindende Spalten. Als Maßeinheit wird die des widthMeasurementUnit-Parameters verwendet.

tdStyle

Auf die Tabellenzelle anzuwendenden zusätzlichen CSS-Eigenschaften. Optionaler Parameter

td[n]Style

Auf die Tabellenzelle der n'ten Spalte abweichende zusätzliche CSS-Eigenschaften anwenden. Die CSS-Eigenschaften der Zelle der letzten Spalte lassen sich nur mit dem tdStyle-Parameter beeinflussen. Optionaler Parameter; Standard: Wert des tdStyle-Parameters

key

Der unsichtbare Sortierschlüssel.

key[n]

Für die n'te Spalte einen abweichenden unsichtbaren Sortierschlüssel verwenden, zum Beispiel key2=Foobar wodurch die 2. Spalte so sortiert wird, als würde sie den Inhalt „Foobar“ besitzen. Der unsichtbare Sortierschlüssel der letzten Spallte lässt sich nur mit dem key-Parameter beeinflussen. Optionaler Parameter; Standard: Wert des key-Parameters

txt

Der anzuzeigende Text. Optionaler Parameter; Standard: Wert des key-Parameters

txtAlign

Die Ausrichtung (linksbündig, zentriert oder rechtsbündig) des dargestellten Textes (mögliche Werte: left, center, right). Optionaler Parameter; Standard: center

txtStyle

Zusätzliche CSS-Eigenschaften die auf den dargestellten Text angewandt werden sollen. Optionaler Parameter

Beispiel

Quellcode

{| class="wikitable sortable"
|- class="hintergrundfarbe5"
! Nummer
! Spalte 1
! Spalte 2
! Spalte 3
|-
| 1
{{SortKeyColspan |colspan=2 |width1=7 |width=13 |widthSum=20 |key=2 |txt=Test}}
| 5
|-
| 2
| 1
| 5
| 4
|-
| 3
{{SortKeyColspan |colspan=2 |width1=7 |width=13 |widthSum=20 |key=3}}
| 3
|-
| 4
{{SortKeyColspan |colspan=2 |width1=7 |width=13 |widthSum=20 |key1=5 |key=1}}
| 2
|-
| 5
{{SortKeyColspan |colspan=2 |width1=7 |width=13 |widthSum=20 |key=4}}
| 1
|}

Ausgabe

Mit dem width1-Parameter wurde festgelegt, dass Spalte 1 eine Breite von 7em hat, der width-Parameter steuert die Breite von Spalte 2 mit 13em. Zeile 1 wird nach dem Wert „2“ sortiert, als Text wird hingegen „Test“ ausgegeben. Man beachte außerdem, dass bei Sortierung der „Spalte 1“ die Zeile 4 anscheinend am falschen Ende der Tabelle erscheint. Das Verhalten ist allerdings korrekt, da ausdrücklich festgelegt wurde, dass die Zelle in Zeile 4 : Spalte 1 so formatiert werden soll, als würde sie den Wert „5“ enthalten – die Sortierung ist also richtig.

Nummer	Spalte 1	Spalte 2	Spalte 3
1	2	2 Test	5
2	1	5	4
3	3	3 3	3
4	5	1 1	2
5	4	4 4	1