Table widget reference

Table widget: top-level options en gedrag

Deze pagina documenteert alle niet-kolom-specifieke table opties uit de editor: filter JSON, default sort, totals, grouping/comparison/pivot, widget-level value rules en serialisatiegedrag bij save.

Table hub Kolommen & acties Label templates (table) Options matrix

1. Top-level opties

Table top-level opties — Eerst de globale tabelstructuur, daarna pas kolomdetails: dat voorkomt onnodig heen-en-weer configureren.

Default draftwaarden

groupingEnabled=true, comparisonMode=rows, pivotEnabled=false.
defaultSort en filter zijn initieel uit/empty.
preserveMeasuredColumnOverflow=false; inhoudsbreedtes met horizontaal scrollen zijn opt-in.
columns[] start met één lege kolomdraft in de editor.
Lege opties worden niet naar JSON geschreven.

Key	Type	Default	Beschrijving
`filter`	object	none	Extra widgetfilter bovenop page filters; moet een JSON object zijn.
`defaultSort.field`, `defaultSort.order`	string	uit	`defaultSort.order` toegestane waarden: `asc`, `desc`. Sortering op initial render.
`totals`	boolean/object	uit	`true` of object met `label`.
`preserveMeasuredColumnOverflow`	boolean	false	Behoudt gemeten inhoudsbreedtes per kolom en gebruikt horizontaal scrollen als de tabel breder is dan de widget.
`hideUngroupedColumns`	boolean	false	Verbergt niet-gegroepeerde kolommen in grouped mode.
`drilldownEnabled`	boolean	false	Activeert drilldown UI op grouped data.
`drilldownOrder`	string[]	[]	Geforceerde drilldownvolgorde.
`grouping`	boolean	true	Master switch voor grouping engine.
`groupDimensions`	string[]	[]	Dimensies waarop gegroepeerd wordt.
`groupMetrics`	string[]	[]	Metrics die geaggregeerd worden.
`groupMetricAggregations`	record	{}	Per metric toegestane waarden: `sum`, `avg`, `min`, `max`, `count`, `countDistinct`.
`comparisonMode`	string	rows	Toegestane waarden: `rows`, `columns`. Vergelijksets onder elkaar (`rows`) of naast elkaar (`columns`).
`comparisonChangeColumns`	boolean	false	Toont change/delta kolommen.
`comparisonChangeBaseline`	string	primary	Toegestane waarden: `primary`, `previous`. Welke set als baseline geldt voor delta.
`pivot.enabled`	boolean	false	Activeert pivoting.
`pivot.mode`	string	columns	Toegestane waarden: `columns`, `transpose`. Kolompivot of transposed matrix.
`pivot.dimension`	string	""	Verplicht wanneer `mode=columns`.
`pivot.metrics`	string[]	[]	Metrics die in pivot output komen.
`pivot.fillValue`	any	none	Parser ondersteunt number/bool/null/string input uit editor.
`pivot.emptyLabel`	string	""	Label voor lege dimensiewaarden.
`pivot.transposeLabelHeader`	string	Metric	Label-header in transpose mode.
`pivot.transposeValueHeader`	string	Value	Value-header in transpose mode.
`valueRules`	array	[]	Widget-level waarde replacements.
`columns`	array	[]	Kolomconfiguratie (uitgewerkt op aparte pagina).

2. Validatie en save-gedrag

Filter JSON

filterText moet parsebaar zijn als JSON object.
Array of primitive waarde geeft fout: Filter must be a JSON object.
Bij fout wordt save afgebroken met Invalid table filter JSON.

Pivot guardrails

Bij pivot.enabled=true + mode=columns is pivot.dimension verplicht.
Zonder dimensie stopt save met een duidelijke foutmelding.
pivot.metrics wordt deduped met een set.

Comparison nuances

comparisonMode=columns wordt alleen opgeslagen als grouping aan staat.
comparisonChangeBaseline=previous wordt alleen gezet als change columns actief zijn.
Zonder change columns blijft baseline impliciet primary.

Output minimalisatie

Lege/standaardwaarden worden weggelaten uit options JSON.
Als geen enkele setting gezet is, geeft builder null terug.
Dit houdt opgeslagen page JSON compact en diffs schoon.

3. Voorbeeld top-level table JSON

{
  "filter": { "status": "open" },
  "defaultSort": { "field": "created_at", "order": "desc" },
  "preserveMeasuredColumnOverflow": true,
  "totals": { "enabled": true, "label": "Totaal" },
  "groupDimensions": ["region"],
  "groupMetrics": ["revenue"],
  "groupMetricAggregations": {
    "revenue": "sum"
  },
  "comparisonMode": "columns",
  "comparisonChangeColumns": true,
  "comparisonChangeBaseline": "previous",
  "pivot": {
    "enabled": true,
    "mode": "columns",
    "dimension": "month",
    "metrics": ["revenue"],
    "fillValue": 0,
    "emptyLabel": "Onbekend"
  },
  "valueRules": [
    {
      "value": "critical",
      "matchMode": "exact",
      "replacement": "Kritiek",
      "replacementType": "text"
    }
  ]
}