You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: blazor/accordion/accessibility.md
+9-7Lines changed: 9 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
layout: post
3
3
title: Accessibility in Blazor Accordion Component | Syncfusion
4
-
description: Checkout and learn here all about Accessibility in Syncfusion Blazor Accordion componentand much more.
4
+
description: Checkout and learn here all about Accessibility in Syncfusion Blazor Accordion component, including WAI-ARIA support, keyboard interaction, and compliance with WCAG, Section 508, and ADA standards.
5
5
platform: Blazor
6
6
control: Accordion
7
7
documentation: ug
@@ -41,18 +41,20 @@ The accessibility compliance for the Blazor Accordion component is outlined belo
41
41
42
42
## WAI-ARIA attributes
43
43
44
+
The Syncfusion Blazor Accordion component automatically applies the following WAI-ARIA attributes to its elements to enhance accessibility:
45
+
44
46
| Attributes | Purpose |
45
47
|----------------------|---------------|
46
-
| role |**Button:**Attribute is set to the Accordion header elements to indicate that the element can be used to toggle the visibility of the associated content section, describing the actual role of the element.<br> **Region:** Attribute is set to the Accordion panel elements to create a landmark region that contains the currently expanded accordion panel, describing the actual role of the element.|
47
-
| aria-labelledby |Attribute is set to content (panel) and it points to the corresponding Accordion header.|
48
-
| aria-controls |Attribute is set to the header and it points to the corresponding Accordion content. |
49
-
| aria-expanded |Attribute is set to the Accordion header elements to indicates the expand state of the Accordion Item. Default value of this attribute is`false`. If an item is expanded, the attribute value changes to ‘true’. |
50
-
| aria-hidden |Attribute is set to the Accordion panel elements to indicates the content visible state of the Accordion Item. Default value of this attribute is `true`. If an item content is visible, the attribute value changes to `false`. |
48
+
| role |**Button:**Applied to the Accordion header elements, indicating they function as interactive buttons that toggle the visibility of their associated content sections. <br> **Region**: Applied to the Accordion panel elements, defining them as landmark regions that contain the currently expanded content, making them discoverable by assistive technologies. |
49
+
| aria-labelledby |This attribute is set on the Accordion content (panel) and points to the `id` of its corresponding Accordion header. This establishes a programmatic relationship, allowing screen readers to announce the header as the label for the content. |
50
+
| aria-controls |This attribute is set on the Accordion header and points to the `id` of its corresponding Accordion content. This indicates that the header controls the visibility of the specified content panel. |
51
+
| aria-expanded |Applied to the Accordion header elements, this attribute communicates the current expansion state of the Accordion item to assistive technologies. It has a default value of`false` (collapsed). When an item expands, its value programmatically changes to `true`. |
52
+
| aria-hidden |Applied to the Accordion panel elements, this attribute indicates whether the content is visible or hidden. A value of `true` means the content is hidden and not exposed to assistive technologies. Conversely, `false` means the content is visible. The default value is `true` for collapsed content, changing to `false` when the content becomes visible. |
51
53
| aria-disabled | It indicates the disabled state of the Accordion and its items. |
52
54
53
55
## Keyboard interaction
54
56
55
-
Keyboard navigation is enabled by default. The possible keys are:
57
+
Keyboard navigation is a fundamental aspect of accessibility and comes enabled by default in the Blazor Accordion. Users can navigate and interact with the Accordion items using the following keys:
Copy file name to clipboardExpand all lines: blazor/accordion/animations.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
layout: post
3
3
title: Animations in Blazor Accordion Component | Syncfusion
4
-
description: Checkout and learn here all about Animations in Syncfusion Blazor Accordion component and much more.
4
+
description: Customize expand and collapse animations in Syncfusion Blazor Accordion component using various effects, durations, and easing options for enhanced user experience.
5
5
platform: Blazor
6
6
control: Accordion
7
7
documentation: ug
@@ -13,7 +13,7 @@ The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accor
13
13
14
14
By default, the accordion uses `SlideDown` animation for expanding panels (set through the [Expand](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionAnimationSettings.html#Syncfusion_Blazor_Navigations_AccordionAnimationSettings_Expand) property) and `SlideUp` animation for collapsing panels (set through the [Collapse](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionAnimationSettings.html#Syncfusion_Blazor_Navigations_AccordionAnimationSettings_Collapse) property). You can disable animations completely by setting the animation [Effect](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionAnimationCollapse.html#Syncfusion_Blazor_Navigations_AccordionAnimationCollapse_Effect) to `None`.
15
15
16
-
The following example demonstrates various animation types that can be applied to the Accordion component:
16
+
The following example demonstrates how to apply and select various animation types for both the expand and collapse actions of the Accordion component using interactive dropdowns:
17
17
18
18
```cshtml
19
19
@using Syncfusion.Blazor
@@ -73,15 +73,15 @@ The following example demonstrates various animation types that can be applied t
73
73
this.CollapseEffect = args.Value;
74
74
}
75
75
List<Effect> AnimationData = new List<Effect> {
76
-
new Effect() { ID= AnimationEffect.SlideDown, Text= "SlideDown" },
77
-
new Effect() { ID= AnimationEffect.SlideUp, Text= "SlideUp" },
78
-
new Effect() { ID= AnimationEffect.FadeIn, Text= "FadeIn" },
79
-
new Effect() { ID= AnimationEffect.FadeOut, Text= "FadeOut" },
80
-
new Effect() { ID= AnimationEffect.FadeZoomIn, Text= "FadeZoomIn" },
81
-
new Effect() { ID= AnimationEffect.FadeZoomOut, Text= "FadeZoomOut" },
82
-
new Effect() { ID= AnimationEffect.ZoomIn, Text= "ZoomIn" },
83
-
new Effect() { ID= AnimationEffect.ZoomOut, Text= "ZoomOut" },
84
-
new Effect() { ID= AnimationEffect.None, Text= "None" }
76
+
new Effect() { ID= AnimationEffect.SlideDown, Text= "SlideDown" },
77
+
new Effect() { ID= AnimationEffect.SlideUp, Text= "SlideUp" },
78
+
new Effect() { ID= AnimationEffect.FadeIn, Text= "FadeIn" },
79
+
new Effect() { ID= AnimationEffect.FadeOut, Text= "FadeOut" },
80
+
new Effect() { ID= AnimationEffect.FadeZoomIn, Text= "FadeZoomIn" },
81
+
new Effect() { ID= AnimationEffect.FadeZoomOut, Text= "FadeZoomOut" },
82
+
new Effect() { ID= AnimationEffect.ZoomIn, Text= "ZoomIn" },
83
+
new Effect() { ID= AnimationEffect.ZoomOut, Text= "ZoomOut" },
84
+
new Effect() { ID= AnimationEffect.None, Text= "None" }
Copy file name to clipboardExpand all lines: blazor/accordion/content-render-mode.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ documentation: ug
9
9
10
10
# Content Render Mode in Blazor Accordion Component
11
11
12
-
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component provides support for rendering the content of all [AccordionItem](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html) elements at initial load, which will be maintained in the DOM. To enable this behavior, set the [LoadOnDemand](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.SfAccordion.html#Syncfusion_Blazor_Navigations_SfAccordion_LoadOnDemand) property to `false`.
12
+
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component offers flexibility in how the content of its [AccordionItem](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html) elements is rendered into the HTML Document Object Model (DOM). To enable this behavior, set the [LoadOnDemand](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.SfAccordion.html#Syncfusion_Blazor_Navigations_SfAccordion_LoadOnDemand) property to `false`.
13
13
14
14
> The default value of the `LoadOnDemand` property is `true`.
Copy file name to clipboardExpand all lines: blazor/accordion/data-binding.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,16 @@
1
1
---
2
2
layout: post
3
3
title: Data binding in Blazor Accordion Component | Syncfusion
4
-
description: Checkout and learn here all about Data binding in Syncfusion Blazor Accordion component and much more.
4
+
description: Checkout and learn here all about Data binding in Syncfusion Blazor Accordion component and dynamic rendering of headers and content from custom data models.
5
5
platform: Blazor
6
6
control: Accordion
7
7
documentation: ug
8
8
---
9
9
10
10
# Data Binding in Blazor Accordion Component
11
11
12
-
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component provides an option to populate accordion items from local data. This can be accomplished by iterating through accordion items using a conditional **foreach** loop. The Accordion component currently supports only local data for data binding. The [HeaderTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_HeaderTemplate) and [ContentTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_ContentTemplate) properties can be used to render the accordion header and content respectively.
12
+
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component provides an option to populate accordion items from local data. This allows you to generate `AccordionItem` elements based on a collection of structured data, making your UI components flexible and data-driven. The Accordion component is designed to work with local data collections for its primary data binding.
13
+
You can achieve data binding by iterating through your data collection using a standard Blazor `@foreach` loop. The Accordion component currently supports only local data for data binding. The [HeaderTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_HeaderTemplate) and [ContentTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_ContentTemplate) properties can be used to render the accordion header and content respectively.
13
14
14
15
The following example demonstrates how to initialize accordion items using `templates`:
Copy file name to clipboardExpand all lines: blazor/accordion/expand-mode.md
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,14 +9,18 @@ documentation: ug
9
9
10
10
# Expand Mode in Blazor Accordion Component
11
11
12
-
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion)supports the two listed types of expand modes while expanding or collapsing the item.
12
+
The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion)component offers flexible control over how its items expand and collapse. You can configure the Accordion to allow only one item to be open at a time or to permit multiple items to remain expanded simultaneously. This behavior is managed through the [ExpandMode](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.SfAccordion.html#Syncfusion_Blazor_Navigations_SfAccordion_ExpandMode) property.
13
13
14
-
* Single
15
-
* Multiple
14
+
The Accordion supports two primary types of expand modes:
16
15
17
-
## Single
16
+
***Single**: Only one Accordion item can be expanded at any given time.
17
+
***Multiple**: Allows more than one Accordion item to be expanded concurrently.
18
18
19
-
The property enables to expand only one Accordion item at a time. If you expand any new item, the previously expanded one is collapsed and new item changed to expanded state.
19
+
## Single Expand Mode
20
+
21
+
The `Single` expand mode ensures that only one `AccordionItem` is expanded at a time. If a new item is expanded, any previously expanded item automatically collapses, maintaining a focused view for the user. This is ideal for scenarios where screen space is limited or when the content of each item requires exclusive attention.
22
+
23
+
To enable this mode, set the `ExpandMode` property of the `SfAccordion` component to `ExpandMode.Single`.
20
24
21
25
```cshtml
22
26
@@ -39,6 +43,7 @@ The property enables to expand only one Accordion item at a time. If you expand
39
43
## Multiple
40
44
41
45
The default [ExpandMode](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.SfAccordion.html#Syncfusion_Blazor_Navigations_SfAccordion_ExpandMode) of the Accordion is `Multiple`. It enables you to expand more than one Accordion item at a time. Expand/collapse action can also be toggled by clicking on it again. For example, expanded item is collapsed when you click on it again.
46
+
To enable this mode, you can either explicitly set `ExpandMode="ExpandMode.Multiple"` (though it's the default) or omit the ExpandMode property entirely.
Copy file name to clipboardExpand all lines: blazor/accordion/getting-started-with-web-app.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ documentation: ug
9
9
10
10
# Getting Started with Blazor Accordion in Blazor Web App
11
11
12
-
This section briefly explains about how to include[Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component in your Blazor Web App using [Visual Studio](https://visualstudio.microsoft.com/vs/) and Visual Studio Code.
12
+
This section provides a concise guide on how to seamlessly integrate the Syncfusion [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accordion) component in your Blazor Web App using [Visual Studio](https://visualstudio.microsoft.com/vs/) and Visual Studio Code.
13
13
14
14
{% tabcontents %}
15
15
@@ -243,7 +243,7 @@ The following code explains how to initialize Blazor Accordion using header and
243
243
244
244
{% endhighlight %}
245
245
246
-
{% previewsample "https://blazorplayground.syncfusion.com/embed/LtBzXirSVLuZFLkH?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" backgroundimage "[Blazor Accordion with header and content Template](images/blazor-accordion-header-template.png)" %}
246
+
{% previewsample "https://blazorplayground.syncfusion.com/embed/rZroNEVLAafNNVqB?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" backgroundimage "[Blazor Accordion with header and content Template](images/blazor-accordion-header-template.png)" %}
Copy file name to clipboardExpand all lines: blazor/accordion/how-to/add-icon-to-accordion-header.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,17 @@
1
1
---
2
2
layout: post
3
3
title: Add Icon to Header in Blazor Accordion Component | Syncfusion
4
-
description: Checkout and learn here all about how to add Icon to Header in Syncfusion Blazor Accordion component and more.
4
+
description: Learn how to enhance your Blazor Accordion component by adding custom icons to headers using the IconCss property and related CSS styling. Includes default behavior comparison and best practices.
5
5
platform: Blazor
6
6
control: Accordion
7
7
documentation: ug
8
8
---
9
9
10
10
# Add Icon to Header in Blazor Accordion Component
11
11
12
-
You can add custom icons to the Accordion header by using the [IconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_IconCss) property. You can also apply CSS styles to the defined class. The accordion icon element is rendered before the header text in the DOM.
12
+
By default, header display a simple expand/collapse icon. You can customize the header of each Accordion item by adding your own unique icons. This is achieved using the [IconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_IconCss) property of the `AccordionItem`.
13
+
14
+
When you specify a value for `IconCss`, the custom icon will be rendered in place of the default expand/collapse indicator. The specified CSS class(es) are applied to an element that precedes the header text in the Document Object Model (DOM), providing a straightforward way to integrate custom iconography.
0 commit comments