The SplitView Control
This page describes the SplitView control. The control is designed after the
[UWP SplitView]https://docs.microsoft.com/de-de/windows/uwp/design/controls-and-patterns/split-view).
As a result, the documentation pages are going to be very similar.
Consider reading the official Microsoft documentation for getting an overview for this control.
| Property | Type | Description |
|---|---|---|
| PanePlacement | SplitViewPanePlacement |
Gets or sets the placement position of the pane. |
| DisplayMode | SplitViewDisplayMode |
Gets or sets the SplitView's display mode, specifying how the pane display is handled. |
| IsPaneOpen | bool |
Gets or sets a value indicating whether the pane is currently opened. |
| CompactPaneLength | double |
Gets or sets the length of the pane when it is closed and in a compact display mode. |
| OpenPaneLength | double |
Gets or sets the length of the pane when it is opened. |
| Pane | object |
Gets or sets the pane's content. |
| PaneBackground | Brush |
Gets or sets the pane container's background brush. |
- Closed
- ClosedCompactLeft
- ClosedCompactRight
- OpenOverlayLeft
- OpenOverlayRight
- OpenInlineLeft
- OpenInlineRight
- OpenCompactOverlayLeft
- OpenCompactOverlayRight
- OpenCompactInlineLeft
- OpenCompactInlineRight
The SplitView consists of two areas:
- A Pane area, which is usually used for placing items like navigation elements.
- A Content area, which is used to display any kind of content. This content typically interacts with the elements in the pane.
The pane can be Open and Closed. If opened, the pane will always have the full width. If closed, the pane will either be narrowed down to a small strip, or hidden completely. The latter behavior depends on the pane's display mode.
The pane has four different display modes:
- Inline
- Overlay
- CompactInline
- CompactOverlay
Depending on whether the pane is opened or not, it is displayed like this:
When the pane is visible, it takes up space. When closed, it disappears completely.
The same as Inline, with the difference that the pane doesn't take up any space and thus hovers over the content.
The pane always takes up space. When opened, it is being expanded to its full width. When closed, it is being reduced to a small strip.
The same as CompactInline, with the difference that the pane hovers over the content when opened.
The SplitView also supports placing the pane to the right. This doesn't change anything about the display modes.
The only thing that changes is the animations and, obviously, the placement of the pane.