Chart widget reference

Chart widget: core opties, scales en datasets

Deze reference volgt de editordraft en build-logica voor chart widgets. Focus: data mapping, sort/grouping, style/rendering, color/value rules, axes en extra datasets.

Chart hub Annotaties & interacties Chart label templates Core mapping Axes

1. Core data mapping en aggregatie

Chart widget settings — Chart instellingen in de editor.

Default draftwaarden

kind=bar, xField=date, yField=value, agg=sum.
responsive=true, legendDisplay=true, tooltipEnabled=true.
valueFormat=number, valueDigitsInfo=1.0-2.
advancedOptionsText start als leeg object.

Key	Type	Beschrijving
`kind`	bar/line/pie/doughnut/polarArea/radar/scatter/bubble/sankey	Charttype.
`xField`, `yField`	string	Primair x/y veld; bij sankey fallback voor from/to.
`agg`	sum/avg/count/countDistinct	Aggregatie op `yField`.
`groupBy`	string	Seriegroepering op extra dimensie.
`groupLimit`	number	Max aantal groups.
`xSort`, `groupSort`	label/value asc/desc	Sortering op labels of waardes.
`groupInclude`	string[]	Whitelist van groepen die getoond worden.
`groupKindOverrides[]`	array	Per group override naar `bar` of `line`, optioneel met label/kleur.
`datasetLabel`	string	Label van hoofdserie.
`primaryDatasetOrder`	number	Rendervolgorde hoofdserie.
`titleBold`	boolean	Vetgedrukte widgettitel.
`filter`	object	Widgetspecifiek filterobject.

2. Style, rendering en gedragsopties

Groep	Keys	Beschrijving
Legend	`legendDisplay`, `legendPosition`, `legendReverse`	Legend zichtbaarheid/positie.
Tooltip	`tooltipEnabled`, `tooltipTitleFormat`, `tooltipBodyFormat`	Tooltip gedrag en formattering.
Series	`borderWidth`, `pointRadius`, `lineFill`, `lineStopAtDataEnd`	Lijn/bar/point rendering.
Bars	`barPercentage`, `categoryPercentage`, `borderRadius`	Bar breedtes en rounding.
Pie/Doughnut	`circumference`, `rotation`	Cirkelhoeken in graden (intern genormaliseerd).
Comparisons	`comparisonReplaceGrouping`	Compare sets als primaire groupingbron gebruiken.
Date guard	`minDateRangeDays`	Minimum datarange voor renderlogica.
Palette	`colorPerCategory`	Unieke kleur per categorie forceren.

Bar shine

barShineEnabled, barShineSpeedSeconds, barShinePauseSeconds.
barShineIntensityLight, barShineIntensityDark.
barShineColorLight, barShineColorDark.

Bar hover glow

barHoverGlowEnabled, barHoverGlowBlurPx.
barHoverGlowIntensityLight, barHoverGlowIntensityDark.
barHoverGlowColorLight, barHoverGlowColorDark.

3. Color rules en value rules

Rule type	Opties	Details
Page color rules	`usePageColorRules`, `pageColorSource`	`pageColorSource` is `label` of `value`.
Widget color rule kind	`value`, `range`, `index-range`, `date`	Alle vier worden ondersteund en genormaliseerd voor runtime.
Range rule	`min`, `max`, `scale`, inclusivity flags	`scale` is `absolute` of `percent`.
Date rule	`dateMode`	`after`, `afterOrOn`, `before`, `beforeOrOn`.
Page value rules	`usePageValueRules`	Hergebruikt page value replacements.
Widget value rules	`valueRules[]`	Zelfde schema als table replacements.

4. X/Y scales en value formats

xScale en yScale gebruiken hetzelfde schema; alleen gevulde velden worden opgeslagen.

Scale key	Waarden	Beschrijving
`type`	category/linear/logarithmic/time/timeseries	As type.
`display`, `stacked`, `beginAtZero`	boolean	Basis as-instellingen.
`min`, `max`	string/number	As grenzen.
`position`	left/right/top/bottom	As positionering.
`title`	string	Astekst.
`timeUnit`	year/quarter/month/week/day/hour/minute/second	Unit voor tijdassen.
`labelMaxLength`, `labelStartIndex`	integer	Label truncatie/startoffset.
`valueFormat`	string/number/decimal/currency/percent/date/datetime/time	Formattering voor ticks op deze as.
`valueDigitsInfo`	string	Numerieke precisie.
`valueCurrencyCode`, `valueCurrencyDisplay`	string	Valuta formattering.
`valueDateFormat`	string	Datumformat op aslabels.
`valuePrefix`, `valueSuffix`, `valueTemplate`	string	Custom prefix/suffix/template per tick.

Dataset value formats buiten scales

valueFormat bepaalt standaard formattering van datasetwaardes.
xValueFormat en yValueFormat kunnen per aswaarde overriden.
Voor numerieke formats gebruikt runtime alleen *DigitsInfo als format numeriek is.
Voor currency/date formats vallen x/y defaults terug op algemene value* velden.

5. Extra datasets

Key	Beschrijving
`id`, `yField`	Dataset identifier en verplicht y-veld.
`label`, `color`, `order`	Seriepresentatie en render order.
`kind`	`line` of `bar`.
`lineStyle`	`solid`, `dashed`, `dotted`.
`dataLabelsEnabled`	Per extra dataset datalabel override.
`dataSourceUid`	Optionele andere datasource voor deze dataset.
`shareAxis`, `axis`	Delen van primaire as of eigen asconfiguratie.
`timeShift`	`afterTo`, `beforeFrom`, `afterToKeepFrom`.
`borderWidth`, `pointRadius`	Dataset-specifieke draw overrides.