Skip to content

Commit ff30bb5

Browse files
authored
Merge pull request #6742 from syncfusion-content/983838-ChartFeatures2
983838: Updated the UG content and example changes in the chart control.
2 parents 9a7c27c + 5a2d999 commit ff30bb5

14 files changed

+1294
-1301
lines changed

blazor/chart/accessibility.md

Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
layout: post
33
title: Accessibility in Blazor Charts Component | Syncfusion
4-
description: Checkout and learn here all about Accessibility using Keyboard navigation in Syncfusion Blazor Charts component and more.
4+
description: Check out and learn here all about Accessibility using Keyboard navigation in Syncfusion Blazor Charts component.
55
platform: Blazor
66
control: Chart
77
documentation: ug
88
---
99

1010
# Accessibility in Blazor Chart Component
1111

12-
The Blazor Chart component followed the accessibility guidelines and standards, including [ADA](https://www.ada.gov/), [Section 508](https://www.section508.gov/), [WCAG 2.2](https://www.w3.org/TR/WCAG22/) standards, and [WCAG roles](https://www.w3.org/TR/wai-aria/#roles) that are commonly used to evaluate accessibility.
12+
Syncfusion Blazor Chart components comply with accessibility guidelines and standards, including [ADA](https://www.ada.gov/), [Section 508](https://www.section508.gov/), [WCAG 2.2](https://www.w3.org/TR/WCAG22/) and [WAI-ARIA roles](https://www.w3.org/TR/wai-aria/#roles) to ensure inclusive user experiences.
1313

14-
The accessibility compliance for the Blazor Chart component is outlined below.
14+
## Accessibility Compliance Overview
1515

1616
| Accessibility Criteria | Compatibility |
1717
| -- | -- |
@@ -37,19 +37,9 @@ The accessibility compliance for the Blazor Chart component is outlined below.
3737

3838
<div><img src="https://cdn.syncfusion.com/content/images/documentation/not-supported.png" alt="No"> - The component does not meet the requirement.</div>
3939

40-
## WAI-ARIA attributes
40+
## WAI-ARIA Attributes
4141

42-
WAI-ARIA(Accessibility Initiative - Accessible Rich Internet Applications) defines a way to increase the accessibility of web pages, dynamic content, and user interface components developed with AJAX, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components.
43-
44-
Element |Default description
45-
-----|-----
46-
Datalabel |Reads the Point y value.
47-
Legend |Click to show or hide the series.
48-
Axis Title |Reads the axis title.
49-
Chart Title |Reads the chart title.
50-
Series Points |Reads the Point x: Point y value.
51-
52-
The Blazor Chart component followed the [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) patterns to meet the accessibility. The following ARIA attributes are used in the Blazor Chart component:
42+
WAI-ARIA (Web Accessibility Initiative – Accessible Rich Internet Applications) increases the accessibility of web pages and UI components. The Blazor Chart component uses the following ARIA roles and attributes:
5343

5444
* img (role)
5545
* button (role)
@@ -58,9 +48,17 @@ The Blazor Chart component followed the [WAI-ARIA](https://www.w3.org/WAI/ARIA/a
5848
* aria-hidden (attribute)
5949
* aria-pressed (attribute)
6050

61-
## Keyboard navigation
51+
| Element | Description |
52+
|---------|-------------|
53+
| Data label | Reads the Point y value. |
54+
| Legend | Click to show or hide the series. |
55+
| Axis Title | Reads the axis title. |
56+
| Chart Title | Reads the chart title. |
57+
| Series Points | Reads the Point x: Point y value. |
6258

63-
The Blazor Chart component followed the [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/alert/#keyboardinteraction) guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Blazor Chart component.
59+
## Keyboard Navigation
60+
61+
Syncfusion Blazor Charts support keyboard navigation for users relying on assistive technologies. The following keyboard shortcuts are available:
6462

6563
| Windows | Mac | Description |
6664
|-----|-----|---|
@@ -69,8 +67,8 @@ The Blazor Chart component followed the [keyboard interaction](https://www.w3.or
6967
|<kbd>Shift</kbd> + <kbd>Tab</kbd> | <kbd>⇧</kbd> + <kbd>Tab</kbd> | Moves the focus to the previous element in the chart.|
7068
| <kbd>↓</kbd> | <kbd>↓</kbd> | Moves the focus to the data point right side from the selected point.|
7169
| <kbd>↑</kbd> | <kbd>↑</kbd> | Moves the focus to the data point right side from the selected point.|
72-
| <kbd>←</kbd> | <kbd>←</kbd> | Moves the focus to the next series in our Chart component.|
73-
| <kbd>→</kbd> | <kbd>→</kbd> | Moves the focus to the previous series in our Chart component.|
70+
| <kbd>←</kbd> | <kbd>←</kbd> | Moves the focus to the next series in the Chart component.|
71+
| <kbd>→</kbd> | <kbd>→</kbd> | Moves the focus to the previous series in the Chart component.|
7472
|<kbd>Enter</kbd> / <kbd>Space</kbd> | <kbd>Enter</kbd> / <kbd>Space</kbd> | Selects the data point in the series|
7573
| <kbd>↓</kbd> , <kbd>←</kbd> | <kbd>↓</kbd> / <kbd>←</kbd> | Moves the focus to the legend left side from the selected legend.|
7674
| <kbd>↑</kbd> , <kbd>→</kbd> | <kbd>↑</kbd> / <kbd>→</kbd> | Moves the focus to the legend right side from the selected legend.|
@@ -82,15 +80,14 @@ The Blazor Chart component followed the [keyboard interaction](https://www.w3.or
8280
|<kbd>R</kbd> | <kbd>R</kbd> | Reset the zoomed chart.|
8381
|<kbd>Ctrl + P</kbd> | <kbd>⌘</kbd> + <kbd>P</kbd> | Prints the Chart.|
8482

85-
## Ensuring accessibility
83+
## Ensuring Accessibility
8684

87-
The Blazor Chart component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests.
85+
Accessibility levels are validated using [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) and Playwright tests.
8886

89-
The accessibility compliance of the Blazor Chart component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/chart) in a new window to evaluate the accessibility of the Blazor Chart component with accessibility tools.
87+
Evaluate accessibility in the [Blazor Chart accessibility sample](https://blazor.syncfusion.com/accessibility/chart) using accessibility tools.
9088

9189
## See also
9290

9391
* [Accessibility in Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components](https://blazor.syncfusion.com/documentation/common/accessibility)
9492

9593
* [Accessibility Customization in Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components](./advanced-accessibility-configuration.md)
96-

blazor/chart/adaptive-layout.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
layout: post
33
title: Adaptive Layout in Blazor Charts Component | Syncfusion
4-
description: Checkout and learn here all about Adaptive Layout in Syncfusion Blazor Charts component and much more.
4+
description: Check out and learn how to configure and utilize Adaptive Layout in Syncfusion Blazor Charts component.
55
platform: Blazor
66
control: Chart
77
documentation: ug
88
---
99

1010
# Adaptive Layout in Blazor Charts Component
1111

12-
When viewing the chart on a mobile device, some elements may not be displayed properly due to limited screen space. This is where the **Syncfusion<sup style="font-size:70%">&reg;</sup> Chart Adaptive Layout** feature proves invaluable. Adaptive rendering dynamically adjusts chart elements to optimize their display based on the available screen size and orientation. By enabling the `EnableAdaptiveRendering` property, the chart automatically adapts to container size changes, ensuring clear alignment and proper visibility of elements such as the legend, axis titles, axis labels, data labels, chart title, and more.
12+
Adaptive layout in Blazor Charts ensures optimal display of chart elements on mobile devices and screens with limited space. By enabling the `EnableAdaptiveRendering` property, the chart automatically adjusts to container size changes, maintaining clear alignment and visibility for elements such as legend, axis titles, axis labels, data labels, chart title, and more.
1313

1414
```cshtml
1515
@@ -78,24 +78,23 @@ When viewing the chart on a mobile device, some elements may not be displayed pr
7878

7979
![Adaptive Layout in Blazor Chart](images/adaptive-layout/blazor-chart-adaptive-layout.png)
8080

81-
The table below outlines the behavior of various chart elements under specific conditions determined by the chart's height and width:
82-
81+
The table below outlines the behavior of chart elements based on chart height and width:
8382

8483
| Element | Size | Behavior |
85-
|--------------|------------------ |---------------------|
84+
|--------------|------------------|------------------|
8685
| Chart Title | <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> | Chart title is disabled |
87-
| Chart Sutitle | <kbd>Height &lt; 300</kbd> / <kbd>Width &lt; 300</kbd> | Chart subtitle is disabled |
88-
| Axes | <kbd>Height &lt;= 200</kbd> / <kbd>Width &lt;= 200</kbd> | Horizontal/Vertical axis titles and scrollbars are disabled |
89-
| Axes Label | <kbd>Height &lt; 100</kbd> / <kbd>Width &lt; 100</kbd> <br> <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> <br> <kbd>Height &lt;= 400</kbd> / <kbd>Width &lt;= 400</kbd> | Horizontal/Vertical axis labels are disabled <br><br> Axis labels move inside the chart <br><br> Axis numeric labels are formatted with M, K and B |
90-
| Legend | <kbd>Height &lt; 300</kbd> / <kbd>Width &lt; 300</kbd> | Moves the bottom or top legend to the right if the width is greater than 200px; otherwise, it is disabled / Moves the right or left legend to the bottom if the height is greater than 200px; otherwise, it is disabled |
91-
| Marker | <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> | Marker is disabled in the chart |
86+
| Chart Subtitle | <kbd>Height &lt; 300</kbd> / <kbd>Width &lt; 300</kbd> | Chart subtitle is disabled |
87+
| Axes | <kbd>Height &lt;= 200</kbd> / <kbd>Width &lt;= 200</kbd> | Axis titles and scrollbars are disabled |
88+
| Axes Label | <kbd>Height &lt; 100</kbd> / <kbd>Width &lt; 100</kbd> <br> <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> <br> <kbd>Height &lt;= 400</kbd> / <kbd>Width &lt;= 400</kbd> | Axis labels are disabled <br> Axis labels move inside the chart <br> Axis numeric labels are formatted with M, K, and B |
89+
| Legend | <kbd>Height &lt; 300</kbd> / <kbd>Width &lt; 300</kbd> | Bottom/top legend moves to right if width > 200px; otherwise, disabled. Right/left legend moves to bottom if height > 200px; otherwise, disabled |
90+
| Marker | <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> | Marker is disabled |
9291
| Zoom Toolkit | <kbd>Height &lt; 200</kbd> / <kbd>Width &lt; 200</kbd> | Zoom toolkit is disabled |
93-
| Datalabel <br> (Column and Bar Chart Types)| | Datalabel rotates based on rectangle size. If it exceeds the available size, it is hidden |
92+
| Datalabel <br> (Column and Bar Chart Types)| | Datalabel rotates based on rectangle size; hidden if it exceeds available size |
9493

9594
N> Refer to our [Blazor Charts](https://www.syncfusion.com/blazor-components/blazor-charts) feature tour page for its groundbreaking feature representations and also explore our [Blazor Chart Example](https://blazor.syncfusion.com/demos/chart/line?theme=bootstrap5) to know various chart types and how to represent time-dependent data, showing trends at equal intervals.
9695

9796
## See also
9897

9998
* [Data label](./data-labels)
10099
* [Tooltip](./tool-tip)
101-
* [Marker](./data-markers)
100+
* [Marker](./data-markers)

blazor/chart/advanced-accessibility-configuration.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: post
33
title: Accessibility Customization in Blazor Charts Component | Syncfusion
4-
description: Checkout and learn here all about Accessibility Customization in Syncfusion Blazor Charts component and more.
4+
description: Check out and learn here all about Accessibility Customization in Syncfusion Blazor Charts component.
55
platform: Blazor
66
control: Chart
77
documentation: ug
@@ -112,7 +112,7 @@ In blazor chart component, the [ChartTitleStyle](https://help.syncfusion.com/cr/
112112
<SfChart Title="Browser Statics in 2024" SubTitle="-In Percentage">
113113
<ChartTitleStyle AccessibilityDescription="Chart Title" AccessibilityRole="text" Focusable="true"></ChartTitleStyle>
114114
<ChartSubTitleStyle Focusable="false"></ChartSubTitleStyle>
115-
<ChartPrimaryXAxis ValueType="Syncfusion.Blazor.Charts.ValueType.Category"></ChartPrimaryXAxis>
115+
<ChartPrimaryXAxis ValueType="Syncfusion.Blazor.Charts.ValueType.Category" />
116116
<ChartSeriesCollection>
117117
<ChartSeries Name="Browsers-2024" XName="Browser" YName="Users" DataSource="@StatisticsDetails">
118118
</ChartSeries>
@@ -151,7 +151,7 @@ The [ChartAnnotations](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.C
151151
@using Syncfusion.Blazor.Charts
152152
153153
<SfChart Title="Browser Statics in 2024" SubTitle="-In Percentage">
154-
<ChartPrimaryXAxis ValueType="Syncfusion.Blazor.Charts.ValueType.Category"></ChartPrimaryXAxis>
154+
<ChartPrimaryXAxis ValueType="Syncfusion.Blazor.Charts.ValueType.Category" />
155155
<ChartAnnotations AccessibilityDescription="Arrows Used to Indicate High and Low Users in Browsers" AccessibilityRole="text" Focusable="true">
156156
<ChartAnnotation X="StatisticsDetails[0].Browser" Y="65.3" CoordinateUnits="Units.Point">
157157
<ContentTemplate>
@@ -317,6 +317,4 @@ The [ChartLegendSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazo
317317
}
318318
319319
```
320-
321-
Here is a preview sample demonstrating the accessibility customization support for all chart elements:
322-
{% previewsample "https://blazorplayground.syncfusion.com/embed/hDhfXnWhVHFlrqSz?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
320+
{% previewsample "https://blazorplayground.syncfusion.com/embed/hDheDaVdUIUQJdGO?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}

0 commit comments

Comments
 (0)