Template reference

Label template JSON: complete functie-overzicht

Table kolommen (labelTemplate) en chart x-labels (xLabelTemplate) gebruiken dezelfde template engine. Deze pagina documenteert het JSON-formaat, resolutie van velden en alle ondersteunde op-functies uit de runtime.

Schema Value references String en text ops Math en format ops Datum en utility ops Voorbeelden

1. JSON schema

De editor accepteert alleen een JSON object met een niet-lege ops-array. Zonder geldige ops blokkeert opslaan met een validatiefout.

{
  "value": { "field": "status" },
  "ops": [
    { "op": "trim" },
    { "op": "upper" }
  ],
  "fallback": "-"
}

Key	Type	Beschrijving
`value`	literal/object	Startwaarde voor de pipeline. Mag literal zijn of een reference object.
`ops`	array	Verplicht en niet leeg. Elke entry bevat minimaal `op`.
`fallback`	literal/object	Wordt gebruikt als eindresultaat leeg is (`null`, `undefined` of lege string).

2. Value references en resolutie

Reference objects kunnen zowel in value als in op-argumenten (zoals add.value, coalesce.values[], datediff.other) gebruikt worden.

Vorm	Voorbeeld	Gedrag
Field reference	`{ "field": "revenue" }`	Leest uit row/context field.
ColumnId reference	`{ "columnId": "margin__2" }`	Leest raw waarde van een andere tabelkolom via `columnId`.
Literal wrapper	`{ "literal": 100 }`	Forceert een literal waarde als object.
Direct literal	`"OK"`, `42`, `true`	Wordt direct gebruikt als waarde.

Belangrijke runtime-notes

op-namen zijn case-insensitive; runtime lowercaset intern.
Aliases werken ook: bijvoorbeeld replaceRegex en replace_regex.
Styling ops zoals class, color, bg, icon, wrap wijzigen presentatie, niet de kernwaarde.

3. String, mapping en text ops

Op	Belangrijkste argumenten	Beschrijving
`set`, `value`	`value`	Zet huidige waarde expliciet.
`field`	`field`	Zet waarde vanuit contextveld.
`start`	`index`	Snijdt string vanaf index.
`cutoff`, `ellipsis`	`length`, `ellipsis`	Trimt string op lengte, optioneel met `...`.
`head`, `tail`	`length`	Eerste of laatste N tekens.
`upper`, `lower`, `title`, `trim`	-	Standaard casing/trimtransformaties.
`snake`, `kebab`, `slug`	-	Slugify varianten.
`initials`	-	Maakt initialen uit tekst.
`replace`	`search/from`, `replacement/to`	Globale tekstvervanging (escaped regex).
`replaceRegex`, `replace_regex`	`pattern`, `replacement`, `flags`	Regex replacement.
`pad`	`direction`, `length`, `char`	Pad links of rechts.
`default`	`value`	Alleen toegepast als huidige waarde leeg is.
`coalesce`	`values[]`	Eerste niet-lege kandidaat kiezen.
`join`	`separator`	Voegt arraywaarden samen.
`len`	-	Lengte van string/array.
`map`, `switch`	`map`/`cases`, `default`	Waarde-naar-label mapping.
`status`	-	Status-normalisatie helper.
`match`, `matchAll`	`pattern`, `all`	Regex extract van eerste of alle matches.
`mask`	`visible`, `char`	Maskeert tekst behalve zichtbaar deel.
`class`	`value` of `class`	Voegt CSS class toe aan output wrapper.
`color`	`value` of `color`	Zet inline tekstkleur.
`bg`, `background`	`value` of `background`	Zet achtergrondkleur.
`icon`	`value` of `icon`	Voegt icon-klassenaam toe.
`wrap`	`value` of `wrap`	Wikkelt output met template (met `{value}`).

4. Math, nummerformat en classificatie ops

Op	Belangrijkste argumenten	Beschrijving
`abs`	-	Absolute waarde.
`add`, `sub`, `mul`, `div`	`value` of `field`	Numerieke bewerkingen.
`percentOf`, `percent_of`	`value`	Percentage van operand.
`scale`	`value`	Alias voor vermenigvuldigen.
`round`, `ceil`, `floor`	`digits`	Afronding met optionele decimalen.
`currency`, `number`, `percent`	`format`, `currency`, `digits`	Locale formattering van output.
`bucket`	`ranges[]` met `min`, `max`, `label`	Mapt numerieke range naar label.
`clamp`	`min`, `max`	Begrenst numerieke waarde.
`ordinal`	-	Maakt ordinale output (bijv. 1st/2nd).
`plural`	`singular`, `plural`	Kiest enkelvoud/meervoud op basis van waarde.
`unit`	`unit`	Voegt eenheid toe.
`palette`, `colorFromPalette`	`colors[]`	Kiest kleur op basis van waardehash/index.

5. Datum, tijd en utility ops

Op	Belangrijkste argumenten	Beschrijving
`date`, `datetime`, `time`	`format`	Formatteert datum/tijd output.
`ago`, `fromNow`	-	Relative tijd (verleden/toekomst tekst).
`dateAdd`	`duration`	Verschuift datum met duration (bijv. `+2d`, `-3h`).
`dateDiff`	`other`, `unit`	Datumverschil in gekozen eenheid.
`hash`	`algo`	Hash van huidige waarde (default `md5`).

6. Praktische voorbeelden

{
  "value": { "field": "name" },
  "ops": [
    { "op": "trim" },
    { "op": "title" },
    { "op": "cutoff", "length": 24, "ellipsis": true }
  ],
  "fallback": "Onbekend"
}

{
  "value": { "field": "revenue" },
  "ops": [
    { "op": "div", "value": { "field": "orders" } },
    { "op": "round", "digits": 2 },
    { "op": "currency", "currency": "EUR" }
  ]
}

{
  "value": { "field": "status" },
  "ops": [
    { "op": "lower" },
    { "op": "switch", "cases": { "open": "Actief", "closed": "Afgesloten" }, "default": "Onbekend" },
    { "op": "class", "value": "badge" }
  ]
}