Skip to content

Commit 3a04162

Browse files
committed
Sync with Kendo UI Professional
1 parent 12f4fb6 commit 3a04162

File tree

5 files changed

+191
-49
lines changed

5 files changed

+191
-49
lines changed

docs/api/javascript/dataviz/ui/chart.md

Lines changed: 31 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -8275,7 +8275,7 @@ A function that can be used to create a custom visual for the legend items. The
82758275
* options - the item options.
82768276
* createVisual - a function that can be used to get the default visual.
82778277
* series - the item series.
8278-
* pointIndex - the index of the point in the series. Available for pie, donut and funnel series.
8278+
* pointIndex - the index of the point in the series. Available for pie, donut, pyramid and funnel series.
82798279

82808280
#### Example - using custom visual for the legend items
82818281

@@ -12678,9 +12678,9 @@ The function should return a series configuration object or a `Promise` that res
1267812678

1267912679
### series.segmentSpacing `Number` *(default: 0)*
1268012680

12681-
The space in pixels between the different segments of the funnel chart.
12681+
The space in pixels between the different segments of the funnel and pyramid charts.
1268212682

12683-
> The `segmentSpacing` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel".
12683+
> The `segmentSpacing` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel" or "pyramid".
1268412684

1268512685
#### Example - set the chart series segmentSpacing field
1268612686

@@ -12787,7 +12787,7 @@ The last element is always created like a rectangle since there is no following
1278712787

1278812788
### series.dynamicHeight `Boolean` *(default: true)*
1278912789

12790-
> The `dynamicHeight` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel".
12790+
> The `dynamicHeight` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel" or "pyramid".
1279112791

1279212792
When set to `false` all segments become with the same height, otherwise the height of each segment is based on its value.
1279312793

@@ -14410,18 +14410,18 @@ The chart series label configuration.
1441014410

1441114411
### series.labels.align `String`
1441214412

14413-
The label alignment when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "donut", "funnel" or "pie".
14413+
The label alignment when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "donut", "funnel", "pyramid" or "pie".
1441414414

1441514415
The supported values for "donut" and "pie" are:
1441614416

1441714417
* "circle" - the labels are positioned in circle around the chart.
1441814418
* "column" - the labels are positioned in columns to the left and right of the chart.
1441914419

14420-
The supported values for "funnel" are:
14420+
The supported values for "funnel" and "pyramid" are:
1442114421

14422-
* "center" - the labels are positioned in the center over the funnel segment.
14423-
* "right" - the labels are positioned on the right side of the chart and do not (if there is enough space) overlap the funnel segment(s).
14424-
* "left" - the labels are positioned on the left side of the chart and do not (if there is enough space) overlap the funnel segment(s).
14422+
* "center" - the labels are positioned in the center over the segment.
14423+
* "right" - the labels are positioned on the right side of the chart and do not (if there is enough space) overlap the segment(s).
14424+
* "left" - the labels are positioned on the left side of the chart and do not (if there is enough space) overlap the segment(s).
1442514425

1442614426

1442714427
#### Example - set the chart series label alignment
@@ -14910,14 +14910,14 @@ The position of the labels.
1491014910

1491114911
* "above" - the label is positioned at the top of the marker. **Applicable for series that render points, incl. bubble.**
1491214912
* "below" - the label is positioned at the bottom of the marker. **Applicable for series that render points, incl. bubble.**
14913-
* "center" - the label is positioned at the point center. **Applicable for bar, column, donut, pie, funnel, radarColumn and waterfall series.**
14913+
* "center" - the label is positioned at the point center. **Applicable for bar, column, donut, pie, funnel, pyramid, radarColumn and waterfall series.**
1491414914
* "insideBase" - the label is positioned inside, near the base of the bar. **Applicable for bar, column and waterfall series.**
1491514915
* "insideEnd" - the label is positioned inside, near the end of the point. **Applicable for bar, column, donut, pie, radarColumn and waterfall series.**
1491614916
* "left" - the label is positioned to the left of the marker. **Applicable for series that render points, incl. bubble.**
1491714917
* "outsideEnd" - the label is positioned outside, near the end of the point. **Applicable for bar, column, donut, pie, radarColumn and waterfall series. Not applicable for stacked series.**
1491814918
* "right" - the label is positioned to the right of the marker. **Applicable for series that render points, incl. bubble.**
1491914919
* "top" - the label is positioned at the top of the segment. **Applicable for funnel series.**
14920-
* "bottom" - the label is positioned at the bottom of the segment. **Applicable for funnel series.**
14920+
* "bottom" - the label is positioned at the bottom of the segment. **Applicable for funnel and pyramid series.**
1492114921
* "auto" - the from and to labels area positioned at the top/bottom(rangeArea series) or left/right(verticalRangeArea series) so that they are outside the filled area. **Applicable for rangeArea and verticalRangeArea series.**
1492214922

1492314923

@@ -17401,6 +17401,7 @@ The supported values are:
1740117401
* [`column`](api/javascript/dataviz/ui/chart/configuration/seriesdefaults.column)
1740217402
* [`donut`](/api/javascript/dataviz/ui/chart/configuration/seriesdefaults.donut)
1740317403
* [`funnel`](/controls/charts/chart-types/funnel-charts)
17404+
* [`pyramid`](/controls/charts/chart-types/pyramid-charts)
1740417405
* [`heatmap`](/controls/charts/chart-types/heatmap)
1740517406
* [`horizontalWaterfall`](https://demos.telerik.com/kendo-ui/waterfall-charts/horizontal)
1740617407
* [`line`](/controls/charts/chart-types/line-charts)
@@ -17462,7 +17463,7 @@ Sets the visible property of a chart series
1746217463

1746317464
### series.visibleInLegend `Boolean` *(default: true)*
1746417465

17465-
A value indicating whether to show the point category name (for funnel, donut and pie series)
17466+
A value indicating whether to show the point category name (for funnel, pyramid, donut and pie series)
1746617467
or series name (for other available series types) in the legend.
1746717468

1746817469
#### Example - hide a chart series from the legend
@@ -17484,7 +17485,7 @@ or series name (for other available series types) in the legend.
1748417485

1748517486
The data item field which indicates whether to show the point category name in the legend.
1748617487

17487-
> The `visibleInLegendField` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel", "donut" or "pie".
17488+
> The `visibleInLegendField` option is supported when [series.type](/api/javascript/dataviz/ui/chart#configuration-series.type) is set to "funnel", "pyramid", "donut" or "pie".
1748817489

1748917490
#### Example - set the chart series visible in legend field
1749017491

@@ -17507,7 +17508,7 @@ The data item field which indicates whether to show the point category name in t
1750717508

1750817509
### series.visual `Function`
1750917510

17510-
A function that can be used to create a custom visual for the points. Applicable for bar, column, pie, donut, funnel, line, scatterLine, rangeBar, rangeColumn and waterfall series. The available argument fields are:
17511+
A function that can be used to create a custom visual for the points. Applicable for bar, column, pie, donut, funnel, pyramid, line, scatterLine, rangeBar, rangeColumn and waterfall series. The available argument fields are:
1751117512

1751217513
* rect - the `kendo.geometry.Rect` that defines where the visual should be rendered.
1751317514
* options - the point options.
@@ -17526,7 +17527,7 @@ A function that can be used to create a custom visual for the points. Applicable
1752617527
* startAngle - the segment start angle. Available for donut and pie series.
1752717528
* endAngle - the segment end angle. Available for donut and pie series.
1752817529
* center - the segment center point. Available for donut and pie series.
17529-
* points - the segment points. Available for funnel, line and scatterLine series.
17530+
* points - the segment points. Available for funnel, pyramid, line and scatterLine series.
1753017531

1753117532
#### Example - using custom visual
1753217533

@@ -19248,14 +19249,14 @@ The position of the labels.
1924819249

1924919250
* "above" - the label is positioned at the top of the marker. **Applicable for series that render points, incl. bubble.**
1925019251
* "below" - the label is positioned at the bottom of the marker. **Applicable for series that render points, incl. bubble.**
19251-
* "center" - the label is positioned at the point center. **Applicable for bar, column, donut, pie, funnel, radarColumn and waterfall series.**
19252+
* "center" - the label is positioned at the point center. **Applicable for bar, column, donut, pie, funnel, pyramid, radarColumn and waterfall series.**
1925219253
* "insideBase" - the label is positioned inside, near the base of the bar. **Applicable for bar, column and waterfall series.**
1925319254
* "insideEnd" - the label is positioned inside, near the end of the point. **Applicable for bar, column, donut, pie, radarColumn and waterfall series.**
1925419255
* "left" - the label is positioned to the left of the marker. **Applicable for series that render points, incl. bubble.**
1925519256
* "outsideEnd" - the label is positioned outside, near the end of the point. **Applicable for bar, column, donut, pie, radarColumn and waterfall series. Not applicable for stacked series.**
1925619257
* "right" - the label is positioned to the right of the marker. **Applicable for series that render points, incl. bubble.**
19257-
* "top" - the label is positioned at the top of the segment. **Applicable for funnel series.**
19258-
* "bottom" - the label is positioned at the bottom of the segment. **Applicable for funnel series.**
19258+
* "top" - the label is positioned at the top of the segment. **Applicable for funnel and pyramid series.**
19259+
* "bottom" - the label is positioned at the bottom of the segment. **Applicable for funnel and pyramid series.**
1925919260
* "auto" - the from and to labels area positioned at the top/bottom(rangeArea series) or left/right(verticalRangeArea series) so that they are outside the filled area. **Applicable for rangeArea and verticalRangeArea series.**
1926019261

1926119262

@@ -19302,9 +19303,9 @@ The [template](/api/javascript/kendo/methods/template) which renders the chart s
1930219303

1930319304
The fields which can be used in the template are:
1930419305

19305-
* category - the category name. Available for area, bar, column, bubble, donut, funnel, line and pie series.
19306+
* category - the category name. Available for area, bar, column, bubble, donut, funnel, pyramid, line and pie series.
1930619307
* dataItem - the original data item used to construct the point. Will be null if binding to array.
19307-
* percentage - the point value represented as a percentage value. Available for donut, funnel and pie series.
19308+
* percentage - the point value represented as a percentage value. Available for donut, funnel, pyramid and pie series.
1930819309
* series - the data series
1930919310
* value - the point value. Can be a number or object containing each bound field.
1931019311
* runningTotal - the sum of point values since the last "runningTotal" [summary point](/api/javascript/dataviz/ui/chart#configuration-series.summaryField). Available for waterfall series.
@@ -19485,9 +19486,9 @@ The [template](/api/javascript/kendo/methods/template) which renders the chart s
1948519486

1948619487
The fields which can be used in the template are:
1948719488

19488-
* category - the category name. Available for area, bar, column, bubble, donut, funnel, line and pie series.
19489+
* category - the category name. Available for area, bar, column, bubble, donut, funnel, pyramid, line and pie series.
1948919490
* dataItem - the original data item used to construct the point. Will be null if binding to array.
19490-
* percentage - the point value represented as a percentage value. Available for donut, funnel and pie series.
19491+
* percentage - the point value represented as a percentage value. Available for donut, funnel, pyramid and pie series.
1949119492
* series - the data series
1949219493
* value - the point value. Can be a number or object containing each bound field.
1949319494
* runningTotal - the sum of point values since the last "runningTotal" [summary point](/api/javascript/dataviz/ui/chart#configuration-series.summaryField). Available for waterfall series.
@@ -19593,9 +19594,9 @@ The [template](/api/javascript/kendo/methods/template) which renders the chart s
1959319594

1959419595
The fields which can be used in the template are:
1959519596

19596-
* category - the category name. Available for area, bar, column, bubble, donut, funnel, line and pie series.
19597+
* category - the category name. Available for area, bar, column, bubble, donut, funnel, pyramid, line and pie series.
1959719598
* dataItem - the original data item used to construct the point. Will be null if binding to array.
19598-
* percentage - the point value represented as a percentage value. Available for donut, funnel and pie series.
19599+
* percentage - the point value represented as a percentage value. Available for donut, funnel, pyramid and pie series.
1959919600
* series - the data series
1960019601
* value - the point value. Can be a number or object containing each bound field.
1960119602
* runningTotal - the sum of point values since the last "runningTotal" [summary point](/api/javascript/dataviz/ui/chart#configuration-series.summaryField). Available for waterfall series.
@@ -19877,6 +19878,7 @@ The supported values are:
1987719878
* column
1987819879
* donut
1987919880
* funnel
19881+
* pyramid
1988019882
* line
1988119883
* ohlc
1988219884
* pie
@@ -20057,7 +20059,7 @@ The format of the labels. Uses [kendo.format](/api/javascript/kendo/methods/form
2005720059

2005820060
Format placeholders:
2005920061

20060-
* Area, bar, column, funnel, line and pie
20062+
* Area, bar, column, funnel, pyramid, line and pie
2006120063
* {0} - value
2006220064
* Bubble
2006320065
* {0} - x value
@@ -20330,7 +20332,7 @@ The verticalRangeArea chart series options. Accepts all values supported by the
2033020332

2033120333
### seriesDefaults.visual `Function`
2033220334

20333-
A function that can be used to create a custom visual for the points. Applicable for bar, column, pie, donut, funnel, line, scatterLine, rangeBar, rangeColumn and waterfall series. The available argument fields are:
20335+
A function that can be used to create a custom visual for the points. Applicable for bar, column, pie, donut, funnel, pyramid, line, scatterLine, rangeBar, rangeColumn and waterfall series. The available argument fields are:
2033420336

2033520337
* rect - the `kendo.geometry.Rect` that defines where the visual should be rendered.
2033620338
* options - the point options.
@@ -20349,7 +20351,7 @@ A function that can be used to create a custom visual for the points. Applicable
2034920351
* startAngle - the segment start angle. Available for donut and pie series.
2035020352
* endAngle - the segment end angle. Available for donut and pie series.
2035120353
* center - the segment center point. Available for donut and pie series.
20352-
* points - the segment points. Available for funnel, line and scatterLine series.
20354+
* points - the segment points. Available for funnel, pyramid, line and scatterLine series.
2035320355

2035420356
#### Example - using custom visual
2035520357

@@ -22341,7 +22343,7 @@ The format of the labels. Uses [kendo.format](/api/javascript/kendo/methods/form
2234122343

2234222344
Format placeholders:
2234322345

22344-
* Area, bar, column, funnel, line and pie
22346+
* Area, bar, column, funnel, pyramid, line and pie
2234522347
* {0} - value
2234622348
* Bubble
2234722349
* {0} - x value
@@ -38605,7 +38607,7 @@ Returns a PNG image of the chart encoded as a [Data URL](https://developer.mozil
3860538607

3860638608
### toggleHighlight
3860738609

38608-
Toggles the highlight of the series points or a segment for pie, donut and funnel charts.
38610+
Toggles the highlight of the series points or a segment for pie, donut and funnel, pyramid charts.
3860938611

3861038612
#### Parameters
3861138613

0 commit comments

Comments
 (0)