Calc-Tag
Das Calc-Tag führt automatische Berechnungen basierend auf Formeln durch.Syntax
info- oder switch-Tag innerhalb des Calc-Tags enthalten sein. Die enthaltenen Tags werden im Dokument nicht doppelt gerendert, sondern definieren und verifizieren die Berechnungskomponenten.
Parameter
Formel-Syntax
Variablen werden in eckigen Klammern referenziert:[Variablenname]
Unterstützte Operatoren:
- Addition:
+ - Subtraktion:
- - Multiplikation:
* - Division:
/ - Potenz:
^ - Klammern:
()
Beispiele
Body-Mass-Index (BMI):round=false wird das Ergebnis ohne Rundung dargestellt.
CHA₂DS₂-VASc-Score (vereinfacht):
Funktionsweise
- Das Calc-Tag enthält und referenziert seine Variablen als Info- oder Switch-Tags
- Die Formel wird automatisch berechnet, wenn Werte eingegeben werden
- Das Ergebnis wird standardmäßig auf 2 Dezimalstellen gerundet;
roundpasst dies an - Bei fehlenden oder ungültigen Werten wird
...angezeigt - Das Ergebnis erscheint als orangener Badge im Dokument
Best Practices
- ✅ Stellen Sie sicher, dass alle referenzierten Variablen existieren
- ✅ Verwenden Sie klare Variablennamen ohne Leerzeichen
- ✅ Verwenden Sie Unterstriche statt Leerzeichen:
RR_sysstattRR sys - ✅ Testen Sie Ihre Formeln mit verschiedenen Werten
- ❌ Vermeiden Sie Division durch Null (prüfen Sie Ihre Formeln)
- ✅ Dokumentieren Sie komplexe Berechnungen mit Kommentaren
Tooltip-Funktion
Calc-Tags zeigen beim Hovern ein Tooltip mit der verwendeten Formel an. Dies hilft Benutzern zu verstehen, wie der Wert berechnet wurde. Die frühere Syntax{% score ... %} bleibt als Alias kompatibel. Neue Templates und der Editor verwenden {% calc ... %}.