Chart widget reference
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.
kind=bar, xField=date, yField=value, agg=sum.responsive=true, legendDisplay=true, tooltipEnabled=true.valueFormat=number, valueDigitsInfo=1.0-2.options.echartsOptions.| Key | Type | Beschrijving |
|---|---|---|
kind | string | Toegestane waarden: bar, line, pie, doughnut, polarArea, radar, scatter, bubble, sankey, bar3D, line3D, scatter3D, surface. Charttype. |
orientation | string | Alleen voor 2D bar charts. Gebruik vertical voor normale kolomgrafieken en horizontal voor horizontale bars. Verticaal is de standaard. |
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.labels heeft, renderen point-mode-grafieken alleen waarden uit die lijst en houden ze precies die volgorde aan.xField de categorie-/tijdas, yField de numerieke waarde-as, en kun je expliciet orientation = "vertical" zetten.xField het categorie-labelveld, yField het numerieke waardeveld, en zet je orientation = "horizontal".| 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. |
barHoverGlowEnabled, barHoverGlowBlurPx.barHoverGlowIntensityLight, barHoverGlowIntensityDark.barHoverGlowColorLight, barHoverGlowColorDark.options.echartsOptions.xField, yField, agg en groupBy, zodat live data en filters blijven werken.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.series.data, sankey links en dynamische axis-data worden opnieuw uit de datasource opgebouwd en niet uit stale JSON overgenomen.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. |
autoTimeUnitMode | string | range (standaard) kiest de automatische eenheid op basis van het zichtbare tijdsbereik. cadence kiest deze op basis van het gebruikelijke interval tussen bronpunten en negeert grotere uitschieters zoals nachten en weekenden. |
preserveSourcePoints | boolean | Bij true formatteert de gekozen of automatische tijdseenheid alleen de aslabels, zonder bronpunten samen te voegen in tijdvakken. Dit is geschikt voor tijdreeksen die al zijn bemonsterd. |
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.*DigitsInfo als format numeriek is.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. |