Quelltext der Seite Vorlage:ZahlZelle/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "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 />
[[#preAd|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" }
            }
}
|TOC=1}}

== Kopiervorlage ==
<pre style="white-space:pre-wrap; overflow:auto;">
{{ZahlZelle|}}
{{ZahlZelle | |suffix= |pad= |pre= |post= |rowspan= |colspan= |class= |style= |id=}}
</pre>

== Darstellung, Formate, Besonderheiten ==
<section begin="basic" />
; Darstellung
: Immer typografisches Minuszeichen.
: Immer Komma als Dezimaltrenner.
: Immer Punkt zur Tausendertrennung.<section end="basic" /><section begin="parse" />
: Bei sechs oder mehr Nachkommastellen wird nach dem Komma in Dreiergruppen mit schmalem Weißraum gegliedert.
: Vorangestelltes <code>+</code> 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.<section end="parse" /><section begin="sort" />
; 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.<section end="sort" /><section begin="pad" />
; Padding
: Es wird eine integrierte Ausrichtung des Dezimaltrenners versucht.
: Dabei wird für alle Zellen in der Spalte der gleiche Positionswert {{#ifeq: {{NAMESPACENUMBER}} | 10 | [[#templatedata:pad|vorgegeben]] | vorgegeben }}, und in jeder Zelle anhand des momentanen Zahlenwerts daraus der vermutlich freizulassende Weißraum ermittelt.<section end="pad" />
<section begin="c&p" />; 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<section end="c&p" />

== {{Anker|preAd}} Schlüsselwörter ==
Die nachstehenden Schlüsselwörter werden erkannt und für den Sortierwert berücksichtigt:
{{#invoke:Sort/cellNum|furnish}}

== Beispiele ==
<pre>
{| 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}}
|}
</pre>
{| 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}}
|}

== data-sort-value ==
Für den Sortierschlüssel wird die Methode <code style="white-space:nowrap">[[Hilfe:Tabellen/Sortierung#data-sort-value|data-sort-value]]</code> verwendet, wodurch der Sortierschlüssel nicht zum Bestandteil des Inhalts der Zelle wird.

== Wartung ==
{{Vorlagenfehler-Wartungskat |Vorlage=Parameter:Zahl}}
{{Dokumentation/Siehe auch |Liste=
* [[Vorlage:ZahlExpZelle]] – Zahl in Exponentialdarstellung
}}
{{Navigationsleiste Vorlagen zur Tabellensortierung}}
<includeonly>
{{Dokumentation/Lua|Sort/cellNum #f}}

[[Kategorie:Vorlage:Tabellenformatierung]]
[[Kategorie:Vorlage:Zahlenformatierung]]
</includeonly>