@vaadin/charts 25.0.0-alpha19 → 25.0.0-alpha20

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vaadin/charts",
3
- "version": "25.0.0-alpha19",
3
+ "version": "25.0.0-alpha20",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -34,16 +34,16 @@
34
34
  ],
35
35
  "dependencies": {
36
36
  "@open-wc/dedupe-mixin": "^1.3.0",
37
- "@vaadin/component-base": "25.0.0-alpha19",
38
- "@vaadin/vaadin-themable-mixin": "25.0.0-alpha19",
37
+ "@vaadin/component-base": "25.0.0-alpha20",
38
+ "@vaadin/vaadin-themable-mixin": "25.0.0-alpha20",
39
39
  "highcharts": "12.2.0",
40
40
  "lit": "^3.0.0"
41
41
  },
42
42
  "devDependencies": {
43
- "@vaadin/chai-plugins": "25.0.0-alpha19",
44
- "@vaadin/test-runner-commands": "25.0.0-alpha19",
43
+ "@vaadin/chai-plugins": "25.0.0-alpha20",
44
+ "@vaadin/test-runner-commands": "25.0.0-alpha20",
45
45
  "@vaadin/testing-helpers": "^2.0.0",
46
- "@vaadin/vaadin-lumo-styles": "25.0.0-alpha19",
46
+ "@vaadin/vaadin-lumo-styles": "25.0.0-alpha20",
47
47
  "sinon": "^21.0.0"
48
48
  },
49
49
  "cvdlName": "vaadin-chart",
@@ -51,5 +51,5 @@
51
51
  "web-types.json",
52
52
  "web-types.lit.json"
53
53
  ],
54
- "gitHead": "1f9af1ce5f0bae8daff044176c8a8df697763881"
54
+ "gitHead": "c948aae591a30b432f3784000d4677674cae56e0"
55
55
  }
@@ -34,7 +34,7 @@ const tooltipStyles = (scope) => css`
34
34
 
35
35
  ${unsafeCSS(scope)} .highcharts-tooltip text,
36
36
  ${unsafeCSS(scope)} .highcharts-tooltip foreignObject span {
37
- fill: var(--highcharts-neutral-color-80, var(--vaadin-charts-data-label, var(--vaadin-color)));
37
+ fill: var(--highcharts-neutral-color-80, var(--vaadin-charts-data-label, var(--vaadin-text-color)));
38
38
  }
39
39
 
40
40
  ${unsafeCSS(scope)} .highcharts-tooltip .highcharts-tracker {
@@ -44,7 +44,7 @@ const tooltipStyles = (scope) => css`
44
44
 
45
45
  ${unsafeCSS(scope)} .highcharts-tooltip .highcharts-header {
46
46
  font-size: 0.85em;
47
- color: var(--highcharts-neutral-color-60, var(--vaadin-color-subtle));
47
+ color: var(--highcharts-neutral-color-60, var(--vaadin-text-color-secondary));
48
48
  }
49
49
 
50
50
  ${unsafeCSS(scope)} .highcharts-tooltip-box {
@@ -115,17 +115,17 @@ export const chartStyles = css`
115
115
  --_color-positive: light-dark(#19b156, #1ccc62);
116
116
  --_color-negative: light-dark(#dc0611, #f7353f);
117
117
 
118
- --_label: var(--vaadin-charts-label, var(--vaadin-color));
119
- --_secondary-label: var(--vaadin-charts-secondary-label, var(--vaadin-color-subtle));
120
- --_disabled-label: var(--vaadin-charts-disabled-label, var(--vaadin-color-disabled));
118
+ --_label: var(--vaadin-charts-label, var(--vaadin-text-color));
119
+ --_secondary-label: var(--vaadin-charts-secondary-label, var(--vaadin-text-color-secondary));
120
+ --_disabled-label: var(--vaadin-charts-disabled-label, var(--vaadin-text-color-disabled));
121
121
  --_point-border: var(--vaadin-charts-point-border, var(--_bg));
122
- --_axis-line: var(--vaadin-charts-axis-line, var(--vaadin-border-color-subtle));
122
+ --_axis-line: var(--vaadin-charts-axis-line, var(--vaadin-border-color-secondary));
123
123
  --_axis-title: var(--vaadin-charts-axis-title, var(--_secondary-label));
124
124
  --_axis-label: var(--vaadin-charts-axis-label, var(--_secondary-label));
125
- --_grid-line: var(--vaadin-charts-grid-line, var(--vaadin-border-color-subtle));
125
+ --_grid-line: var(--vaadin-charts-grid-line, var(--vaadin-border-color-secondary));
126
126
  --_minor-grid-line: var(
127
127
  --vaadin-charts-minor-grid-line,
128
- color-mix(in srgb, var(--vaadin-border-color-subtle) 60%, transparent)
128
+ color-mix(in srgb, var(--vaadin-border-color-secondary) 60%, transparent)
129
129
  );
130
130
  --_data-label: var(--vaadin-charts-data-label, var(--_label));
131
131
  }
@@ -359,100 +359,110 @@ export const chartStyles = css`
359
359
  :where([styled-mode]) .highcharts-color-0 {
360
360
  fill: var(--_color-0);
361
361
  stroke: var(--_color-0);
362
- color: var(--_color-0-label);
363
362
  }
364
363
 
365
364
  :where([styled-mode]) .highcharts-color-1 {
366
365
  fill: var(--_color-1);
367
366
  stroke: var(--_color-1);
368
- color: var(--_color-1-label);
369
367
  }
370
368
 
371
369
  :where([styled-mode]) .highcharts-color-2 {
372
370
  fill: var(--_color-2);
373
371
  stroke: var(--_color-2);
374
- color: var(--_color-2-label);
375
372
  }
376
373
 
377
374
  :where([styled-mode]) .highcharts-color-3 {
378
375
  fill: var(--_color-3);
379
376
  stroke: var(--_color-3);
380
- color: var(--_color-2-label);
381
377
  }
382
378
 
383
379
  :where([styled-mode]) .highcharts-color-4 {
384
380
  fill: var(--_color-4);
385
381
  stroke: var(--_color-4);
386
- color: var(--_color-4-label);
387
382
  }
388
383
 
389
384
  :where([styled-mode]) .highcharts-color-5 {
390
385
  fill: var(--_color-5);
391
386
  stroke: var(--_color-5);
392
- color: var(--_color-5-label);
393
387
  }
394
388
 
395
389
  :where([styled-mode]) .highcharts-color-6 {
396
390
  fill: var(--_color-6);
397
391
  stroke: var(--_color-6);
398
- color: var(--_color-6-label);
399
392
  }
400
393
 
401
394
  :where([styled-mode]) .highcharts-color-7 {
402
395
  fill: var(--_color-7);
403
- stroke: var(--_color-7);
404
396
  color: var(--_color-7-label);
405
397
  }
406
398
 
407
399
  :where([styled-mode]) .highcharts-color-8 {
408
400
  fill: var(--_color-8);
409
401
  stroke: var(--_color-8);
410
- color: var(--_color-8-label);
411
402
  }
412
403
 
413
404
  :where([styled-mode]) .highcharts-color-9 {
414
405
  fill: var(--_color-9);
415
406
  stroke: var(--_color-9);
416
- color: var(--_color-9-label);
417
407
  }
418
408
 
419
- :where([styled-mode]) .highcharts-data-label-color-0 {
409
+ :where([styled-mode])
410
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
411
+ .highcharts-data-label-color-0 {
420
412
  color: var(--_color-0-label);
421
413
  }
422
414
 
423
- :where([styled-mode]) .highcharts-data-label-color-1 {
415
+ :where([styled-mode])
416
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
417
+ .highcharts-data-label-color-1 {
424
418
  color: var(--_color-1-label);
425
419
  }
426
420
 
427
- :where([styled-mode]) .highcharts-data-label-color-2 {
421
+ :where([styled-mode])
422
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
423
+ .highcharts-data-label-color-2 {
428
424
  color: var(--_color-2-label);
429
425
  }
430
426
 
431
- :where([styled-mode]) .highcharts-data-label-color-3 {
427
+ :where([styled-mode])
428
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
429
+ .highcharts-data-label-color-3 {
432
430
  color: var(--_color-3-label);
433
431
  }
434
432
 
435
- :where([styled-mode]) .highcharts-data-label-color-4 {
433
+ :where([styled-mode])
434
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
435
+ .highcharts-data-label-color-4 {
436
436
  color: var(--_color-4-label);
437
437
  }
438
438
 
439
- :where([styled-mode]) .highcharts-data-label-color-5 {
439
+ :where([styled-mode])
440
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
441
+ .highcharts-data-label-color-5 {
440
442
  color: var(--_color-5-label);
441
443
  }
442
444
 
443
- :where([styled-mode]) .highcharts-data-label-color-6 {
445
+ :where([styled-mode])
446
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
447
+ .highcharts-data-label-color-6 {
444
448
  color: var(--_color-6-label);
445
449
  }
446
450
 
447
- :where([styled-mode]) .highcharts-data-label-color-7 {
451
+ :where([styled-mode])
452
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
453
+ .highcharts-data-label-color-7 {
448
454
  color: var(--_color-7-label);
449
455
  }
450
456
 
451
- :where([styled-mode]) .highcharts-data-label-color-8 {
457
+ :where([styled-mode])
458
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
459
+ .highcharts-data-label-color-8 {
452
460
  color: var(--_color-8-label);
453
461
  }
454
462
 
455
- :where([styled-mode]) .highcharts-data-label-color-9 {
463
+ :where([styled-mode])
464
+ :where(.highcharts-treemap-series, .highcharts-organization-series, .highcharts-gantt-series)
465
+ .highcharts-data-label-color-9 {
456
466
  color: var(--_color-9-label);
457
467
  }
458
468
 
@@ -776,6 +786,10 @@ export const chartStyles = css`
776
786
  stroke-width: 0;
777
787
  }
778
788
 
789
+ :where([styled-mode]) .highcharts-organization-series .highcharts-null-point {
790
+ fill: transparent;
791
+ }
792
+
779
793
  :where([styled-mode]) .highcharts-polygon-series .highcharts-graph {
780
794
  fill: inherit;
781
795
  stroke-width: 0;
@@ -944,7 +958,10 @@ export const chartStyles = css`
944
958
  }
945
959
 
946
960
  :where([styled-mode]) .highcharts-button-disabled text {
947
- fill: var(--highcharts-neutral-color-80, var(--vaadin-charts-button-disabled-label, var(--vaadin-color-disabled)));
961
+ fill: var(
962
+ --highcharts-neutral-color-80,
963
+ var(--vaadin-charts-button-disabled-label, var(--vaadin-text-color-disabled))
964
+ );
948
965
  }
949
966
 
950
967
  :where([styled-mode]) .highcharts-range-selector-buttons .highcharts-button {
@@ -1106,7 +1123,7 @@ export const chartStyles = css`
1106
1123
  }
1107
1124
 
1108
1125
  :where([styled-mode]) .highcharts-null-point {
1109
- fill: var(--highcharts-neutral-color-3, transparent);
1126
+ fill: var(--highcharts-neutral-color-3, var(--vaadin-charts-button-background, var(--vaadin-background-container)));
1110
1127
  }
1111
1128
 
1112
1129
  /* 3d charts */
package/web-types.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/charts",
4
- "version": "25.0.0-alpha19",
4
+ "version": "25.0.0-alpha20",
5
5
  "description-markup": "markdown",
6
6
  "contributions": {
7
7
  "html": {
@@ -235,7 +235,7 @@
235
235
  },
236
236
  {
237
237
  "name": "vaadin-chart",
238
- "description": "`<vaadin-chart>` is a Web Component for creating high quality charts.\n\n### Basic use\n\nThere are two ways of configuring your `<vaadin-chart>` element: **HTML API**, **JS API** and **JSON API**.\nNote that you can make use of all APIs in your element.\n\n#### Using HTML API\n\n`vaadin-chart` has a set of attributes to make it easier for you to customize your chart.\n\n```html\n<vaadin-chart title=\"The chart title\" subtitle=\"The chart subtitle\">\n <vaadin-chart-series\n type=\"column\"\n title=\"The series title\"\n values=\"[10, 20, 30]\"\n ></vaadin-chart-series>\n</vaadin-chart>\n```\n\n> Note that while you can set type for each series individually, for some types, such as `'bar'`, `'gauge'` and `'solidgauge'`, you\n> have to set it as the default series type on `<vaadin-chart>` in order to work properly.\n\n#### Using JS API\n\nUse [`configuration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha19/#/elements/vaadin-chart#property-configuration) property to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\n\n// Wait for default configuration to be ready\nrequestAnimationFrame(() => {\n const configuration = chart.configuration;\n configuration.setTitle({ text: 'The chart title' });\n // By default there is one X axis, it is referenced by configuration.xAxis[0].\n configuration.xAxis[0].setCategories(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']);\n configuration.addSeries({\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n });\n});\n```\n\n#### Using JS JSON API\n\nUse [`updateConfiguration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha19/#/elements/vaadin-chart#method-updateConfiguration) method to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\nchart.updateConfiguration({\n title: {\n text: 'The chart title'\n },\n subtitle: {\n text: 'Subtitle'\n },\n xAxis: {\n categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']\n },\n series: [{\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n }]\n});\n```\n\n**Note:** chart style customization cannot be done via the JS or JSON API.\nStyling properties in the JSON configuration will be ignored. The following section discusses chart styling.\n\n### CSS Styling\n\nChart appearance is primarily controlled by CSS style rules.\nA comprehensive list of the supported style classes can be found at\nhttps://www.highcharts.com/docs/chart-design-and-style/style-by-css\n\nSee also the [Chart Styling](https://vaadin.com/docs/latest/components/charts/css-styling) documentation.\n\n### RTL support\n\n`vaadin-charts` as well as [Highcharts](https://www.highcharts.com/) by itself are not adjusting the layout\nbased on the `dir` attribute. In order to make `vaadin-charts` display RTL content properly additional\nJSON configuration should be used.\nEach chart should be updated based on the specific needs, but general recommendations are:\n\n 1. Set `reversed` to true for xAxis (https://api.highcharts.com/highcharts/xAxis.reversed).\n 2. Set `useHTML` to true for text elements, i.e. `tooltip` (https://api.highcharts.com/highcharts/tooltip.useHTML).\n 3. Set `rtl` to true for `legend` (https://api.highcharts.com/highcharts/legend.rtl).\n\n### Setting colors\n\nAlthough charts can be styled as described above, there is a simpler way for setting colors.\nColors can be set using CSS custom properties `--vaadin-charts-color-{n}` (where `n` goes from `0 - 9`).\n\nFor example `--vaadin-charts-color-0` sets the color of the first series on a chart.",
238
+ "description": "`<vaadin-chart>` is a Web Component for creating high quality charts.\n\n### Basic use\n\nThere are two ways of configuring your `<vaadin-chart>` element: **HTML API**, **JS API** and **JSON API**.\nNote that you can make use of all APIs in your element.\n\n#### Using HTML API\n\n`vaadin-chart` has a set of attributes to make it easier for you to customize your chart.\n\n```html\n<vaadin-chart title=\"The chart title\" subtitle=\"The chart subtitle\">\n <vaadin-chart-series\n type=\"column\"\n title=\"The series title\"\n values=\"[10, 20, 30]\"\n ></vaadin-chart-series>\n</vaadin-chart>\n```\n\n> Note that while you can set type for each series individually, for some types, such as `'bar'`, `'gauge'` and `'solidgauge'`, you\n> have to set it as the default series type on `<vaadin-chart>` in order to work properly.\n\n#### Using JS API\n\nUse [`configuration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha20/#/elements/vaadin-chart#property-configuration) property to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\n\n// Wait for default configuration to be ready\nrequestAnimationFrame(() => {\n const configuration = chart.configuration;\n configuration.setTitle({ text: 'The chart title' });\n // By default there is one X axis, it is referenced by configuration.xAxis[0].\n configuration.xAxis[0].setCategories(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']);\n configuration.addSeries({\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n });\n});\n```\n\n#### Using JS JSON API\n\nUse [`updateConfiguration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha20/#/elements/vaadin-chart#method-updateConfiguration) method to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\nchart.updateConfiguration({\n title: {\n text: 'The chart title'\n },\n subtitle: {\n text: 'Subtitle'\n },\n xAxis: {\n categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']\n },\n series: [{\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n }]\n});\n```\n\n**Note:** chart style customization cannot be done via the JS or JSON API.\nStyling properties in the JSON configuration will be ignored. The following section discusses chart styling.\n\n### CSS Styling\n\nChart appearance is primarily controlled by CSS style rules.\nA comprehensive list of the supported style classes can be found at\nhttps://www.highcharts.com/docs/chart-design-and-style/style-by-css\n\nSee also the [Chart Styling](https://vaadin.com/docs/latest/components/charts/css-styling) documentation.\n\n### RTL support\n\n`vaadin-charts` as well as [Highcharts](https://www.highcharts.com/) by itself are not adjusting the layout\nbased on the `dir` attribute. In order to make `vaadin-charts` display RTL content properly additional\nJSON configuration should be used.\nEach chart should be updated based on the specific needs, but general recommendations are:\n\n 1. Set `reversed` to true for xAxis (https://api.highcharts.com/highcharts/xAxis.reversed).\n 2. Set `useHTML` to true for text elements, i.e. `tooltip` (https://api.highcharts.com/highcharts/tooltip.useHTML).\n 3. Set `rtl` to true for `legend` (https://api.highcharts.com/highcharts/legend.rtl).\n\n### Setting colors\n\nAlthough charts can be styled as described above, there is a simpler way for setting colors.\nColors can be set using CSS custom properties `--vaadin-charts-color-{n}` (where `n` goes from `0 - 9`).\n\nFor example `--vaadin-charts-color-0` sets the color of the first series on a chart.",
239
239
  "attributes": [
240
240
  {
241
241
  "name": "category-max",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/charts",
4
- "version": "25.0.0-alpha19",
4
+ "version": "25.0.0-alpha20",
5
5
  "description-markup": "markdown",
6
6
  "framework": "lit",
7
7
  "framework-config": {
@@ -100,7 +100,7 @@
100
100
  },
101
101
  {
102
102
  "name": "vaadin-chart",
103
- "description": "`<vaadin-chart>` is a Web Component for creating high quality charts.\n\n### Basic use\n\nThere are two ways of configuring your `<vaadin-chart>` element: **HTML API**, **JS API** and **JSON API**.\nNote that you can make use of all APIs in your element.\n\n#### Using HTML API\n\n`vaadin-chart` has a set of attributes to make it easier for you to customize your chart.\n\n```html\n<vaadin-chart title=\"The chart title\" subtitle=\"The chart subtitle\">\n <vaadin-chart-series\n type=\"column\"\n title=\"The series title\"\n values=\"[10, 20, 30]\"\n ></vaadin-chart-series>\n</vaadin-chart>\n```\n\n> Note that while you can set type for each series individually, for some types, such as `'bar'`, `'gauge'` and `'solidgauge'`, you\n> have to set it as the default series type on `<vaadin-chart>` in order to work properly.\n\n#### Using JS API\n\nUse [`configuration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha19/#/elements/vaadin-chart#property-configuration) property to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\n\n// Wait for default configuration to be ready\nrequestAnimationFrame(() => {\n const configuration = chart.configuration;\n configuration.setTitle({ text: 'The chart title' });\n // By default there is one X axis, it is referenced by configuration.xAxis[0].\n configuration.xAxis[0].setCategories(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']);\n configuration.addSeries({\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n });\n});\n```\n\n#### Using JS JSON API\n\nUse [`updateConfiguration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha19/#/elements/vaadin-chart#method-updateConfiguration) method to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\nchart.updateConfiguration({\n title: {\n text: 'The chart title'\n },\n subtitle: {\n text: 'Subtitle'\n },\n xAxis: {\n categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']\n },\n series: [{\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n }]\n});\n```\n\n**Note:** chart style customization cannot be done via the JS or JSON API.\nStyling properties in the JSON configuration will be ignored. The following section discusses chart styling.\n\n### CSS Styling\n\nChart appearance is primarily controlled by CSS style rules.\nA comprehensive list of the supported style classes can be found at\nhttps://www.highcharts.com/docs/chart-design-and-style/style-by-css\n\nSee also the [Chart Styling](https://vaadin.com/docs/latest/components/charts/css-styling) documentation.\n\n### RTL support\n\n`vaadin-charts` as well as [Highcharts](https://www.highcharts.com/) by itself are not adjusting the layout\nbased on the `dir` attribute. In order to make `vaadin-charts` display RTL content properly additional\nJSON configuration should be used.\nEach chart should be updated based on the specific needs, but general recommendations are:\n\n 1. Set `reversed` to true for xAxis (https://api.highcharts.com/highcharts/xAxis.reversed).\n 2. Set `useHTML` to true for text elements, i.e. `tooltip` (https://api.highcharts.com/highcharts/tooltip.useHTML).\n 3. Set `rtl` to true for `legend` (https://api.highcharts.com/highcharts/legend.rtl).\n\n### Setting colors\n\nAlthough charts can be styled as described above, there is a simpler way for setting colors.\nColors can be set using CSS custom properties `--vaadin-charts-color-{n}` (where `n` goes from `0 - 9`).\n\nFor example `--vaadin-charts-color-0` sets the color of the first series on a chart.",
103
+ "description": "`<vaadin-chart>` is a Web Component for creating high quality charts.\n\n### Basic use\n\nThere are two ways of configuring your `<vaadin-chart>` element: **HTML API**, **JS API** and **JSON API**.\nNote that you can make use of all APIs in your element.\n\n#### Using HTML API\n\n`vaadin-chart` has a set of attributes to make it easier for you to customize your chart.\n\n```html\n<vaadin-chart title=\"The chart title\" subtitle=\"The chart subtitle\">\n <vaadin-chart-series\n type=\"column\"\n title=\"The series title\"\n values=\"[10, 20, 30]\"\n ></vaadin-chart-series>\n</vaadin-chart>\n```\n\n> Note that while you can set type for each series individually, for some types, such as `'bar'`, `'gauge'` and `'solidgauge'`, you\n> have to set it as the default series type on `<vaadin-chart>` in order to work properly.\n\n#### Using JS API\n\nUse [`configuration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha20/#/elements/vaadin-chart#property-configuration) property to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\n\n// Wait for default configuration to be ready\nrequestAnimationFrame(() => {\n const configuration = chart.configuration;\n configuration.setTitle({ text: 'The chart title' });\n // By default there is one X axis, it is referenced by configuration.xAxis[0].\n configuration.xAxis[0].setCategories(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']);\n configuration.addSeries({\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n });\n});\n```\n\n#### Using JS JSON API\n\nUse [`updateConfiguration`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha20/#/elements/vaadin-chart#method-updateConfiguration) method to set chart title, categories and data:\n\n```js\nconst chart = document.querySelector('vaadin-chart');\nchart.updateConfiguration({\n title: {\n text: 'The chart title'\n },\n subtitle: {\n text: 'Subtitle'\n },\n xAxis: {\n categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']\n },\n series: [{\n type: 'column',\n data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4]\n }]\n});\n```\n\n**Note:** chart style customization cannot be done via the JS or JSON API.\nStyling properties in the JSON configuration will be ignored. The following section discusses chart styling.\n\n### CSS Styling\n\nChart appearance is primarily controlled by CSS style rules.\nA comprehensive list of the supported style classes can be found at\nhttps://www.highcharts.com/docs/chart-design-and-style/style-by-css\n\nSee also the [Chart Styling](https://vaadin.com/docs/latest/components/charts/css-styling) documentation.\n\n### RTL support\n\n`vaadin-charts` as well as [Highcharts](https://www.highcharts.com/) by itself are not adjusting the layout\nbased on the `dir` attribute. In order to make `vaadin-charts` display RTL content properly additional\nJSON configuration should be used.\nEach chart should be updated based on the specific needs, but general recommendations are:\n\n 1. Set `reversed` to true for xAxis (https://api.highcharts.com/highcharts/xAxis.reversed).\n 2. Set `useHTML` to true for text elements, i.e. `tooltip` (https://api.highcharts.com/highcharts/tooltip.useHTML).\n 3. Set `rtl` to true for `legend` (https://api.highcharts.com/highcharts/legend.rtl).\n\n### Setting colors\n\nAlthough charts can be styled as described above, there is a simpler way for setting colors.\nColors can be set using CSS custom properties `--vaadin-charts-color-{n}` (where `n` goes from `0 - 9`).\n\nFor example `--vaadin-charts-color-0` sets the color of the first series on a chart.",
104
104
  "extension": true,
105
105
  "attributes": [
106
106
  {