Skip to content

Commit dc2ab8a

Browse files
authored
Merge pull request #6795 from syncfusion-content/983838-BulletChartUG
983838: Updated the UG content and example changes in the bullet chart.
2 parents 4801441 + c980d20 commit dc2ab8a

File tree

13 files changed

+438
-241
lines changed

13 files changed

+438
-241
lines changed

blazor/bullet-chart/accessibility.md

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

1010
# Accessibility in Blazor Bullet Chart Component
1111

12-
The Blazor Bullet 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+
The Blazor Bullet Chart component adheres to 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 Bullet Chart component is outlined below.
14+
The following table summarizes the accessibility compliance for the Blazor Bullet Chart component:
1515

1616
| Accessibility Criteria | Compatibility |
1717
| -- | -- |
@@ -37,36 +37,36 @@ The accessibility compliance for the Blazor Bullet Chart component is outlined b
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-
The Blazor Bullet 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 Bullet Chart component:
42+
The Blazor Bullet Chart component implements [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) patterns to ensure accessibility. The following ARIA attributes and roles are used:
4343

4444
* img (role)
4545
* button (role)
4646
* region (role)
4747
* aria-label (attribute)
4848
* aria-pressed (attribute)
4949

50-
## Keyboard interaction
50+
## Keyboard Interaction
5151

52-
The Blazor Bullet 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 Bullet Chart component.
52+
The Blazor Bullet Chart component supports [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/alert/#keyboardinteraction), making it accessible for users who rely on assistive technologies or keyboard navigation. The following keyboard shortcuts are supported:
5353

5454
| Windows | Mac | Description |
5555
| --- | --- | --- |
56-
|<kbd>Alt</kbd> + <kbd>J</kbd> | <kbd>⌥</kbd> + <kbd>J</kbd> | Moves the focus to the Bullet Chart element. |
57-
| <kbd>Tab</kbd> | <kbd>Tab</kbd> | Moves the focus to the next element in the Bullet Chart. |
58-
| <kbd>Shift</kbd> + <kbd>Tab</kbd> | <kbd>⇧</kbd> + <kbd>Tab</kbd> | Moves the focus to the previous element in the Bullet Chart. |
59-
| <kbd>↑</kbd> / <kbd>→</kbd> | <kbd>↑</kbd> / <kbd>→</kbd> | Moves the focus to the legend right side from the selected legend. |
60-
| <kbd>↓</kbd> / <kbd>←</kbd> | <kbd>↓</kbd> / <kbd>←</kbd> | Moves the focus to the legend left side from the selected legend. |
56+
|<kbd>Alt</kbd> + <kbd>J</kbd> | <kbd>⌥</kbd> + <kbd>J</kbd> | Moves focus to the Bullet Chart element. |
57+
| <kbd>Tab</kbd> | <kbd>Tab</kbd> | Moves focus to the next element in the Bullet Chart. |
58+
| <kbd>Shift</kbd> + <kbd>Tab</kbd> | <kbd>⇧</kbd> + <kbd>Tab</kbd> | Moves focus to the previous element in the Bullet Chart. |
59+
| <kbd>↑</kbd> / <kbd>→</kbd> | <kbd>↑</kbd> / <kbd>→</kbd> | Moves focus to the legend right side from the selected legend. |
60+
| <kbd>↓</kbd> / <kbd>←</kbd> | <kbd>↓</kbd> / <kbd>←</kbd> | Moves focus to the legend left side from the selected legend. |
6161
| <kbd>Ctrl + P</kbd> | <kbd>⌘</kbd> + <kbd>P</kbd> | Prints the Bullet Chart. |
6262

63-
## Ensuring accessibility
63+
## Ensuring Accessibility
6464

65-
The Blazor Bullet Chart component's accessibility levels are ensured through an [accessibility-checker](https://www.npmjs.com/package/accessibility-checker) and [axe-core](https://www.npmjs.com/package/axe-core) software tools during automated testing.
65+
Accessibility is validated using [accessibility-checker](https://www.npmjs.com/package/accessibility-checker) and [axe-core](https://www.npmjs.com/package/axe-core) tools during automated testing.
6666

67-
The accessibility compliance of the Blazor Bullet Chart component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/bullet-chart) in a new window to evaluate the accessibility of the Blazor Bullet Chart component with accessibility tools.
67+
To evaluate accessibility, open the [sample](https://blazor.syncfusion.com/accessibility/bullet-chart) in a new window and use accessibility tools.
6868

6969

70-
## See also
70+
## See Also
7171

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

blazor/bullet-chart/actual-bar.md

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,61 @@
11
---
22
layout: post
33
title: Actual Bar in Blazor Bullet Chart Component | Syncfusion
4-
description: Checkout and learn here all about Actual Bar in Syncfusion Blazor Bullet Chart component and much more.
4+
description: Check out and learn how to display and customize Actual Bar in Syncfusion Blazor Bullet Chart component.
55
platform: Blazor
66
control: Bullet Chart
77
documentation: ug
88
---
99

1010
# Actual Bar in Blazor Bullet Chart Component
1111

12-
To display the primary data or the current value of the data being measured known as the **Feature Measure** that should be encoded as a bar. This is called as the **Actual Bar** or the **Feature Bar** in the Bullet Chart, and to display the actual bar the [ValueField](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueField) should be mapped to the appropriate field from the data source.
12+
The **Actual Bar** (also known as the **Feature Bar**) visually represents the primary or current value being measured in the Bullet Chart. To display the actual bar, map the [ValueField](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueField) property to the appropriate field in your data source.
1313

1414
```cshtml
15+
1516
@using Syncfusion.Blazor.Charts
1617
1718
<SfBulletChart DataSource="@BulletChartData" ValueField="FieldValue" Minimum="0" Maximum="30" Interval="5">
1819
<BulletChartRangeCollection>
19-
<BulletChartRange End=20> </BulletChartRange>
20+
<BulletChartRange End=20></BulletChartRange>
2021
<BulletChartRange End=25></BulletChartRange>
2122
<BulletChartRange End=30></BulletChartRange>
2223
</BulletChartRangeCollection>
2324
</SfBulletChart>
2425
25-
@code{
26+
@code {
2627
public class ChartData
2728
{
2829
public double FieldValue { get; set; }
2930
}
31+
3032
public List<ChartData> BulletChartData = new List<ChartData>
3133
{
3234
new ChartData { FieldValue = 23}
3335
};
3436
}
37+
3538
```
3639
{% previewsample "https://blazorplayground.syncfusion.com/embed/BNVyXuBzBauPiECo?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
3740

3841
![Actual Bar in Blazor Bullet Chart](images/blazor-bullet-chart-actual-bar.png)
3942

40-
## Types of actual bar
43+
## Types of Actual Bar
4144

42-
The shape of the actual bar can be customized using the [Type](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_Type) property of the Bullet Chart. The actual bar contains [Rect](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.FeatureType.html#Syncfusion_Blazor_Charts_FeatureType_Rect) and [Dot](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.FeatureType.html#Syncfusion_Blazor_Charts_FeatureType_Dot) shapes. By default, the actual bar shape is [Rect](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.FeatureType.html#Syncfusion_Blazor_Charts_FeatureType_Rect).
45+
The shape of the actual bar can be customized using the [Type](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_Type) property. The available shapes are [Rect](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.FeatureType.html#Syncfusion_Blazor_Charts_FeatureType_Rect) (default) and [Dot](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.FeatureType.html#Syncfusion_Blazor_Charts_FeatureType_Dot).
4346

4447
```cshtml
48+
4549
@using Syncfusion.Blazor.Charts
4650
4751
<SfBulletChart DataSource="@BulletChartData" Type="FeatureType.Dot" ValueField="FieldValue" Minimum="0" Maximum="30" Interval="5">
4852
<BulletChartRangeCollection>
49-
<BulletChartRange End=20> </BulletChartRange>
53+
<BulletChartRange End=20></BulletChartRange>
5054
<BulletChartRange End=25></BulletChartRange>
5155
<BulletChartRange End=30></BulletChartRange>
5256
</BulletChartRangeCollection>
5357
</SfBulletChart>
58+
5459
```
5560

5661
N> Refer to the [code block](#actual-bar-in-blazor-bullet-chart-component) to know more about the property value of the **BulletChartData**.
@@ -59,15 +64,16 @@ N> Refer to the [code block](#actual-bar-in-blazor-bullet-chart-component) to kn
5964

6065
![Blazor Bullet Chart with Dot Actual Bar](images/blazor-bullet-chart-dot-actual-bar.png)
6166

62-
## Actual bar customization
67+
## Customizing the Actual Bar
6368

64-
The following properties will be used to customize the actual bar.
69+
The following properties are available to customize the appearance of the actual bar:
6570

66-
* [ValueFill](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueFill) - Specifies the fill color of the actual bar.
67-
* [ValueHeight](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueHeight) - Specifies the width of the actual bar.
68-
* [BulletChartValueBorder](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.BulletChartValueBorder.html) - Specifies the border color and the border width of the actual bar.
71+
* [ValueFill](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueFill) – Sets the fill color of the actual bar.
72+
* [ValueHeight](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.SfBulletChart-1.html#Syncfusion_Blazor_Charts_SfBulletChart_1_ValueHeight) – Sets the width of the actual bar.
73+
* [BulletChartValueBorder](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.BulletChartValueBorder.html) – Sets the border color and width of the actual bar.
6974

7075
```cshtml
76+
7177
@using Syncfusion.Blazor.Charts
7278
7379
<SfBulletChart DataSource="@BulletChartData" ValueFill="lightblue" ValueHeight="15" ValueField="FieldValue" Minimum="0" Maximum="30" Interval="5">
@@ -78,10 +84,11 @@ The following properties will be used to customize the actual bar.
7884
<BulletChartRange End=30></BulletChartRange>
7985
</BulletChartRangeCollection>
8086
</SfBulletChart>
87+
8188
```
8289

8390
N> Refer to the [code block](#actual-bar-in-blazor-bullet-chart-component) to know more about the property value of the **BulletChartData**.
8491

8592
{% previewsample "https://blazorplayground.syncfusion.com/embed/LZVIDEVTKZNwIDPb?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
8693

87-
![Customizing Actual Bar in Blazor Bullet Chart](images/blazor-bullet-chart-actual-bar-customization.png)
94+
![Customizing Actual Bar in Blazor Bullet Chart](images/blazor-bullet-chart-actual-bar-customization.png)

0 commit comments

Comments
 (0)