@progress/kendo-angular-charts 13.2.0-develop.6 → 13.2.0-develop.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/chart/axis-defaults/crosshair.component.d.ts +17 -0
  2. package/chart/axis-defaults/crosshair.tooltip.component.d.ts +18 -0
  3. package/chart/axis-defaults/labels.component.d.ts +41 -0
  4. package/chart/axis-defaults/title.component.d.ts +24 -0
  5. package/chart/axis-defaults.component.d.ts +19 -0
  6. package/chart/category-axis-item/crosshair.component.d.ts +17 -0
  7. package/chart/category-axis-item/crosshair.tooltip.component.d.ts +18 -0
  8. package/chart/category-axis-item/labels.component.d.ts +58 -0
  9. package/chart/category-axis-item/notes.label.component.d.ts +22 -0
  10. package/chart/category-axis-item/title.component.d.ts +25 -0
  11. package/chart/category-axis-item.component.d.ts +38 -0
  12. package/chart/chart-area.component.d.ts +20 -0
  13. package/chart/legend.component.d.ts +46 -0
  14. package/chart/pane/title.component.d.ts +18 -0
  15. package/chart/pane-defaults/title.component.d.ts +18 -0
  16. package/chart/pane-defaults.component.d.ts +8 -0
  17. package/chart/pane.component.d.ts +18 -51
  18. package/chart/panes.component.d.ts +8 -32
  19. package/chart/plot-area.component.d.ts +18 -0
  20. package/chart/series-defaults/labels.component.d.ts +20 -0
  21. package/chart/series-defaults/labels.from.component.d.ts +20 -0
  22. package/chart/series-defaults/labels.to.component.d.ts +20 -0
  23. package/chart/series-defaults/notes.icon.component.d.ts +8 -0
  24. package/chart/series-defaults/notes.label.component.d.ts +21 -0
  25. package/chart/series-defaults/tooltip.component.d.ts +12 -0
  26. package/chart/series-defaults.component.d.ts +16 -0
  27. package/chart/series-item/error-bars.component.d.ts +4 -0
  28. package/chart/series-item/extremes.component.d.ts +8 -0
  29. package/chart/series-item/highlight.component.d.ts +4 -0
  30. package/chart/series-item/labels.component.d.ts +25 -0
  31. package/chart/series-item/labels.from.component.d.ts +20 -0
  32. package/chart/series-item/labels.to.component.d.ts +20 -0
  33. package/chart/series-item/markers.component.d.ts +12 -0
  34. package/chart/series-item/notes.icon.component.d.ts +10 -0
  35. package/chart/series-item/notes.label.component.d.ts +26 -0
  36. package/chart/series-item/outliers.component.d.ts +10 -0
  37. package/chart/series-item/tooltip.component.d.ts +8 -0
  38. package/chart/series-item.component.d.ts +287 -0
  39. package/chart/series.component.d.ts +8 -18
  40. package/chart/subtitle.component.d.ts +24 -57
  41. package/chart/title.component.d.ts +37 -56
  42. package/chart/tooltip.component.d.ts +16 -0
  43. package/chart/value-axis-item/crosshair.component.d.ts +15 -0
  44. package/chart/value-axis-item/crosshair.tooltip.component.d.ts +16 -0
  45. package/chart/value-axis-item/labels.component.d.ts +43 -0
  46. package/chart/value-axis-item/notes.icon.component.d.ts +8 -0
  47. package/chart/value-axis-item/notes.label.component.d.ts +21 -0
  48. package/chart/value-axis-item/title.component.d.ts +24 -0
  49. package/chart/value-axis-item.component.d.ts +35 -0
  50. package/chart/value-axis.component.d.ts +6 -26
  51. package/chart/x-axis-item/crosshair.component.d.ts +12 -0
  52. package/chart/x-axis-item/crosshair.tooltip.component.d.ts +18 -0
  53. package/chart/x-axis-item/labels.component.d.ts +29 -0
  54. package/chart/x-axis-item/notes.icon.component.d.ts +8 -0
  55. package/chart/x-axis-item/notes.label.component.d.ts +22 -0
  56. package/chart/x-axis-item/title.component.d.ts +25 -0
  57. package/chart/x-axis-item.component.d.ts +13 -0
  58. package/chart/y-axis-item/labels.component.d.ts +42 -0
  59. package/chart/y-axis-item/notes.icon.component.d.ts +8 -0
  60. package/chart/y-axis-item/notes.label.component.d.ts +22 -0
  61. package/chart/y-axis-item/title.component.d.ts +25 -0
  62. package/chart/y-axis-item.component.d.ts +23 -0
  63. package/chart-breadcrumb.component.d.ts +2 -0
  64. package/chart.component.d.ts +15 -45
  65. package/esm2020/chart/pane.component.mjs +10 -51
  66. package/esm2020/chart/panes.component.mjs +8 -32
  67. package/esm2020/chart/series.component.mjs +8 -18
  68. package/esm2020/chart/subtitle.component.mjs +4 -57
  69. package/esm2020/chart/title.component.mjs +5 -56
  70. package/esm2020/chart/value-axis.component.mjs +7 -27
  71. package/esm2020/chart-breadcrumb.component.mjs +13 -6
  72. package/esm2020/chart.component.mjs +6 -45
  73. package/esm2020/package-metadata.mjs +2 -2
  74. package/fesm2015/progress-kendo-angular-charts.mjs +63 -295
  75. package/fesm2020/progress-kendo-angular-charts.mjs +63 -295
  76. package/field-types/line-style.d.ts +3 -3
  77. package/option-types/plot-area.interface.d.ts +1 -1
  78. package/option-types/series-defaults/tooltip.interface.d.ts +1 -1
  79. package/option-types/series-item/labels.from.interface.d.ts +9 -9
  80. package/option-types/series-item/labels.to.interface.d.ts +9 -9
  81. package/option-types/series-item.interface.d.ts +0 -7
  82. package/package.json +7 -7
@@ -17,80 +17,367 @@ import * as i0 from "@angular/core";
17
17
  export declare class SeriesItemComponent extends CollectionItemComponent implements Series {
18
18
  protected configurationService: ConfigurationService;
19
19
  protected collectionService: CollectionService;
20
+ /**
21
+ * The aggregate function for the date series.
22
+ * The function is used when a category (year, month, or other) contains two or more points.
23
+ * The Chart displays the return value of the function instead of the individual points.
24
+ * The `aggregate` option is supported for categorical chart axis only.
25
+ *
26
+ * The supported values are:
27
+ * - `"avg"`—The average of all values for the date period.
28
+ * - `"count"`—The number of values for the date period.
29
+ * - `"max"`—The highest value for the date period.
30
+ * - `"min"`—The lowest value for the date period.
31
+ * - `"sum"`—The sum of all values for the date period. Defaults to `0` if no data points are defined.
32
+ * - `"sumOrNull"`—The sum of all values for the date period. Defaults to `null` if no data points are
33
+ * defined.
34
+ * - `"first"`—The first value.
35
+ * - function (values, series, dataItems, category)—A user-defined aggregate function. Returns a single
36
+ * value or a data item.
37
+ * - object (compound aggregate)—Applicable to the Candlestick, Box Plot, and OHLC series.
38
+ * Specifies the aggregate for each data item field..
39
+ *
40
+ * @default 'max'
41
+ */
20
42
  aggregate: any;
43
+ /**
44
+ * If set to `true`, the Chart automatically scales down to fit the content area.
45
+ * Applicable for the Pie and Donut series. ([See example]({% slug donut_seriestypes_charts %}#toc-displaying-labels))
46
+ * @default false
47
+ */
21
48
  autoFit: boolean;
49
+ /**
50
+ * The name of the value axis.
51
+ * The axis option is supported for Scatter plots. For more information on Scatter plots, refer to
52
+ * [`xAxis`]({% slug api_charts_xaxis %}) and [`yAxis`]({% slug api_charts_yaxis %}).
53
+ * @default 'primary'
54
+ */
22
55
  axis: string;
23
56
  border: Border;
24
57
  categoryAxis: string;
58
+ /**
59
+ * The data item field which contains the category name or date.
60
+ * If the category is a date, the points are rendered in chronological order.
61
+ * @default 'category'
62
+ */
25
63
  categoryField: string;
64
+ /**
65
+ * The data field that contains the `close` value.
66
+ * The `closeField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"candlestick"` or `"ohlc"`.
67
+ * @default 'close'
68
+ */
26
69
  closeField: string;
27
70
  color: any;
71
+ /**
72
+ * The data item field which contains the series color.
73
+ * The `colorField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type)
74
+ * is set to `"bar"`, `"column"`, `"rangeBar"`, `"rangeColumn"`, `"bubble"`, `"donut"`, `"pie"`, `"candlestick"`,
75
+ * `"ohlc"`, or `"waterfall"`.
76
+ * @default 'color'
77
+ */
28
78
  colorField: string;
29
79
  connectors: LabelConnectors;
80
+ /**
81
+ * The data item field which contains the current value.
82
+ * The `currentField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bullet"` or `"verticalBullet"`.
83
+ * @default 'current'
84
+ */
30
85
  currentField: string;
86
+ /**
87
+ * The dash type of line Chart.
88
+ * The `dashType` option is considered only if the [`series.type`]({% slug api_charts_series %}#toc-type) option is set to `"line"`.
89
+ * @default 'solid'
90
+ */
31
91
  dashType: DashType;
32
92
  data: any[];
33
93
  downColor: string;
94
+ /**
95
+ * The data field which contains the color that is applied when the `open` value is greater than the `close` value.
96
+ * The `downColorField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"candlestick"`.
97
+ * @default 'downColor'
98
+ */
34
99
  downColorField: string;
35
100
  drilldownField: string;
101
+ /**
102
+ * The `dynamicHeight` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"funnel"`.
103
+ * When set to `false`, all segments become with the same height.
104
+ * Otherwise, the height of each segment is based on its value.
105
+ * @default true
106
+ */
36
107
  dynamicHeight: boolean;
108
+ /**
109
+ * The option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"funnel"`.
110
+ * When set to `true`, the ratio of the bases of each segment is calculated based on the ratio of
111
+ * `currentDataItem.value`/`nextDataItem.value`.
112
+ * The last element is always created like a rectangle since there is no following element.
113
+ * @default false
114
+ */
37
115
  dynamicSlope: boolean;
116
+ /**
117
+ * The data item field which contains the [`series.errorBars`]({% slug api_charts_series %}#toc-errorbars) high value.
118
+ * The `errorHighField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bar"`, `"column"`, `"line"`, or `"area"`.
119
+ * @default 'errorHigh'
120
+ */
38
121
  errorHighField: string;
122
+ /**
123
+ * The data item field which contains the [`series.errorBars`]({% slug api_charts_series %}#toc-errorbars) low value.
124
+ * The `errorLowField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bar"`, `"column"`, `"line"`, or `"area"`.
125
+ * @default 'errorLow'
126
+ */
39
127
  errorLowField: string;
128
+ /**
129
+ * The data item field which contains a Boolean value indicating whether the sector is exploded.
130
+ * The `explodeField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"donut"` or `"pie"`.
131
+ * @default 'explode'
132
+ */
40
133
  explodeField: string;
134
+ /**
135
+ * The data item field which contains the series value.
136
+ * @default 'value'
137
+ */
41
138
  field: string;
139
+ /**
140
+ * The data item field which contains the series from value.
141
+ * @default 'min'
142
+ */
42
143
  fromField: string;
144
+ /**
145
+ * The distance between the categories expressed as a percentage of the bar width.
146
+ * See the related spacing setting.
147
+ * The `gap` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bar"`, `"column"`, `"candlestick"`, `"ohlc"`,
148
+ * `"radarColumn"`, or `"waterfall"`.
149
+ * @default 1.5
150
+ */
43
151
  gap: number;
152
+ /**
153
+ * The data field which contains the high value.
154
+ * The `highField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"candlestick"` or `"ohlc"`.
155
+ * @default 'hight'
156
+ */
44
157
  highField: string;
45
158
  holeSize: number;
46
159
  line: SeriesLine;
160
+ /**
161
+ * The data field containing the low value.
162
+ * The `lowField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"candlestick"` or `"ohlc"`.
163
+ * @default 'low'
164
+ */
47
165
  lowField: string;
166
+ /**
167
+ * The data item field which contains the series lower value.
168
+ * The `lowerField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
169
+ * @default 'lower'
170
+ */
48
171
  lowerField: string;
172
+ /**
173
+ * The margin around each donut series (ring). A numeric value sets all margins.
174
+ * @default 1
175
+ */
49
176
  margin: Margin | number;
177
+ /**
178
+ * The maximum size of the Chart bubble series marker.
179
+ * @default 100
180
+ */
50
181
  maxSize: number;
51
182
  mean: SeriesMean;
183
+ /**
184
+ * The data item field which contains the series mean value.
185
+ * The `meanField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
186
+ * @default 'mean'
187
+ */
52
188
  meanField: string;
53
189
  median: SeriesMedian;
190
+ /**
191
+ * The data item field which contains the series median value.
192
+ * The `medianField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
193
+ * @default 'median'
194
+ */
54
195
  medianField: string;
196
+ /**
197
+ * The minimum size of the Chart bubble series marker.
198
+ * @default 5
199
+ */
55
200
  minSize: number;
56
201
  missingValues: 'gap' | 'interpolate' | 'zero';
57
202
  name: string;
203
+ /**
204
+ * Specifies the top-base/bottom-base ratio of the whole Chart. If the `neckRatio` is set to `3`,
205
+ * it means the top base is three times smaller than the bottom base.
206
+ * The `neckRatio` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"funnel"` and `dynamicSlope` is set to `false`.
207
+ * @default 0.3
208
+ */
58
209
  neckRatio: number;
59
210
  negativeColor: string;
60
211
  negativeValues: NegativeBubbleValues;
212
+ /**
213
+ * The data item field which contains the series note text.
214
+ * @default 'noteText'
215
+ */
61
216
  noteTextField: string;
217
+ /**
218
+ * The opacity of the series. By default, the series are opaque.
219
+ * @default 1
220
+ */
62
221
  opacity: number;
63
222
  openField: string;
223
+ /**
224
+ * The data item field which contains the series outliers value.
225
+ * The `outliersField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
226
+ * @default 'outliers'
227
+ */
64
228
  outliersField: string;
65
229
  overlay: Overlay;
66
230
  padding: number;
231
+ /**
232
+ * The data item field which contains the series `q1` value.
233
+ * The `q1Field` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
234
+ * @default 'q1'
235
+ */
67
236
  q1Field: string;
237
+ /**
238
+ * The data item field which contains the series `q3` value.
239
+ * The `q3Field` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
240
+ * @default 'q3'
241
+ */
68
242
  q3Field: string;
243
+ /**
244
+ * The space in pixels between the different segments of the Funnel Chart.
245
+ * The `segmentSpacing` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"funnel"`.
246
+ * @default 0
247
+ */
69
248
  segmentSpacing: number;
70
249
  size: number;
250
+ /**
251
+ * The data field which contains the bubble size value.
252
+ * @default 'size'
253
+ */
71
254
  sizeField: string;
255
+ /**
256
+ * The distance between series points within a category. Expressed as a percentage of the bar width.
257
+ * See the related `gap` setting.
258
+ * The spacing option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bar"`, `"column"`, `"candlestick"`, `"ohlc"`, or
259
+ * `"radarColumn"`.
260
+ * @default 0.4
261
+ */
72
262
  spacing: number;
263
+ /**
264
+ * A Boolean value which indicates if the series have to be stacked.
265
+ * A string value is interpreted as [`series.stack.group`]({% slug api_charts_seriesstack %}#toc-group).
266
+ *
267
+ * The `stack` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bar"`, `"column"`, `"line"`, `"area"`,
268
+ * `"verticalLine"`, `"verticalArea"`, `"radarLine"`, `"radarArea"`, and `"radarColumn"`.
269
+ * If not overridden, the stack settings of the first series are inherited as a default value by the rest of the series.
270
+ * @default false
271
+ */
73
272
  stack: boolean | string | SeriesStack;
273
+ /**
274
+ * The start angle (in degrees) of the first Donut or Pie segment.
275
+ * Angles increase clockwise with zero to the left. Negative values are acceptable.
276
+ * @default 90
277
+ */
74
278
  startAngle: number;
279
+ /**
280
+ * The `style` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to
281
+ * `"line"`, `"scatterLine"`, `"radarLine"`, or `"polarLine"`.
282
+ * @default 'normal'
283
+ */
75
284
  style: LineStyle;
285
+ /**
286
+ * The data item field which contains the summary type for the Waterfall series.
287
+ * The value (if any) of a data item marked as a summary point will be discarded.
288
+ *
289
+ * Summary columns are optional and can be one of two types:
290
+ *
291
+ * `"runningTotal"`—Displays the sum of all items since the last `"runningTotal"` point.
292
+ * `"total"`—Displays the sum of all previous items.
293
+ * @default 'summary'
294
+ */
76
295
  summaryField: string;
77
296
  target: BulletTarget;
297
+ /**
298
+ * The data item field which contains the series to value.
299
+ * @default 'max'
300
+ */
78
301
  toField: string;
302
+ /**
303
+ * The type of the series.
304
+ * @default 'column'
305
+ */
79
306
  type: SeriesType;
307
+ /**
308
+ * The data item field which contains the series upper value.
309
+ * The `upperField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"boxPlot"`.
310
+ * @default 'upper'
311
+ */
80
312
  upperField: string;
313
+ /**
314
+ * Sets the visible property of a Chart series.
315
+ * @default true
316
+ */
81
317
  visible: boolean;
318
+ /**
319
+ * A value which indicates whether to show the point category (for Funnel, Donut, and Pie series)
320
+ * or the series name (for other available series types) in the legend.
321
+ * @default true
322
+ */
82
323
  visibleInLegend: boolean;
83
324
  visibleInLegendField: string;
84
325
  visual: (e: SeriesVisualArgs) => drawing.Element;
85
326
  width: number;
86
327
  whiskers: SeriesWhiskers;
328
+ /**
329
+ * The name of the X axis.
330
+ * The [`xAxis`]({% slug api_charts_xaxis %}) option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bubble"`, `"scatter"`, `"scatterLine"`, or `"polar"` series.
331
+ * For the Polar series, the [`xAxis`]({% slug api_charts_xaxis %}) range is expressed in degrees.
332
+ * @default 'primary'
333
+ */
87
334
  xAxis: string;
335
+ /**
336
+ * The data item field which contains the [`series.errorBars`]({% slug api_charts_series %}#toc-errorbars) xAxis low value.
337
+ * The `xErrorLowField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"scatter"`, `"scatterLine"`, or
338
+ * `"bubble"`.
339
+ * @default 'xErrorHigh'
340
+ */
88
341
  xErrorHighField: string;
342
+ /**
343
+ * The data item field containing the x value.
344
+ * The `xField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bubble"`, `"scatter"`, `"scatterLine"`, or
345
+ * `"polar"` series.
346
+ * @default 'xErrorLow'
347
+ */
89
348
  xErrorLowField: string;
349
+ /**
350
+ * The data item field containing the x value.
351
+ * The `xField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bubble"`, `"scatter"`, `"scatterLine"`, or
352
+ * `"polar"` series.
353
+ * @default 'x'
354
+ */
90
355
  xField: string;
356
+ /**
357
+ * The name of the Y axis to use.
358
+ * Available for the Bubble, Scatter, Scatter Line, and Polar series.
359
+ * @default 'primary'
360
+ */
91
361
  yAxis: string;
362
+ /**
363
+ * The data item field which contains the [`series.errorBars`]({% slug api_charts_series %}#toc-errorbars) yAxis high value.
364
+ * The `yErrorHighField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"scatter"`, `"scatterLine"`, or
365
+ * `"bubble"`.
366
+ * @default 'yErrorHigh'
367
+ */
92
368
  yErrorHighField: string;
369
+ /**
370
+ * The data item field which contains the [`series.errorBars`]({% slug api_charts_series %}#toc-errorbars) yAxis low value.
371
+ * The `yErrorLowField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"scatter"`, `"scatterLine"`, or
372
+ * `"bubble"`.
373
+ * @default 'yErrorLow'
374
+ */
93
375
  yErrorLowField: string;
376
+ /**
377
+ * The data item field containing the y value.
378
+ * The `yField` option is supported when [`series.type`]({% slug api_charts_series %}#toc-type) is set to `"bubble"`, `"scatter"`, or `"scatterLine"`.
379
+ * @default 'y'
380
+ */
94
381
  yField: string;
95
382
  zIndex: number;
96
383
  errorBars: SeriesErrorBars;
@@ -10,26 +10,16 @@ import { ConfigurationService } from '../common/configuration.service';
10
10
  import { TooltipTemplateService } from '../common/tooltip-template.service';
11
11
  import * as i0 from "@angular/core";
12
12
  /**
13
- * A collection of one or more series items.
13
+ * A collection of one or more series items. [See example](slug:series_chart_charts).
14
14
  *
15
15
  * @example
16
- * ```ts
17
- * import { Component } from '@angular/core';
18
- *
19
- * _@Component({
20
- * selector: 'my-app',
21
- * template: `
22
- * <kendo-chart>
23
- * <kendo-chart-series>
24
- * <kendo-chart-series-item type="line" [data]="[1, 2, 3]">
25
- * </kendo-chart-series-item>
26
- * </kendo-chart-series>
27
- * </kendo-chart>
28
- * `
29
- * })
30
- * class AppComponent {
31
- * }
32
- *
16
+ * ```html
17
+ * <kendo-chart>
18
+ * <kendo-chart-series>
19
+ * <kendo-chart-series-item type="line" [data]="[1, 2, 3]">
20
+ * </kendo-chart-series-item>
21
+ * </kendo-chart-series>
22
+ * </kendo-chart>
33
23
  * ```
34
24
  */
35
25
  export declare class SeriesComponent extends CollectionComponent implements AfterContentChecked {
@@ -12,76 +12,43 @@ import * as i0 from "@angular/core";
12
12
  * ([see example]({% slug title_chart_charts %})).
13
13
  *
14
14
  * @example
15
- * ```ts-preview
16
- * import { Component } from '@angular/core';
17
- *
18
- * _@Component({
19
- * selector: 'my-app',
20
- * template: `
21
- * <kendo-chart [categoryAxis]="{ categories: categories }">
22
- * <kendo-chart-title text="Gross domestic product growth"></kendo-chart-title>
23
- * <kendo-chart-subtitle text="/GDP annual %/"></kendo-chart-subtitle>
24
- * <kendo-chart-legend
25
- * position="bottom"
26
- * orientation="horizontal"
27
- * align="end"
28
- * background="rgba(255, 0, 0, 0.1)"
29
- * [border]="borderOptions"
30
- * [margin]="10"
31
- * [padding]="10"
32
- * [width]="150"
33
- * [offsetX]="11"
34
- * [offsetY]="-103"
35
- * [reverse]="true"
36
- * [visible]="isVisible"
37
- * ></kendo-chart-legend>
38
- * <kendo-chart-tooltip format="{0}%"></kendo-chart-tooltip>
39
- * <kendo-chart-series>
40
- * <kendo-chart-series-item *ngFor="let item of series"
41
- * type="line" style="smooth" [data]="item.data" [name]="item.name">
42
- * </kendo-chart-series-item>
43
- * </kendo-chart-series>
44
- * </kendo-chart>
45
- * <br /><br />
46
- * <button kendoButton (click)="isVisible=!isVisible">Toggle Legend</button>
47
- * `
48
- * })
49
- * export class AppComponent {
50
- * public isVisible = true;
51
- * public borderOptions = {
52
- * color: "rgba(255, 0, 0, 0.8)",
53
- * dashType: 'dash',
54
- * width: 2
55
- * };
56
- *
57
- * public series: any[] = [{
58
- * name: "India",
59
- * data: [3.907, 7.943, 7.848, 9.284, 9.263, 9.801, 3.890, 8.238, 9.552, 6.855]
60
- * }, {
61
- * name: "Russian Federation",
62
- * data: [4.743, 7.295, 7.175, 6.376, 8.153, 8.535, 5.247, -7.832, 4.3, 4.3]
63
- * }, {
64
- * name: "Germany",
65
- * data: [0.010, -0.375, 1.161, 0.684, 3.7, 3.269, 1.083, -5.127, 3.690, 2.995]
66
- * },{
67
- * name: "World",
68
- * data: [1.988, 2.733, 3.994, 3.464, 4.001, 3.939, 1.333, -2.245, 4.339, 2.727]
69
- * }];
70
- * public categories: number[] = [2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011];
71
- * }
15
+ * ```html
16
+ * <kendo-chart [categoryAxis]="{ categories: categories }">
17
+ * <kendo-chart-subtitle text="/GDP annual %/"></kendo-chart-subtitle>
18
+ * </kendo-chart>
72
19
  * ```
73
20
  */
74
21
  export declare class SubtitleComponent extends SettingsComponent implements Subtitle {
75
22
  configurationService: ConfigurationService;
76
23
  align: 'center' | 'left' | 'right';
24
+ /**
25
+ * The background color of the subtitle. Accepts a valid CSS color string, including HEX and RGB.
26
+ *
27
+ * @default 'white'
28
+ */
77
29
  background: string;
78
30
  border: Border;
79
31
  color: string;
32
+ /**
33
+ * The font of the subtitle.
34
+ *
35
+ * @default '12px sans-serif'
36
+ */
80
37
  font: string;
81
38
  margin: Margin | number;
82
39
  padding: Padding | number;
40
+ /**
41
+ * The position of the subtitle.
42
+ *
43
+ * @default 'top'
44
+ */
83
45
  position: 'top' | 'bottom';
84
46
  text: string;
47
+ /**
48
+ * If set to `true`, the Chart displays the subtitle.
49
+ *
50
+ * @default true
51
+ */
85
52
  visible: boolean;
86
53
  constructor(configurationService: ConfigurationService);
87
54
  static ɵfac: i0.ɵɵFactoryDeclaration<SubtitleComponent, never>;
@@ -12,75 +12,56 @@ import * as i0 from "@angular/core";
12
12
  * ([see example]({% slug title_chart_charts %})).
13
13
  *
14
14
  * @example
15
- * ```ts-preview
16
- * import { Component } from '@angular/core';
17
- *
18
- * _@Component({
19
- * selector: 'my-app',
20
- * template: `
21
- * <kendo-chart [categoryAxis]="{ categories: categories }">
22
- * <kendo-chart-title text="Gross domestic product growth /GDP annual %/"></kendo-chart-title>
23
- * <kendo-chart-legend
24
- * position="bottom"
25
- * orientation="horizontal"
26
- * align="end"
27
- * background="rgba(255, 0, 0, 0.1)"
28
- * [border]="borderOptions"
29
- * [margin]="10"
30
- * [padding]="10"
31
- * [width]="150"
32
- * [offsetX]="11"
33
- * [offsetY]="-103"
34
- * [reverse]="true"
35
- * [visible]="isVisible"
36
- * ></kendo-chart-legend>
37
- * <kendo-chart-tooltip format="{0}%"></kendo-chart-tooltip>
38
- * <kendo-chart-series>
39
- * <kendo-chart-series-item *ngFor="let item of series"
40
- * type="line" style="smooth" [data]="item.data" [name]="item.name">
41
- * </kendo-chart-series-item>
42
- * </kendo-chart-series>
43
- * </kendo-chart>
44
- * <br /><br />
45
- * <button kendoButton (click)="isVisible=!isVisible">Toggle Legend</button>
46
- * `
47
- * })
48
- * export class AppComponent {
49
- * public isVisible = true;
50
- * public borderOptions = {
51
- * color: "rgba(255, 0, 0, 0.8)",
52
- * dashType: 'dash',
53
- * width: 2
54
- * };
55
- *
56
- * public series: any[] = [{
57
- * name: "India",
58
- * data: [3.907, 7.943, 7.848, 9.284, 9.263, 9.801, 3.890, 8.238, 9.552, 6.855]
59
- * }, {
60
- * name: "Russian Federation",
61
- * data: [4.743, 7.295, 7.175, 6.376, 8.153, 8.535, 5.247, -7.832, 4.3, 4.3]
62
- * }, {
63
- * name: "Germany",
64
- * data: [0.010, -0.375, 1.161, 0.684, 3.7, 3.269, 1.083, -5.127, 3.690, 2.995]
65
- * },{
66
- * name: "World",
67
- * data: [1.988, 2.733, 3.994, 3.464, 4.001, 3.939, 1.333, -2.245, 4.339, 2.727]
68
- * }];
69
- * public categories: number[] = [2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011];
70
- * }
15
+ * ```html
16
+ * <kendo-chart [categoryAxis]="{ categories: categories }">
17
+ * <kendo-chart-title text="Gross domestic product growth /GDP annual %/"></kendo-chart-title>
18
+ * ...
19
+ * </kendo-chart>
71
20
  * ```
72
21
  */
73
22
  export declare class TitleComponent extends SettingsComponent implements Title {
74
23
  configurationService: ConfigurationService;
24
+ /**
25
+ * The alignment of the title.
26
+ * The alignment options for text include `center` for middle alignment, `left` for left alignment, and `right` for right alignment, allowing for flexible positioning of the title.
27
+ *
28
+ * @default 'center'
29
+ */
75
30
  align: 'center' | 'left' | 'right';
31
+ /**
32
+ * The background color of the title. Accepts a valid CSS color string, including HEX and RGB.
33
+ *
34
+ * @default 'white'
35
+ */
76
36
  background: string;
77
37
  border: Border;
78
38
  color: string;
39
+ /**
40
+ * The font of the title.
41
+ *
42
+ * @default '16px sans-serif'
43
+ */
79
44
  font: string;
80
45
  margin: Margin | number;
46
+ /**
47
+ * The padding of the title. A numeric value sets all paddings.
48
+ *
49
+ * @default 5
50
+ */
81
51
  padding: Padding | number;
52
+ /**
53
+ * The position of the title.
54
+ * The positioning options for titles include `bottom` for positioning at the bottom and `top` for positioning at the top, providing flexibility in title placement.
55
+ *
56
+ * @default 'top'
57
+ */
82
58
  position: 'top' | 'bottom';
83
59
  text: string;
60
+ /**
61
+ * If set to `true`, the Chart displays the title.
62
+ *
63
+ * @default true
64
+ */
84
65
  visible: boolean;
85
66
  constructor(configurationService: ConfigurationService);
86
67
  static ɵfac: i0.ɵɵFactoryDeclaration<TitleComponent, never>;
@@ -21,11 +21,27 @@ export declare class TooltipComponent extends SettingsComponent implements Toolt
21
21
  background: string;
22
22
  border: Border;
23
23
  color: string;
24
+ /**
25
+ * The font of the tooltip.
26
+ * @default '12px sans-serif'
27
+ */
24
28
  font: string;
25
29
  format: string;
30
+ /**
31
+ * The opacity of the tooltip.
32
+ * @default 1
33
+ */
26
34
  opacity: number;
27
35
  padding: Padding | number;
36
+ /**
37
+ * If set to `true`, the Chart displays a single tooltip for every category.
38
+ * @default false
39
+ */
28
40
  shared: boolean;
41
+ /**
42
+ * If set to `true`, the Chart displays the series tooltip.
43
+ * @default false
44
+ */
29
45
  visible: boolean;
30
46
  seriesTooltipTemplate: SeriesTooltipTemplateDirective;
31
47
  sharedTooltipTemplate: SharedTooltipTemplateDirective;
@@ -12,8 +12,23 @@ import * as i0 from "@angular/core";
12
12
  export declare class ValueAxisCrosshairComponent extends SettingsComponent implements ValueAxisCrosshair {
13
13
  configurationService: ConfigurationService;
14
14
  color: string;
15
+ /**
16
+ * The opacity of the crosshair.
17
+ *
18
+ * @default 1
19
+ */
15
20
  opacity: number;
21
+ /**
22
+ * If set to `true`, the Chart displays the value axis crosshair.
23
+ *
24
+ * @default false
25
+ */
16
26
  visible: boolean;
27
+ /**
28
+ * The width of the crosshair in pixels.
29
+ *
30
+ * @default 1
31
+ */
17
32
  width: number;
18
33
  tooltip: ValueAxisCrosshairTooltip;
19
34
  constructor(configurationService: ConfigurationService);