Skip to content

Commit b96870b

Browse files
Merge pull request #6735 from syncfusion-content/983366-dashboard
Updated the UG document for Dashboard Layout Component
2 parents 6a4485d + 952c067 commit b96870b

16 files changed

+146
-135
lines changed

blazor/dashboard-layout/accessibility.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ documentation: ug
99

1010
# Accessibility in Blazor Dashboard Layout Component
1111

12-
The [Blazor Dashboard Layout](https://www.syncfusion.com/blazor-components/blazor-dashboard) component has been designed keeping in mind the [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/) specifications, by applying the prompt `WAI-ARIA` roles, states, and properties. This component is characterized by ARIA accessibility support, which makes navigation easy for people who use assistive technologies (AT).
12+
The [Blazor Dashboard Layout](https://www.syncfusion.com/blazor-components/blazor-dashboard) component is designed with a strong focus on accessibility, adhering to the [WAI-ARIA (Web Accessibility Initiative - Accessible Rich Internet Applications)](https://www.w3.org/WAI/ARIA/apg/patterns/) specifications. It applies appropriate WAI-ARIA roles, states, and properties to ensure intuitive navigation and interaction for users relying on assistive technologies (AT).
1313

14-
The Blazor Dashboard Layout 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.
14+
The component follows established accessibility guidelines and standards, including the [ADA (Americans with Disabilities Act)](https://www.ada.gov/), [Section 508](https://www.section508.gov/), and [WCAG 2.2 (Web Content Accessibility Guidelines)](https://www.w3.org/TR/WCAG22/) standards. It also incorporates [WCAG roles](https://www.w3.org/TR/wai-aria/#roles) that are commonly used to evaluate accessibility features.
1515

1616
The accessibility compliance for the Blazor Dashboard Layout component is outlined below.
1717

@@ -39,25 +39,26 @@ The accessibility compliance for the Blazor Dashboard Layout component is outlin
3939

4040
<div><img src="https://cdn.syncfusion.com/content/images/landing-page/no.png" alt="No"> - The component does not meet the requirement.</div>
4141

42-
## WAI-ARIA attributes
42+
## WAI-ARIA Attributes
4343

44-
The Blazor Dashboard Layout component followed the [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/) patterns to meet the accessibility. The following ARIA attributes are used in the Dashboard Layout component:
44+
The Blazor Dashboard Layout component integrates [WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/) patterns to enhance accessibility. The following ARIA attributes are used within the Dashboard Layout component:
4545

4646
| **Attributes** | **Purpose** |
4747
| --- | --- |
4848
| role=presentation | Indicates the role as a presentation for the table when the `showGridLines` property is enabled. |
4949
| aria-grabbed | Indicates whether the attribute is set to `true`. It has been selected for dragging. If this attribute is set to `false`, the element can be grabbed for a drag-and-drop operation, but will not be currently grabbed.|
5050

51-
## Keyboard interaction
51+
## Keyboard Interaction
5252

5353
Keyboard support is not applicable for the Dashboard Layout.
5454

55-
## Ensuring accessibility
55+
## Ensuring Accessibility
5656

57-
The Blazor Dashboard Layout component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) software tool during automated testing.
57+
The accessibility levels of the Blazor Dashboard Layout component are verified through automated testing using the [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) software tool.
5858

59-
The accessibility compliance of the Dashboard Layout component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/dashboardlayout) in a new window to evaluate the accessibility of the Dashboard Layout component with accessibility tools.
6059

61-
## See also
60+
A sample demonstrating the accessibility compliance of the Dashboard Layout component is available. Open the [sample](https://blazor.syncfusion.com/accessibility/dashboardlayout) in a new window to evaluate its accessibility using various tools.
61+
62+
## See Also
6263

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

blazor/dashboard-layout/faq/all-panels-rendered-at-the-same-position.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: post
3-
title: Preventing Panel Overlap in Blazor Dashboard Layout Component | Syncfusion
3+
title: Prevent Panel Overlap in Blazor Dashboard | Syncfusion
44
description: Check out and learn how to preventing panel overlap in the Syncfusion Blazor Dashboard Layout component.
55
platform: Blazor
66
control: Dashboard Layout
@@ -9,9 +9,11 @@ documentation: ug
99

1010
# Preventing Panel Overlap in Blazor Dashboard Layout
1111

12-
When rendering [DashboardLayoutPanel](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Layouts.DashboardLayoutPanel.html) components dynamically, it is important to assign a unique [Id](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Layouts.DashboardLayoutPanel.html#Syncfusion_Blazor_Layouts_DashboardLayoutPanel_Id) to each panel. The **Id** property is used internally by the Dashboard Layout component to uniquely identify and manage panels. If multiple panels are assigned the same **Id**, they will be treated as the same instance, and render in the same position (e.g., Row = 0, Column = 0). Assigning unique **Ids** ensures that each panel is rendered independently in its specified location.
12+
When dynamically rendering [DashboardLayoutPanel](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Layouts.DashboardLayoutPanel.html) components, panels may overlap if not configured correctly. This issue typically occurs when multiple panels are assigned the same [`Id`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Layouts.DashboardLayoutPanel.html#Syncfusion_Blazor_Layouts_DashboardLayoutPanel_Id) property. The Dashboard Layout component uses this `Id` internally to uniquely identify and manage each panel's position and state. If `Id` values are duplicated, the component treats these panels as the same instance, causing them to render in the same location (e.g., Row = 0, Column = 0) and visually overlap.
1313

14-
Here is an example of how to assign unique **Ids** to each panel:
14+
To ensure each panel renders independently in its specified location, assign a unique `Id` to every `DashboardLayoutPanel`.
15+
16+
Here is an example demonstrating how to assign unique `Id` values to dynamically generated panels:
1517

1618
```cshtml
1719
@@ -60,3 +62,5 @@ Here is an example of how to assign unique **Ids** to each panel:
6062
</style>
6163
6264
```
65+
{% previewsample "https://blazorplayground.syncfusion.com/embed/BXryNOLepGKtuKUL?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
66+
![Blazor DashboardLayout](../images/panel-overlap.png)

0 commit comments

Comments
 (0)