Skip to content

Commit 5bd3f65

Browse files
committed
Merge branch '983366-card' of https://github.com/syncfusion-content/blazor-docs into 983366-card
2 parents 7a57e5c + 1363231 commit 5bd3f65

35 files changed

+819
-1062
lines changed

blazor-toc.html

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4282,9 +4282,6 @@
42824282
<li>Getting Started
42834283
<ul>
42844284
<li> <a href="/blazor/smart-textarea/getting-started-webapp">Blazor Web App</a></li>
4285-
<li>
4286-
<a href="/blazor/smart-textarea/getting-started">Blazor Server App</a>
4287-
</li>
42884285
</ul>
42894286
</li>
42904287
<li><a href="/blazor/smart-textarea/customization">Customize Suggestions</a></li>

blazor/accordion/accessibility.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: post
33
title: Accessibility in Blazor Accordion Component | Syncfusion
4-
description: Checkout and learn here all about Accessibility in Syncfusion Blazor Accordion component and 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.
55
platform: Blazor
66
control: Accordion
77
documentation: ug
@@ -41,18 +41,20 @@ The accessibility compliance for the Blazor Accordion component is outlined belo
4141

4242
## WAI-ARIA attributes
4343

44+
The Syncfusion Blazor Accordion component automatically applies the following WAI-ARIA attributes to its elements to enhance accessibility:
45+
4446
| Attributes | Purpose |
4547
|----------------------|---------------|
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. |
5153
| aria-disabled | It indicates the disabled state of the Accordion and its items. |
5254

5355
## Keyboard interaction
5456

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:
5658

5759
| Windows | Mac | Description |
5860
|---------------|-----------|--------|

blazor/accordion/animations.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: post
33
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.
55
platform: Blazor
66
control: Accordion
77
documentation: ug
@@ -13,7 +13,7 @@ The [Blazor Accordion](https://www.syncfusion.com/blazor-components/blazor-accor
1313

1414
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`.
1515

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:
1717

1818
```cshtml
1919
@using Syncfusion.Blazor
@@ -73,15 +73,15 @@ The following example demonstrates various animation types that can be applied t
7373
this.CollapseEffect = args.Value;
7474
}
7575
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" }
8585
};
8686
public class Effect
8787
{

blazor/accordion/content-render-mode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ documentation: ug
99

1010
# Content Render Mode in Blazor Accordion Component
1111

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`.
1313

1414
> The default value of the `LoadOnDemand` property is `true`.
1515

blazor/accordion/data-binding.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
22
layout: post
33
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.
55
platform: Blazor
66
control: Accordion
77
documentation: ug
88
---
99

1010
# Data Binding in Blazor Accordion Component
1111

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.
1314

1415
The following example demonstrates how to initialize accordion items using `templates`:
1516

blazor/accordion/expand-mode.md

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

1010
# Expand Mode in Blazor Accordion Component
1111

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.
1313

14-
* Single
15-
* Multiple
14+
The Accordion supports two primary types of expand modes:
1615

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.
1818

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`.
2024

2125
```cshtml
2226
@@ -39,6 +43,7 @@ The property enables to expand only one Accordion item at a time. If you expand
3943
## Multiple
4044

4145
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.
4247

4348
```cshtml
4449

blazor/accordion/getting-started-with-web-app.md

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

1010
# Getting Started with Blazor Accordion in Blazor Web App
1111

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.
1313

1414
{% tabcontents %}
1515

@@ -243,7 +243,7 @@ The following code explains how to initialize Blazor Accordion using header and
243243

244244
{% endhighlight %}
245245

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)" %}
247247

248248
## See also
249249

blazor/accordion/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ The following code explains how to initialize Blazor Accordion using header and
172172

173173
{% endhighlight %}
174174

175-
{% 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)" %}
175+
{% 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)" %}
176176

177177

178178
## See also

blazor/accordion/how-to/add-icon-to-accordion-header.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,17 @@
11
---
22
layout: post
33
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.
55
platform: Blazor
66
control: Accordion
77
documentation: ug
88
---
99

1010
# Add Icon to Header in Blazor Accordion Component
1111

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.
1315

1416
```cshtml
1517
@using Syncfusion.Blazor.Navigations

blazor/accordion/how-to/add-nested-accordion.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,30 @@
11
---
22
layout: post
33
title: Add Nested Accordion in Blazor Accordion Component | Syncfusion
4-
description: Checkout and learn here all about how to add Nested Accordion in Syncfusion Blazor Accordion component and more.
4+
description: Learn the straightforward method for implementing nested Accordions within the Syncfusion Blazor Accordion component using the ContentTemplate property, with code examples and best practices.
55
platform: Blazor
66
control: Accordion
77
documentation: ug
88
---
99

1010
# Add Nested Accordion in Blazor Accordion Component
1111

12-
The Accordion component supports to render the nested level of Accordion by using the [ContentTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_ContentTemplate) property. To render the nested Accordion, define the nested Accordion elements within the `ContentTemplate` property of the parent Accordion.
12+
The Accordion component supports to render the nested level of Accordion by using the [ContentTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Navigations.AccordionItem.html#Syncfusion_Blazor_Navigations_AccordionItem_ContentTemplate) property.
13+
## Implementing Nested Accordions
1314

15+
To achieve nesting, you simply include a complete `<SfAccordion>` component inside the `<ContentTemplate>` of an `AccordionItem` that belongs to a parent `SfAccordion`. Each nested `SfAccordion` functions independently, allowing for distinct content and structure at each level.
16+
17+
### Example: Multiple Levels of Nesting
18+
19+
This example demonstrates how to create a two-level nested Accordion structure.
1420
```cshtml
1521
@using Syncfusion.Blazor.Navigations
1622
1723
<SfAccordion>
1824
<AccordionItems>
1925
<AccordionItem Header="Video">
2026
<ContentTemplate>
27+
<!-- First level nested Accordion -->
2128
<SfAccordion>
2229
<AccordionItems>
2330
<AccordionItem Header="Video Track1"></AccordionItem>
@@ -28,12 +35,14 @@ The Accordion component supports to render the nested level of Accordion by usin
2835
</AccordionItem>
2936
<AccordionItem Header="Music">
3037
<ContentTemplate>
38+
<!-- First level nested Accordion -->
3139
<SfAccordion>
3240
<AccordionItems>
3341
<AccordionItem Header="Music Track1"></AccordionItem>
3442
<AccordionItem Header="Music Track2"></AccordionItem>
3543
<AccordionItem Header="Music New">
3644
<ContentTemplate>
45+
<!-- Second level nested Accordion -->
3746
<SfAccordion>
3847
<AccordionItems>
3948
<AccordionItem Header="New Track1"></AccordionItem>
@@ -48,6 +57,7 @@ The Accordion component supports to render the nested level of Accordion by usin
4857
</AccordionItem>
4958
<AccordionItem Header="Images">
5059
<ContentTemplate>
60+
<!-- First level nested Accordion -->
5161
<SfAccordion>
5262
<AccordionItems>
5363
<AccordionItem Header="Track1"></AccordionItem>

0 commit comments

Comments
 (0)