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/split-button/accessibility.md
+12-12Lines changed: 12 additions & 12 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
# Accessibility in Blazor SplitButton Component
11
11
12
-
The Blazor SplitButton 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 SplitButton component follows 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
13
14
14
The accessibility compliance for the Blazor SplitButton component is outlined below.
15
15
@@ -38,33 +38,33 @@ The accessibility compliance for the Blazor SplitButton component is outlined be
38
38
39
39
## WAI-ARIA attributes
40
40
41
-
The Blazor SplitButton component followed the WAI-ARIA patterns to meet the accessibility. The following ARIA attributes are used in the Blazor SplitButton component:
41
+
The Blazor SplitButton component applies WAI-ARIA patterns to meet accessibility requirements. The following ARIA attributes are used in the Blazor SplitButton component:
42
42
43
43
| Attributes | Purpose |
44
44
| --- | --- |
45
-
|`role`|Indicates the SplitButton component as `button`, SplitButton popup as `menu`, and the SplitButton popup action items as `menuitem`. |
46
-
|`aria-haspopup`| Indicates the availability and type of interactive SplitButton popup element. |
47
-
|`aria-expanded`|Indicates whether the SplitButton popup can be expanded or collapsed, as well as indicates whether its current state is expanded or collapsed. |
48
-
|`aria-owns`|Identifies an elements in order to define a visual, functional, or contextual parent/child relationship between DOM elements where the DOM hierarchy cannot be used to represent the relationship. |
49
-
|`aria-disabled`| Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. |
45
+
|`role`|Identifies the SplitButton as a `button`, the SplitButton popup as a `menu`, and popup action items as `menuitem`. |
46
+
|`aria-haspopup`| Indicates that the button opens an interactive SplitButton popup (menu). |
47
+
|`aria-expanded`|Reflects whether the SplitButton popup is currently expanded or collapsed. |
48
+
|`aria-owns`|Associates elements to define a parent/child relationship when it cannot be represented in the DOM hierarchy. |
49
+
|`aria-disabled`| Indicates that the element is perceivable but disabled and not operable. |
50
50
51
51
## Keyboard interaction
52
52
53
-
The Blazor SplitButton component followed the keyboard interaction 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 SplitButton component.
53
+
The Blazor SplitButton component follows keyboard interaction guidelines, making it usable for people who rely on assistive technologies (AT) and keyboard navigation. The following keyboard shortcuts are supported:
54
54
55
55
| Windows | Mac | Actions |
56
56
| --- | --- | --- |
57
57
| <kbd>Esc</kbd> | <kbd>Esc</kbd> | Closes the opened popup. |
58
58
| <kbd>Enter</kbd> | <kbd>Enter</kbd> | Opens the popup, or activates the highlighted item and closes the popup. |
59
-
| <kbd>Space</</kbd> | <kbd>Space</kbd> | Opens the popup. |
60
-
| <kbd>↑</kbd> | <kbd>↑</kbd> | Navigates up or to the previous action item. |
61
-
| <kbd>↓</kbd> | <kbd>↓</kbd> | Navigates down or to the next action item. |
59
+
| <kbd>Space</kbd> | <kbd>Space</kbd> | Opens the popup. |
60
+
| <kbd>↑</kbd> | <kbd>↑</kbd> | Navigates up to the previous action item. |
61
+
| <kbd>↓</kbd> | <kbd>↓</kbd> | Navigates down to the next action item. |
The Blazor SplitButton component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests.
67
+
The Blazor SplitButton component’s accessibility is validated using [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with Playwright tests.
68
68
69
69
The accessibility compliance of the Blazor SplitButton component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/split-button) in a new window to evaluate the accessibility of the Blazor SplitButton component with accessibility tools.
Copy file name to clipboardExpand all lines: blazor/split-button/getting-started-webapp.md
+27-27Lines changed: 27 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,17 +21,17 @@ This section briefly explains about how to include [Blazor Split Button](https:/
21
21
22
22
## Create a new Blazor Web App in Visual Studio
23
23
24
-
You can create a **Blazor Web App** using Visual Studio 2022 via [Microsoft Templates](https://learn.microsoft.com/en-us/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vs) or the [Syncfusion<supstyle="font-size:70%">®</sup> Blazor Extension](https://blazor.syncfusion.com/documentation/visual-studio-integration/template-studio).
24
+
Create a **Blazor Web App** using Visual Studio 2022 via [Microsoft Templates](https://learn.microsoft.com/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vs) or the [Syncfusion<supstyle="font-size:70%">®</sup> Blazor Extension](https://blazor.syncfusion.com/documentation/visual-studio-integration/template-studio).
25
25
26
-
You need to configure the corresponding[Interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0#render-modes) and [Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vs)while creating a Blazor Web Application.
26
+
Configure the appropriate[Interactive render mode](https://learn.microsoft.com/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0#render-modes) and [Interactivity location](https://learn.microsoft.com/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vs)when creating the Blazor Web App.
27
27
28
28
## Install Syncfusion<supstyle="font-size:70%">®</sup> Blazor SplitButtons and Themes NuGet in the App
29
29
30
-
To add **Blazor Split Button** component in the app, open the NuGet package manager in Visual Studio (*Tools → NuGet Package Manager → Manage NuGet Packages for Solution*), search and install [Syncfusion.Blazor.SplitButtons](https://www.nuget.org/packages/Syncfusion.Blazor.SplitButtons) and [Syncfusion.Blazor.Themes](https://www.nuget.org/packages/Syncfusion.Blazor.Themes/).
30
+
To add the **Blazor Split Button** component to the app, open the NuGet Package Manager in Visual Studio (Tools → NuGet Package Manager → Manage NuGet Packages for Solution), then search for and install [Syncfusion.Blazor.SplitButtons](https://www.nuget.org/packages/Syncfusion.Blazor.SplitButtons) and [Syncfusion.Blazor.Themes](https://www.nuget.org/packages/Syncfusion.Blazor.Themes/).
31
31
32
-
If you utilize `WebAssembly or Auto` render modes in the Blazor Web App need to be install Syncfusion<supstyle="font-size:70%">®</sup> Blazor components NuGet packages within the client project.
32
+
If using `WebAssembly` or `Auto` render modes in a Blazor Web App, install the SyncfusionBlazor NuGet packages in the Client project.
33
33
34
-
Alternatively, you can utilize the following package manager command to achieve the same.
34
+
Alternatively, run the following commands in the Package Manager Console:
N> Syncfusion<supstyle="font-size:70%">®</sup> Blazor components are available in [nuget.org](https://www.nuget.org/packages?q=syncfusion.blazor). Refer to [NuGet packages](https://blazor.syncfusion.com/documentation/nuget-packages) topic for available NuGet packages list with component details.
45
+
N> Syncfusion<supstyle="font-size:70%">®</sup> Blazor components are available on NuGet. For a list of available packages, see [NuGet packages](https://blazor.syncfusion.com/documentation/nuget-packages).
## Create a new Blazor Web App in Visual Studio Code
56
56
57
-
You can create a **Blazor Web App** using Visual Studio Code via [Microsoft Templates](https://learn.microsoft.com/en-us/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vsc) or the [Syncfusion<supstyle="font-size:70%">®</sup> Blazor Extension](https://blazor.syncfusion.com/documentation/visual-studio-code-integration/create-project).
57
+
Create a **Blazor Web App** using Visual Studio Code via [Microsoft Templates](https://learn.microsoft.com/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vsc) or the [Syncfusion<supstyle="font-size:70%">®</sup> Blazor Extension](https://blazor.syncfusion.com/documentation/visual-studio-code-integration/create-project).
58
58
59
-
You need to configure the corresponding[Interactive render mode](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0#render-modes) and [Interactivity location](https://learn.microsoft.com/en-us/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vsc)while creating a Blazor Web Application.
59
+
Configure the appropriate[Interactive render mode](https://learn.microsoft.com/aspnet/core/blazor/components/render-modes?view=aspnetcore-8.0#render-modes) and [Interactivity location](https://learn.microsoft.com/aspnet/core/blazor/tooling?view=aspnetcore-8.0&pivots=vsc)when creating the Blazor Web App.
60
60
61
-
For example, in a Blazor Web App with the `Auto` interactive render mode, use the following commands.
61
+
For example, to create a Blazor Web App with the `Auto` interactive render mode, use the following commands:
62
62
63
63
{% tabs %}
64
64
{% highlight c# tabtitle="Blazor Web App" %}
@@ -70,15 +70,15 @@ cd BlazorWebApp.Client
70
70
{% endhighlight %}
71
71
{% endtabs %}
72
72
73
-
N> For more information on creating a **Blazor Web App** with various interactive modes and locations, refer to this [link](https://blazor.syncfusion.com/documentation/getting-started/blazor-web-app?tabcontent=visual-studio-code#render-interactive-modes).
73
+
N> For more information about creating a Blazor Web App with various interactive modes and locations, see [Render interactive modes](https://blazor.syncfusion.com/documentation/getting-started/blazor-web-app?tabcontent=visual-studio-code#render-interactive-modes).
74
74
75
75
## Install Syncfusion<supstyle="font-size:70%">®</sup> Blazor SplitButtons and Themes NuGet in the App
76
76
77
-
If you utilize `WebAssembly` or `Auto` render modes in the Blazor Web App need to be install Syncfusion<supstyle="font-size:70%">®</sup> Blazor components NuGet packages within the client project.
77
+
If using `WebAssembly` or `Auto` render modes in a Blazor Web App, install the SyncfusionBlazor NuGet packages in the Client project.
78
78
79
79
* Press <kbd>Ctrl</kbd>+<kbd>`</kbd> to open the integrated terminal in Visual Studio Code.
80
-
* Ensure you’re in the project root directory where your `.csproj` file is located.
81
-
* Run the following command to install a [Syncfusion.Blazor.SplitButtons](https://www.nuget.org/packages/Syncfusion.Blazor.SplitButtons) and [Syncfusion.Blazor.Themes](https://www.nuget.org/packages/Syncfusion.Blazor.Themes/)NuGet package and ensure all dependencies are installed.
80
+
* Ensure the terminal is opened in the project directory that contains the `.csproj` file.
81
+
* Run the following commands to install [Syncfusion.Blazor.SplitButtons](https://www.nuget.org/packages/Syncfusion.Blazor.SplitButtons) and [Syncfusion.Blazor.Themes](https://www.nuget.org/packages/Syncfusion.Blazor.Themes/) and restore dependencies.
82
82
83
83
{% tabs %}
84
84
@@ -92,20 +92,20 @@ dotnet restore
92
92
93
93
{% endtabs %}
94
94
95
-
N> Syncfusion<supstyle="font-size:70%">®</sup> Blazor components are available in [nuget.org](https://www.nuget.org/packages?q=syncfusion.blazor). Refer to [NuGet packages](https://blazor.syncfusion.com/documentation/nuget-packages) topic for available NuGet packages list with component details.
95
+
N> Syncfusion<supstyle="font-size:70%">®</sup> Blazor components are available on NuGet. For a list of available packages, see [NuGet packages](https://blazor.syncfusion.com/documentation/nuget-packages).
96
96
97
97
{% endtabcontent %}
98
98
99
99
{% endtabcontents %}
100
100
101
101
## Register Syncfusion<supstyle="font-size:70%">®</sup> Blazor Service
102
102
103
-
| Interactive Render Mode| Description |
103
+
| Interactive render mode| Description |
104
104
| -- | -- |
105
-
| WebAssembly or Auto | Open **~/_Imports.razor**file from the client project.|
106
-
| Server | Open **~/_import.razor**file, which is located in the `Components` folder.|
105
+
| WebAssembly or Auto | Open **~/_Imports.razor**in the Client project.|
106
+
| Server | Open **~/_Imports.razor**in the Server project (located in the `Components` folder). |
107
107
108
-
Import the `Syncfusion.Blazor` and `Syncfusion.Blazor.SplitButtons`namespace.
108
+
Import the `Syncfusion.Blazor` and `Syncfusion.Blazor.SplitButtons`namespaces.
109
109
110
110
{% tabs %}
111
111
{% highlight C# tabtitle="~/_Imports.razor" %}
@@ -116,9 +116,9 @@ Import the `Syncfusion.Blazor` and `Syncfusion.Blazor.SplitButtons` namespace.
116
116
{% endhighlight %}
117
117
{% endtabs %}
118
118
119
-
Now, register the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Service in the **~/Program.cs** file of your Blazor Web App.
119
+
Now register the Syncfusion<supstyle="font-size:70%">®</sup> Blazor service in the **~/Program.cs** file of your Blazor Web App.
120
120
121
-
If the **Interactive Render Mode** is set to `WebAssembly` or `Auto`, you need to register the Syncfusion<supstyle="font-size:70%">®</sup> Blazor service in both **~/Program.cs** files of your Blazor Web App.
121
+
If the **Interactive render mode** is `WebAssembly` or `Auto`, register SyncfusionBlazor services in both **~/Program.cs** files (Server and Client) of the Blazor Web App.
If the **Interactive Render Mode** is set to `Server`, your project will contain a single **~/Program.cs** file. So, you should register the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Service only in that **~/Program.cs** file.
155
+
If the **Interactive render mode** is `Server`, the project contains a single **~/Program.cs** file. In this case, register the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Service only in that **~/Program.cs** file.
The theme stylesheet and script can be accessed from NuGet through[Static Web Assets](https://blazor.syncfusion.com/documentation/appearance/themes#static-web-assets). Include the stylesheet reference in the `<head>`section and the script reference at the end of the `<body>` in the **~/Components/App.razor**file as shown below:
178
+
The theme stylesheet and script can be referenced from NuGet via[Static Web Assets](https://blazor.syncfusion.com/documentation/appearance/themes#static-web-assets). Add the theme stylesheet in the `<head>` and the script reference at the end of the `<body>` in **~/Components/App.razor** as shown:
179
179
180
180
```html
181
181
<head>
@@ -189,11 +189,11 @@ The theme stylesheet and script can be accessed from NuGet through [Static Web A
189
189
</body>
190
190
```
191
191
192
-
N> Check out the [Blazor Themes](https://blazor.syncfusion.com/documentation/appearance/themes)topic to discover various methods ([Static Web Assets](https://blazor.syncfusion.com/documentation/appearance/themes#static-web-assets), [CDN](https://blazor.syncfusion.com/documentation/appearance/themes#cdn-reference), and[CRG](https://blazor.syncfusion.com/documentation/common/custom-resource-generator)) for referencing themes in your Blazor application. Also, check out the [Adding Script Reference](https://blazor.syncfusion.com/documentation/common/adding-script-references) topic to learn different approaches for adding script references in your Blazor application.
192
+
N> For additional options, see [Blazor Themes](https://blazor.syncfusion.com/documentation/appearance/themes) to reference themes using [Static Web Assets](https://blazor.syncfusion.com/documentation/appearance/themes#static-web-assets), [CDN](https://blazor.syncfusion.com/documentation/appearance/themes#cdn-reference), or[CRG](https://blazor.syncfusion.com/documentation/common/custom-resource-generator). For script reference approaches, see [Adding script references](https://blazor.syncfusion.com/documentation/common/adding-script-references).
Add the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Split Button component in the **~Pages/.razor** file. If an interactivity location as `Per page/component` in the web app, define a render mode at the top of the `~Pages/.razor` component, as follows:
196
+
Add the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Split Button component in the **~Pages/.razor** file. If the interactivity location as `Per page/component` in the web app, define a render mode at the top of the `~Pages/.razor` component, as follows:
197
197
198
198
| Interactivity location | RenderMode | Code |
199
199
| --- | --- | --- |
@@ -202,7 +202,7 @@ Add the Syncfusion<sup style="font-size:70%">®</sup> Blazor Split Button com
202
202
|| Server |@rendermode InteractiveServer |
203
203
|| None | --- |
204
204
205
-
N> If an**Interactivity Location** is set to `Global` and the **Render Mode** is set to `Auto` or `WebAssembly` or `Server`, the render mode is configured in the`App.razor` file by default.
205
+
N> If the**Interactivity Location** is `Global` and the **Render Mode** is `Auto` or `WebAssembly` or `Server`, the render mode is configured in `App.razor` file by default.
206
206
207
207
{% tabs %}
208
208
{% highlight razor %}
@@ -227,7 +227,7 @@ N> If an **Interactivity Location** is set to `Global` and the **Render Mode** i
227
227
{% endhighlight %}
228
228
{% endtabs %}
229
229
230
-
* Press <kbd>Ctrl</kbd>+<kbd>F5</kbd> (Windows) or <kbd>⌘</kbd>+<kbd>F5</kbd> (macOS) to launch the application. This will render the Syncfusion<supstyle="font-size:70%">®</sup> Blazor Split Button component in your default web browser.
230
+
* Press <kbd>Ctrl</kbd>+<kbd>F5</kbd> (Windows) or <kbd>⌘</kbd>+<kbd>F5</kbd> (macOS) to launch the application. The Syncfusion<supstyle="font-size:70%">®</sup> Blazor Split Button component will render in the default web browser.
@@ -238,4 +238,4 @@ N> [View Sample in GitHub](https://github.com/SyncfusionExamples/Blazor-Getting-
238
238
*[Getting Started with Syncfusion<supstyle="font-size:70%">®</sup> Blazor Web Assembly App in Visual Studio or .NET CLI](https://blazor.syncfusion.com/documentation/getting-started/blazor-webassembly-app)
239
239
*[Getting Started with Syncfusion<supstyle="font-size:70%">®</sup> Blazor Web App in Visual Studio or .NET CLI](https://blazor.syncfusion.com/documentation/getting-started/blazor-web-app)
240
240
241
-
N> You can also explore our[Blazor Split Button example](https://blazor.syncfusion.com/demos/buttons/split-button?theme=bootstrap5)that shows you how to render and configure the Split Button.
241
+
N> Also explore the[Blazor Split Button example](https://blazor.syncfusion.com/demos/buttons/split-button?theme=bootstrap5)for rendering and configuration options.
0 commit comments