Dashview Docs - Chart Widget Options

1. Core data mapping en aggregatie

kind=bar, xField=date, yField=value, agg=sum.
responsive=true, legendDisplay=true, tooltipEnabled=true.
valueFormat=number, valueDigitsInfo=1.0-2.
Opgeslagen charts bevatten gegenereerde native instellingen onder options.echartsOptions.

Key	Type	Beschrijving
`kind`	string	Toegestane waarden: `bar`, `line`, `pie`, `doughnut`, `polarArea`, `radar`, `scatter`, `bubble`, `sankey`, `bar3D`, `line3D`, `scatter3D`, `surface`. Charttype.
`xField`, `yField`, `zField`, `sizeField`, `sizeAgg`	string	Primaire x/y-velden; 3D charts gebruiken ook `zField`. `sizeField` stuurt de bubbelradius en optionele `sizeAgg` aggregeert de bubbelgrootte voor rijen die op dezelfde x/y-positie vallen. Bij sankey blijven x/y ook de fallback voor van/naar.
`agg`	string	Toegestane waarden: `sum`, `avg`, `count`, `countDistinct`. Aggregatie op `yField`.
`groupBy`	string	Seriegroepering op extra dimensie.
`groupLimit`	number	Max aantal groups.
`xSort`, `groupSort`	string	Toegestane waarden: `label asc`, `label desc`, `value asc`, `value 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.

scatter en bubble lezen ruwe punt-rijen in plaats van gegroepeerde metric-buckets.
bubble gebruikt xField, yField en optioneel sizeField.
bar3D, line3D, scatter3D en surface lezen ruwe punten met xField, yField en zField. Voor bar3D en surface worden dubbele x/y-posities volgens agg samengevoegd.
sizeAgg ondersteunt sum, avg, count, countDistinct, min en max voor herhaalde bubbels op dezelfde coördinaten.
line en bar schakelen ook over naar ruwe punten wanneer yScale.type = "category", zodat stringwaarden echt op de Y-as kunnen renderen.
Wanneer een categorie-as ook expliciete labels heeft, renderen point-mode-grafieken alleen waarden uit die lijst en houden ze precies die volgorde aan.
Voor bar charts met een categorische Y-as kiest Dashview standaard horizontale bars, tenzij je indexAxis expliciet overschrijft.

Groep	Keys	Beschrijving
Legend	`legendDisplay`, `legendPosition`, `legendReverse`	Legend zichtbaarheid/positie.
Tooltip	`tooltipEnabled`, `tooltipTitleFormat`, `tooltipBodyFormat`	Tooltip gedrag en formattering.
Datalabels	`dataLabelsFormat`	Optioneel token-gebaseerd tekstsjabloon voor datalabels, met dezelfde placeholderstijl als tooltip-opmaak.
Series	`borderWidth`, `pointRadius`, `lineFill`, `lineStopAtDataEnd`	Lijn/bar/point rendering.
3D	`gl3D`, `zScale`	3D box/camera/shading-instellingen, camera-offsets via `viewCenterX`/`viewCenterY`, Z-asopties, `barSize`, `lineWidth`, `symbolSize` en `wireframe` voor surface charts.
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.

Nieuwe en opnieuw opgeslagen chart widgets bewaren native ECharts-instellingen onder options.echartsOptions.
De datasource-mapping blijft in Dashview-velden zoals xField, yField, agg en groupBy, zodat live data en filters blijven werken.
De editor heeft geen apart ECharts JSON-veld; gebruik de normale chartvelden of pas options.echartsOptions direct aan via de volledige widget-JSON.
echartsOptions is een template voor ECharts-opties zoals legend, tooltip, grid, xAxis, yAxis, grid3D, xAxis3D, yAxis3D, zAxis3D en series-styling.
Runtime-data zoals series.data, sankey links en dynamische axis-data worden opnieuw uit de datasource opgebouwd en niet uit stale JSON overgenomen.
Oude configs met chartOptions blijven leesbaar; zodra je zo'n chart opent en opslaat, schrijft Dashview de ECharts-native vorm terug.

Rule type	Opties	Details
Page color rules	`usePageColorRules`, `pageColorSource`	Toegestane waarden voor `pageColorSource`: `label`, `group`, `value`, `y`. `y` is bedoeld voor 3D charts; bij 3D matcht `value` op de Z-aswaarde.
Widget color rule kind	`kind`	Toegestane waarden: `value`, `range`, `index-range`, `date`. Alle vier worden ondersteund en genormaliseerd voor runtime.
Range rule	`min`, `max`, `scale`, inclusivity flags	`scale` toegestane waarden: `absolute`, `percent`.
Date rule	`dateMode`	`dateMode` toegestane waarden: `after`, `afterOrOn`, `before`, `beforeOrOn`.
Page value rules	`usePageValueRules`	Hergebruikt page value replacements.
Widget value rules	`valueRules[]`	Zelfde schema als table replacements.

xScale, yScale en voor 3D charts zScale gebruiken hetzelfde schema; alleen gevulde velden worden opgeslagen.

Scale key	Waarden	Beschrijving
`type`	string	Toegestane waarden: `category`, `linear`, `logarithmic`, `time`, `timeseries`. As type.
`display`, `stacked`, `beginAtZero`	boolean	Basis as-instellingen.
`min`, `max`	string/number	As grenzen.
`position`	string	Toegestane waarden: `left`, `right`, `top`, `bottom`. As positionering.
`title`	string	Astekst.
`timeUnit`	string	Toegestane waarden: `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`. Unit voor tijdassen.
`autoTimeUnitMin`, `autoTimeUnitMax`	string	Toegestane waarden: `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`. Onder- en bovengrens voor automatische X-as tijdseenheden. Zonder waarden gebruikt Dashview dag tot jaar.
`labelMaxLength`, `labelStartIndex`	integer	Label truncatie/startoffset.
`valueFormat`	string	Toegestane waarden: `string`, `number`, `decimal`, `currency`, `percent`, `date`, `datetime`, `time`. Formattering voor ticks op deze as.
`valueDigitsInfo`	string	Numerieke precisie.
`valueCurrencyCode`, `valueCurrencyDisplay`	string	Valuta formattering. `valueCurrencyDisplay` toegestane waarden: `symbol`, `symbol-narrow`, `code`.
`valueDateFormat`	string	Datumformat op aslabels.
`valuePrefix`, `valueSuffix`, `valueTemplate`	string	Custom prefix/suffix/template per tick.
`labels`	string[]	Optionele vaste categorielabels. In point-mode-grafieken werken ze ook als allowlist en render-volgorde voor categoriewaarden.

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.

Key	Beschrijving
`id`, `yField`	Dataset identifier en verplicht y-veld.
`label`, `color`, `order`	Seriepresentatie en render order.
`kind`	Toegestane waarden: `line`, `bar`.
`lineStyle`	Toegestane waarden: `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.