Vorlage:ZahlZelle/Doku

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

TemplateData

{ "description": "Zahlenformatierung eines sortierbaren Zahlenwerts in Tabellen<noexport>.<br />
Ohne Pipe-Symbol direkt an den Zellenbeginn anzuschließen.
</noexport>",
  "params": {
     "1":
        { "label":       "Zahl",
          "description": "Zahl; typografisches Minuszeichen zulässig und wahlweise Punkt oder Komma als Dezimaltrennzeichen zulässig<noexport>.<br />
Tausendertrennzeichen sind nicht empfehlenswert.<br />
Wird das maschinenlesbare Format <code>1.234E56</code> benutzt, entspricht dies vollumfänglich der Vorlage:ZahlExpZelle.<br />
Mit dem Zeichen <code>∞</code> wird hinter allen Zahlen eingeordnet, aber nichts optisch dargestellt; analog <code>-∞</code> vor allen Zahlen (typografisches oder ASCII-Minuszeichen sowie Pluszeichen zulässig).<br />
Bekannte Schlüsselwörter dürfen vorangestellt werden.<br />
Ziffern aus zahlreichen nichtwestlichen Schriften, die auf <code>0</code> bis <code>9</code> abgebildet werden können, sind möglich und führen zu einer adäquaten Sortierung gemischt mit westlichen Ziffern.</noexport>",
          "type":        "line",
          "suggested":   true,
          "default":     "0",
          "example":     "3,1415" },
     "suffix":
        { "label":       "Suffix",
          "description": "Kurzes nichtnumerisches Anhängsel; wird unmittelbar mit dem Zahlenwert verbunden",
          "type":        "line",
          "required":    false,
          "example":     "…" },
     "pre":
        { "label":       "Präfix",
          "description": "Kurzes Präfix; etwa <code>ca.</code> oder <code>&lt;</code> oder  <code>ø</code><noexport>.<br />
Wird ohne Zeilenumbruch mit dem Zahlenwert verbunden; dazwischen normaler Weißraum.</noexport>",
          "type":        "content",
          "required":    false,
          "example":     "≈" },
     "post":
        { "label":       "Postfix",
          "description": "Kurzes Postfix; etwa eine Maßeinheit<noexport>.<br />
Wird ohne Zeilenumbruch mit dem Zahlenwert verbunden; dazwischen normaler Weißraum.</noexport>",
          "type":        "content",
          "required":    false,
          "example":     "kg/m³" },
     "pad":
        { "label":       "Aus&shy;richtung",
          "description": "versuchte integrierte Ausrichtung des Dezimaltrenners; Anzahl der Ziffern<noexport>.
* positive Werte: rechtsbündig
* negative Werte: linksbündig
<div style='clear:both'></div></noexport>",
          "type":        "line",
          "required":    false,
          "example":     "3" },
     "zeige":
        { "label":       "Sichtbar",
          "description": "Zahl sichtbar darstellen<noexport>.<br />
Abschaltung, um nur den Sortierwert zu nutzen</noexport>",
          "type":        "boolean",
          "required":    false,
          "default":     "1",
          "example":     "0" },
     "rowspan":
        { "label":       "",
          "description": "Tabellen-Attribut: Anzahl der Zeilen",
          "type":        "number",
          "required":    false,
          "example":     "2" },
     "colspan":
        { "label":       "",
          "description": "Tabellen-Attribut: Anzahl der Spalten",
          "type":        "number",
          "required":    false,
          "example":     "3" },
     "class":
        { "label":       "",
          "description": "Zusätzlicher Klassenbezeichner, etwa zur CSS-Zuordnung (der gesamten Tabellenzelle)",
          "type":        "line",
          "required":    false,
          "example":     "hintergrundfarbe8" },
     "style":
        { "label":       "CSS",
          "description": "CSS-Eigenschaften (der gesamten Tabellenzelle)",
          "type":        "line",
          "required":    false,
          "example":     "color:#800080;text-align:right" },
     "id":
        { "label":       "Fragment",
          "description": "Fragmentbezeichner („Anker“)<noexport>.<br />
Günstiger wäre es, die gesamte Tabellenzeile mit einem Fragmentbezeichner zu versehen.</noexport>",
          "type":        "line",
          "required":    false,
          "example":     "pi" }
            }
}

Kopiervorlage

{{ZahlZelle|}}
{{ZahlZelle | |suffix= |pad= |pre= |post= |rowspan= |colspan= |class= |style= |id=}}

Darstellung, Formate, Besonderheiten

Darstellung

Immer typografisches Minuszeichen.

Immer Komma als Dezimaltrenner.

Immer Punkt zur Tausendertrennung.

Bei sechs oder mehr Nachkommastellen wird nach dem Komma in Dreiergruppen mit schmalem Weißraum gegliedert.

Vorangestelltes + wird auch dargestellt.

Parameterformat

Sowohl einfaches ASCII- wie auch typografisches Minuszeichen möglich.

Komma oder Punkt als Dezimaltrenner möglich.

Ein Syntaxfehler im Eingabewert (etwa Bis-Strich statt Minuszeichen, oder Buchstabe „O“ statt Ziffer Null) wird markiert.

Sortierung

Vorangestellte Zeichen oder typografisches Minuszeichen stören nicht die Sortierung.

Zellen mit einfachen Zahlen können kombiniert werden, und mit den anderen Vorlagen der Familie.

Padding

Es wird eine integrierte Ausrichtung des Dezimaltrenners versucht.

Dabei wird für alle Zellen in der Spalte der gleiche Positionswert vorgegeben, und in jeder Zelle anhand des momentanen Zahlenwerts daraus der vermutlich freizulassende Weißraum ermittelt.

Copy & Paste

Beim Copy & Paste einzelner Zahlen oder auch ganzer Tabellen wird die deutsche typografische optische Darstellung ersetzt durch das computergerechte internationale Datenformat, wodurch die Werte einfach in andere Vorlagen oder externe Berechnungsprogramme eingefügt werden können:

• ASCII-Bindestrich-Minus statt typografischem Minuszeichen
• Punkt als Dezimaltrenner
• Keine Tausendertrennung
• Keine Gliederung der Nachkommastellen

Schlüsselwörter

Die nachstehenden Schlüsselwörter werden erkannt und für den Sortierwert berücksichtigt:

• ≥
• <
• ±
• >
• ≈
• ≤

Beispiele

{| class="wikitable sortable" style="text-align:right"
|-
! Zahl
|-
| {{ZahlZelle|-4,2}}
|-
| {{ZahlZelle|-2.4}}
|-
| 5
|-
| {{ZahlZelle|∞}} (ganz hinten)
|-
| {{ZahlZelle|−∞}} (ganz vorn)
|-
| {{ZahlZelle|7,0}}
|-
| {{ZahlZelle|007}}
|-
| {{ZahlZelle|3456}}
|-
| {{ZahlZelle|+3,0}}
|}

Zahl
-4.2
-2.4
5
(ganz hinten)
(ganz vorn)
7.0
7
3456
+3.0

data-sort-value

Für den Sortierschlüssel wird die Methode data-sort-value verwendet, wodurch der Sortierschlüssel nicht zum Bestandteil des Inhalts der Zelle wird.

Wartung

Fehlerhafte Einbindungen werden aufgelistet in der Kategorie:Wikipedia:Vorlagenfehler/Parameter:Zahl – aktuell keine     (15. März 2025 22:24) Aktualisieren

See also

• Vorlage:ZahlExpZelle – Zahl in Exponentialdarstellung

Vorlagen zur Tabellensortierung

Vorlage:Auflistung Diese Vorlagen fügen in den Inhalt des Dokuments keine unsichtbaren Täusch-Inhalte ein.