Skip to content

Commit ddf4acf

Browse files
authored
Clarify system backdrop limitations and SystemBackdropHost
Revised the background section to clarify the limitations of hosting system backdrops in WinUI3 compared to WinUI2, and improved the explanation of the `SystemBackdropHost` control.
1 parent 6055088 commit ddf4acf

File tree

1 file changed

+5
-7
lines changed

1 file changed

+5
-7
lines changed

specs/SystemBackdropHost Spec.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,15 @@ SystemBackdropHost
33

44
# Background
55

6-
System backdrop materials such as Mica, Acrylic etc are delivered through
7-
`Microsoft.UI.Xaml.Media.SystemBackdrop`. When you want to expose those materials inside a specific region of your UI
8-
rather than across an entire window, you need an element that can connect the backdrop to the visual tree, manage its
9-
lifetime, and clip it to the layout bounds. Today, you can only host a system backdrop at the window level, which makes
10-
it awkward to layer the effect behind individual sections of content or inside islands. There is no public stable API available
11-
in composition layer as well which allow apps to add backdrops in a specific area.
6+
There are some System backdrop materials such as Mica, Acrylic etc that are available in
7+
`Microsoft.UI.Xaml.Media.SystemBackdrop`. Today, its possible to host a system backdrop only at the window level and only for flyouts which makes
8+
it awkward to layer the effect behind individual containers / controls. This have been a major limitation on WinUI3 compared to WinUI2 in achieving the acrylic / mica effects.
129

1310
`SystemBackdropHost` is a lightweight `FrameworkElement` that bridges between the XAML tree and the composition
1411
infrastructure required by `SystemBackdrop`. It creates the composition link a backdrop needs, keeps the placement
1512
visual sized to the arranged bounds, and applies the element's `CornerRadius` to the backdrop clip so rounded corners
16-
appear as expected.
13+
appear as expected. This control abstracts lot of details for the composition layer and hence make it easy
14+
for WinUI3 developers to implement the acrylic effect in the applications.
1715

1816
## Goals
1917

0 commit comments

Comments
 (0)