Skip to content

Commit 2a6717a

Browse files
Merge branch 'hotfix/hotfix-v27.1.48' into BLAZ-910685-doc2
2 parents 0673961 + 7614e49 commit 2a6717a

File tree

142 files changed

+3108
-175
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

142 files changed

+3108
-175
lines changed

blazor-toc.html

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -613,6 +613,7 @@
613613
<li><a href="/blazor/ai-assistview/custom-view">Custom views</a></li>
614614
<li><a href="/blazor/ai-assistview/templates">Templates</a></li>
615615
<li><a href="/blazor/ai-assistview/appearance">Appearance</a></li>
616+
<li><a href="/blazor/ai-assistview/accessibility">Accessibility</a></li>
616617
<li><a href="/blazor/ai-assistview/methods">Methods</a></li>
617618
<li><a href="/blazor/ai-assistview/events">Events</a></li>
618619
<li>
@@ -2454,6 +2455,9 @@
24542455
<li>
24552456
<a href="/blazor/diagram/layout/organizational-chart">Organizational Chart</a>
24562457
</li>
2458+
<li>
2459+
<a href="/blazor/diagram/layout/flowchart-layout">Flowchart Layout</a>
2460+
</li>
24572461
<li>
24582462
<a href="/blazor/diagram/layout/mind-map">Mind Map Layout</a>
24592463
</li>
@@ -3422,6 +3426,9 @@
34223426
<li>
34233427
<a href="/blazor/multicolumn-combobox/custom-value">Custom Value</a>
34243428
</li>
3429+
<li> <a href="/blazor/multicolumn-combobox/popup-setting">Popup Setting</a></li>
3430+
<li><a href="/blazor/multicolumn-combobox/sorting">Sorting</a></li>
3431+
<li> <a href="/blazor/multicolumn-combobox/virtualization">Virtualization</a></li>
34253432
</ul>
34263433
</li>
34273434
<li>MultiSelect Dropdown
Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
layout: post
3+
title: Accessibility in Blazor AI AssistView Component | Syncfusion
4+
description: Checkout and learn about Accessibility and Keyboard interaction with Blazor AI AssistView component and more details.
5+
platform: Blazor
6+
control: AI AssistView
7+
documentation: ug
8+
---
9+
10+
# Accessibility in Blazor AI AssistView component
11+
12+
The Blazor AI AssistView 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.
13+
14+
The accessibility compliance for the Blazor AI AssistView component is outlined below.
15+
16+
| Accessibility Criteria | Compatibility |
17+
| -- | -- |
18+
| [WCAG 2.2 Support](../common/accessibility#accessibility-standards) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
19+
| [Section 508 Support](../common/accessibility#accessibility-standards) |<img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
20+
| [Screen Reader Support](../common/accessibility#screen-reader-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
21+
| [Right-To-Left Support](../common/accessibility#right-to-left-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
22+
| [Color Contrast](../common/accessibility#color-contrast) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
23+
| [Mobile Device Support](../common/accessibility#mobile-device-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
24+
| [Keyboard Navigation Support](../common/accessibility#keyboard-navigation-support) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
25+
| [Axe-core Accessibility Validation](../common/accessibility#ensuring-accessibility) | <img src="https://cdn.syncfusion.com/content/images/landing-page/yes.png" alt="Yes"> |
26+
27+
<style>
28+
.post .post-content img {
29+
display: inline-block;
30+
margin: 0.5em 0;
31+
}
32+
</style>
33+
34+
<div><img src="https://cdn.syncfusion.com/content/images/documentation/full.png" alt="Yes"> - All features of the component meet the requirement.</div>
35+
36+
<div><img src="https://cdn.syncfusion.com/content/images/documentation/partial.png" alt="Intermediate"> - Some features of the component do not meet the requirement.</div>
37+
38+
<div><img src="https://cdn.syncfusion.com/content/images/documentation/not-supported.png" alt="No"> - The component does not meet the requirement.</div>
39+
40+
## WAI-ARIA attributes
41+
42+
The following ARIA attributes are used in the AI AssistView component:
43+
44+
| Attributes | Purpose |
45+
| ------------ | ----------------------- |
46+
| `role=button` | Indicates that the element is clickable and triggers an action when activated by the user. |
47+
| `role=toolbar` | Specifies that the element is a toolbar. |
48+
| `aria-label` | Defines a string value that labels an interactive element for accessibility. |
49+
| `aria-orientation` | Specifies the orientation of the toolbar. |
50+
| `aria-disabled` | Indicates whether the toolbar or element is currently disabled and not interactive. |
51+
| `aria-multiline` | Indicates that a textbox accepts multiple lines of input or only a single line. |
52+
53+
## Keyboard interaction
54+
55+
The following keyboard shortcuts are supported by the AI AssistView component.
56+
57+
| **Press** | **To do this** |
58+
| --- | --- |
59+
| <kbd>Enter</kbd> | Select the focused item. |
60+
| <kbd>Tab</kbd> | Moves focus forward through the interactive elements. |
61+
| <kbd>Shift + Tab</kbd> | Moves focus backward through the interactive elements. |
62+
<b>AI AssistView Toolbars</b>||
63+
| <kbd>Left Arrow</kbd> | Focuses the previous toolbar element. |
64+
| <kbd>Right Arrow</kbd> | Focuses the next toolbar element. |
65+
| <kbd>Enter / Space</kbd> | Select the focused item or activate the selected option. |
66+
| <kbd>Home</kbd> | Moves focus to the first toolbar element. |
67+
| <kbd>End</kbd> | Moves focus to the last toolbar element. |
68+
69+
## Ensuring accessibility
70+
71+
The Blazor AI AssistView component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests.
72+
73+
## See also
74+
75+
* [Accessibility in Syncfusion Blazor components](https://blazor.syncfusion.com/documentation/common/accessibility)

blazor/ai-assistview/appearance.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ documentation: ug
1111

1212
## Setting width
1313

14-
You can use the `Width` property to set the width of the AI AssistView.
14+
You can use the [Width](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_Width) property to set the width of the AI AssistView. The default value is `100%`.
1515

1616
```cshtml
1717
1818
@using Syncfusion.Blazor.InteractiveChat
1919
20-
<div class="aiassist-container" style="height: 350px; width: 750px;">
20+
<div class="aiassist-container" style="height: 350px;">
2121
<SfAIAssistView Width="650px" PromptRequested="@PromptRequest"></SfAIAssistView>
2222
</div>
2323
@@ -36,15 +36,13 @@ You can use the `Width` property to set the width of the AI AssistView.
3636

3737
## Setting height
3838

39-
You can use the `Height` property to set the height of the AI AssistView.
40-
41-
> By default, the component `Width` & `Height` will be inherited based on the parent dimensions.
39+
You can use the [Height](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_Height) property to set the height of the AI AssistView. The default value is `100%`.
4240

4341
```cshtml
4442
4543
@using Syncfusion.Blazor.InteractiveChat
4644
47-
<div class="aiassist-container" style="height: 450px; width: 650px;">
45+
<div class="aiassist-container" style="width: 650px;">
4846
<SfAIAssistView Height="350px" PromptRequested="@PromptRequest"></SfAIAssistView>
4947
</div>
5048
@@ -63,14 +61,14 @@ You can use the `Height` property to set the height of the AI AssistView.
6361

6462
## CssClass
6563

66-
You can customize the appearance of the AI AssistView component by using the `CssClass` property.
64+
You can customize the appearance of the AI AssistView component by using the [CssClass](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_CssClass) property.
6765

6866
```cshtml
6967
7068
@using Syncfusion.Blazor.InteractiveChat
7169
7270
<div class="aiassist-container" style="height: 350px; width: 650px;">
73-
<SfAIAssistView CssClass="e-custom" PromptRequested="@PromptRequest"></SfAIAssistView>
71+
<SfAIAssistView CssClass="custom-container" PromptRequested="@PromptRequest"></SfAIAssistView>
7472
</div>
7573
7674
@code {
@@ -82,18 +80,18 @@ You can customize the appearance of the AI AssistView component by using the `Cs
8280
}
8381
}
8482
<style>
85-
.e-aiassistview.e-custom {
83+
.e-aiassistview.custom-container {
8684
border-color: #e0e0e0;
8785
background-color: #f4f4f4;
8886
box-shadow: 3px 3px 10px 0px rgba(0, 0, 0, 0.2);
8987
}
9088
91-
.e-aiassistview.e-custom .e-view-header .e-toolbar,
92-
.e-aiassistview.e-custom .e-view-header .e-toolbar-items {
89+
.e-aiassistview.custom-container .e-view-header .e-toolbar,
90+
.e-aiassistview.custom-container .e-view-header .e-toolbar-items {
9391
background: #d5d5d5;
9492
}
9593
96-
.e-aiassistview.e-custom .e-view-content .e-input-group {
94+
.e-aiassistview.custom-container .e-view-content .e-input-group {
9795
border: 3px solid #e0e0e0;
9896
}
9997
</style>

blazor/ai-assistview/assist-view.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ documentation: ug
1111

1212
## Setting prompt text
1313

14-
You can use the `Prompt` property to define the prompt text for the AI AssistView component.
14+
You can use the [Prompt](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_Prompt) property to define the prompt text for the AI AssistView component.
1515

1616
```cshtml
1717
@@ -36,7 +36,7 @@ You can use the `Prompt` property to define the prompt text for the AI AssistVie
3636

3737
## Setting prompt placeholder
3838

39-
You can use the `PromptPlaceholder` property to set the placeholder text for the prompt textarea. The default value is `Type prompt for assistance...`.
39+
You can use the [PromptPlaceholder](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_PromptPlaceholder) property to set the placeholder text for the prompt textarea. The default value is `Type prompt for assistance...`.
4040

4141
```cshtml
4242
@@ -61,7 +61,7 @@ You can use the `PromptPlaceholder` property to set the placeholder text for the
6161

6262
## Prompt-response collection
6363

64-
By using the `Prompts` property, you can specify the collection of prompts and responses, allowing you to load pre-defined pairs or individual entries ensuring the AI AssistView component is initialized with the configured data.
64+
You can use the [Prompts](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_Prompts) property to initialize the component with the configured data as a collection of prompts and responses or individual entries.
6565

6666
The `Prompts` collection stores all the prompts and responses generated.
6767

@@ -94,7 +94,7 @@ The `Prompts` collection stores all the prompts and responses generated.
9494

9595
## Adding prompt suggestions
9696

97-
By using the `PromptSuggestions` property, you can configure the list of suggested prompts in the AI AssistView. Users can choose from these suggestions to use as their prompts.
97+
You can use the [PromptSuggestions](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_PromptSuggestions) property, to add the suggestions in both initial and on-demand which help users to refine their prompts. Additionally, custom header can be set for suggestions further enhancing the user experience.
9898

9999
```cshtml
100100
@@ -122,7 +122,7 @@ By using the `PromptSuggestions` property, you can configure the list of suggest
122122

123123
### Adding suggestion headers
124124

125-
You can use the `PromptSuggestionsHeader` property to set the header text for the prompt suggestions in the AI AssistView.
125+
You can use the [PromptSuggestionsHeader](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_PromptSuggestionsHeader) property to set the header text for the prompt suggestions in the AI AssistView.
126126

127127
```cshtml
128128
@@ -148,9 +148,9 @@ You can use the `PromptSuggestionsHeader` property to set the header text for th
148148

149149
![Blazor AI AssistView PromptSuggestionsHeader](./images/assistview-suggestion-header.png)
150150

151-
## Adding prompt iconCSS
151+
## Adding prompt iconCss
152152

153-
You can customize the appearance of the prompter avatar by using the `PromptIconCss` property.
153+
You can customize the appearance of the prompter avatar by using the [PromptIconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_PromptIconCss) property.
154154

155155
```cshtml
156156
@@ -179,16 +179,16 @@ You can customize the appearance of the prompter avatar by using the `PromptIcon
179179

180180
![Blazor AI AssistView PromptIcon](./images/assistview-prompt-icon.png)
181181

182-
## Adding response iconCSS
182+
## Adding response iconCss
183183

184-
You can use the `ResponseIconCss` property to customize the appearance of the responder avatar. By default, the `e-assistview-icon` class is added as the built-in AI AssistView response icon.
184+
You can use the [ResponseIconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_ResponseIconCss) property to customize the appearance of the responder avatar. By default, the `e-assistview-icon` class is added as the built-in AI AssistView response icon.
185185

186186
```cshtml
187187
188188
@using Syncfusion.Blazor.InteractiveChat
189189
190190
<div class="aiassist-container" style="height: 350px; width: 650px;">
191-
<SfAIAssistView Prompts="@prompts" PromptRequested="@PromptRequest" ResponseIconCss="e-icons e-star-filled"></SfAIAssistView>
191+
<SfAIAssistView Prompts="@prompts" PromptRequested="@PromptRequest" ResponseIconCss="e-icons e-bullet-4"></SfAIAssistView>
192192
</div>
193193
194194
@code {

blazor/ai-assistview/custom-view.md

Lines changed: 36 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The Blazor AI AssistView allows you to add different views available for user in
1515

1616
#### Setting view type
1717

18-
You can change the type of view by using the `AssistView` and `CustomView` tag directive.
18+
You can set the type of view by using the [AssistView](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.AssistView.html) and [CustomView](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.CustomView.html) tag directive.
1919

2020
```cshtml
2121
@@ -25,7 +25,11 @@ You can change the type of view by using the `AssistView` and `CustomView` tag d
2525
<SfAIAssistView PromptRequested="@PromptRequest">
2626
<AssistViews>
2727
<AssistView></AssistView>
28-
<CustomView Header="Response"></CustomView>
28+
<CustomView Header="Response">
29+
<ViewTemplate>
30+
<div class="view-container"><h5>Response view content</h5></div>
31+
</ViewTemplate>
32+
</CustomView>
2933
</AssistViews>
3034
</SfAIAssistView>
3135
</div>
@@ -45,7 +49,7 @@ You can change the type of view by using the `AssistView` and `CustomView` tag d
4549

4650
### Setting name
4751

48-
You can use the `Header` property to specifies the header name of the `Assist` or `Custom` views in the AI AssistView.
52+
You can use the [Header](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.AssistView.html#Syncfusion_Blazor_InteractiveChat_AssistView_Header) property to specifies the header name of the `Assist` or `Custom` views in the AI AssistView.
4953

5054
```cshtml
5155
@@ -55,7 +59,11 @@ You can use the `Header` property to specifies the header name of the `Assist` o
5559
<SfAIAssistView PromptRequested="@PromptRequest">
5660
<AssistViews>
5761
<AssistView Header="Prompt"></AssistView>
58-
<CustomView Header="Response"></CustomView>
62+
<CustomView Header="Response">
63+
<ViewTemplate>
64+
<div class="view-container"><h5>Response view content</h5></div>
65+
</ViewTemplate>
66+
</CustomView>
5967
</AssistViews>
6068
</SfAIAssistView>
6169
</div>
@@ -73,9 +81,9 @@ You can use the `Header` property to specifies the header name of the `Assist` o
7381

7482
![Blazor AI AssistView type Header](./images/ai-assistview-type-header.png)
7583

76-
### Setting iconCSS
84+
### Setting iconCss
7785

78-
You can customize the view icons by using the `IconCss` property. By default the `e-assistview-icon` class is added as built-in header icon for the AI AssistView.
86+
You can customize the view icons by using the [IconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.AssistView.html#Syncfusion_Blazor_InteractiveChat_AssistView_IconCss) property. By default the `e-assistview-icon` class is added as built-in header icon for the AI AssistView.
7987

8088
```cshtml
8189
@@ -85,7 +93,11 @@ You can customize the view icons by using the `IconCss` property. By default the
8593
<SfAIAssistView PromptRequested="@PromptRequest">
8694
<AssistViews>
8795
<AssistView Header="Prompt" IconCss="e-assistview-icon"></AssistView>
88-
<CustomView Header="Response" IconCss="e-comment-show"></CustomView>
96+
<CustomView Header="Response" IconCss="e-comment-show">
97+
<ViewTemplate>
98+
<div class="view-container"><h5>Response view content</h5></div>
99+
</ViewTemplate>
100+
</CustomView>
89101
</AssistViews>
90102
</SfAIAssistView>
91103
</div>
@@ -105,7 +117,7 @@ You can customize the view icons by using the `IconCss` property. By default the
105117

106118
### Setting view template
107119

108-
You can use the `ViewTemplate` tag directive to add the view content of the multiple views added in the AI AssistView.
120+
You can use the [ViewTemplate](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.AssistView.html#Syncfusion_Blazor_InteractiveChat_AssistView_ViewTemplate) tag directive to add the view content of the multiple views added in the AI AssistView.
109121

110122
```cshtml
111123
@@ -142,7 +154,7 @@ You can use the `ViewTemplate` tag directive to add the view content of the mult
142154

143155
#### Show or hide clear button
144156

145-
You can use the `ShowClearButton` property using the `AssistView` tag directive to show or hide the clear button. By default, its value is `false`, when the clear button is clicked, the prompt text entered will be cleared.
157+
You can use the [ShowClearButton](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.AssistView.html#Syncfusion_Blazor_InteractiveChat_AssistView_ShowClearButton) property using the `AssistView` tag directive to show or hide the clear button. By default, its value is `false`, when the clear button is clicked, the prompt text entered will be cleared.
146158

147159
```cshtml
148160
@@ -171,7 +183,7 @@ You can use the `ShowClearButton` property using the `AssistView` tag directive
171183

172184
## Setting active view
173185

174-
You can use the `ActiveView` property set the active view in the AI AssistView. By default, the value is `0`.
186+
You can use the [ActiveView](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.InteractiveChat.SfAIAssistView.html#Syncfusion_Blazor_InteractiveChat_SfAIAssistView_ActiveView) property set the active view in the AI AssistView. By default, the value is `0`.
175187

176188
```cshtml
177189
@@ -180,8 +192,12 @@ You can use the `ActiveView` property set the active view in the AI AssistView.
180192
<div class="aiassist-container" style="height: 350px; width: 650px;">
181193
<SfAIAssistView PromptRequested="@PromptRequest" ActiveView="1">
182194
<AssistViews>
183-
<AssistView Header="Prompt"></AssistView>
184-
<CustomView Header="Response" IconCss="e-icons e-comment-show"></CustomView>
195+
<AssistView></AssistView>
196+
<CustomView Header="Response" IconCss="e-icons e-comment-show">
197+
<ViewTemplate>
198+
<div class="view-container"><h5>Response view content</h5></div>
199+
</ViewTemplate>
200+
</CustomView>
185201
</AssistViews>
186202
</SfAIAssistView>
187203
</div>
@@ -194,6 +210,14 @@ You can use the `ActiveView` property set the active view in the AI AssistView.
194210
args.Response = defaultResponse;
195211
}
196212
}
213+
<style>
214+
.view-container {
215+
height: inherit;
216+
display: flex;
217+
align-items: center;
218+
justify-content: center;
219+
}
220+
</style>
197221
198222
```
199223

0 commit comments

Comments
 (0)