Skip to content

docs(DockManager): add dockmanager documentation #2742

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Feb 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
95 changes: 95 additions & 0 deletions components/dockmanager/accessibility/wai-aria-support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
title: Wai-Aria Support
page_title: Telerik UI for Blazor DockManager Documentation | DockManager Accessibility
description: "Get started with the Telerik UI for Blazor DockManager and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.2."
tags: telerik,blazor,accessibility,wai-aria,wcag
slug: dockmanager-wai-aria-support
position: 50
---

# Blazor DockManager Accessibility

@[template](/_contentTemplates/common/parameters-table-styles.md#table-layout)



Out of the box, the Telerik UI for Blazor DockManager provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.


The DockManager is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 AA](https://www.w3.org/TR/WCAG22/) standards and [Section 508](https://www.section508.gov/) requirements, follows the [Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA)](https://www.w3.org/WAI/ARIA/apg/) best practices for implementing the [keyboard navigation](#keyboard-navigation) for its `component` role, provides options for managing its focus and is tested against the most popular screen readers.

## WAI-ARIA


This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.


The DockManager component consists of multiple inner panes, each containing tools, tabs, and content that can be resized, rearranged, and interacted with.

| Selector | Attribute | Usage |
| -------- | --------- | ----- |
| `.k-dock-manager` | `role=application` | Indicates that the DockManager has its own keyboard navigation implemented. |
| | `aria-live=polite` | Defines dynamic content changes within the DockManager container that need to be announced by screen readers. |
| `.k-dock-navigator` | `aria-hidden=true` | The navigator needs to be hidden from the readers as it appears only on drag. |

### DockManager Toolbar


The Toolbar in the DockManager element of the component should implement the specification for the **Toolbar** component.

[Toolbar accessibility specification]({{Toolbar_a11y_link}})

### DockManager TabStrip


The TabStrip in the DockManager element of the component should implement the specification for the **TabStrip** component.

[TabStrip accessibility specification]({{TabStrip_a11y_link}})

### DockManager Splitter


The Splitter in the DockManager element of the component should implement the specification for the **Splitter** component.

[Splitter accessibility specification]({{Splitter_a11y_link}})

### DockManager Window


The Window elements in the DockManager element of the component should implement the specification for the **Window** component.

[Window accessibility specification]({{Window_a11y_link}})

## Section 508


The DockManager is fully compliant with the [Section 508 requirements](http://www.section508.gov/).

## Testing


The DockManager has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.

> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).

### Screen Readers


The DockManager has been tested with the following screen readers and browsers combinations:

| Environment | Tool |
| ----------- | ---- |
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |



## Keyboard Navigation

For details on how the keyboard navigation works in Telerik UI for Blazor, refer to the [Accessibility Overview](slug://accessibility-overview#keyboard-navigation) article.

## See Also

* [Blazor Dock Manager Demos](https://demos.telerik.com/blazor-ui/dockmanager/overview)
* [Accessibility in Telerik UI for Blazor](slug://accessibility-overview)
76 changes: 76 additions & 0 deletions components/dockmanager/docking-types.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: Docking Types
page_title: DockManager - Docking Types
description: Docking Types in the DockManager for Blazor.
slug: dockmanager-dock-types
tags: telerik, blazor, dockmanager, docking
published: true
position: 10
---

# Docking Panes

The Blazor DockManager component exposes the ability to dock globally or within other panes.

## Docking Types

### Global Docking

When a user drags a pane, a global docking navigator always appears. This allows the user to dock the pane to one of the component's edges, making it a root pane.

### Inner Docking

When a user drags a pane and hovers over another pane, a dock navigator for that pane appears. The user can then choose to:

* Drop the pane on any of the parent pane’s outer edges, splitting it.
* Drop it in the center of the navigator to add it as a tab within the parent pane.

## Disable Docking over Individual Panes

To disable docking over a specific pane, set its `Dockable` parameter to `false`.

>caption DockManager with disabled docking option over some panes.

`````RAZOR
<TelerikDockManager Height="80vh">
<DockManagerPanes>

<DockManagerSplitPane>
<Panes>

<DockManagerContentPane HeaderText="Pane 1" Dockable="@Pane1Dockable">
<Content>
<TelerikToggleButton @bind-Selected="@Pane1Dockable">Enable Docking Over Pane 1</TelerikToggleButton>
</Content>
</DockManagerContentPane>

<DockManagerContentPane HeaderText="Pane 2" Dockable="Pane2Dockable">
<Content>
<TelerikToggleButton @bind-Selected="@Pane2Dockable">Enable Docking Over Pane 2</TelerikToggleButton>
</Content>
</DockManagerContentPane>

</Panes>
</DockManagerSplitPane>
</DockManagerPanes>

<DockManagerFloatingPanes>
<DockManagerSplitPane>
<Panes>

<DockManagerContentPane HeaderText="Floating Pane">
<Content>
Floating Pane Content
</Content>
</DockManagerContentPane>

</Panes>
</DockManagerSplitPane>
</DockManagerFloatingPanes>
</TelerikDockManager>

@code {
private bool Pane1Dockable { get; set; } = true;
private bool Pane2Dockable { get; set; } = true;
}
`````
Loading
Loading