From 0170d0ccbf72fc2325d53e7ca95559ba552c3754 Mon Sep 17 00:00:00 2001 From: Gaalbu Date: Sun, 13 Sep 2026 19:57:47 -0300 Subject: [PATCH] docs(material): clarify Shadow DOM limitations Explain the additional styling considerations for overlay components in shadow roots. --- guides/theming.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/guides/theming.md b/guides/theming.md index c9610de48f1b..a6e18a9e70e2 100644 --- a/guides/theming.md +++ b/guides/theming.md @@ -574,3 +574,7 @@ in your application, you must load the theme styles within each shadow root that contains an Angular Material component. You can accomplish this by manually loading the CSS in each shadow root, or by using [Constructable Stylesheets](https://web.dev/articles/constructable-stylesheets). + +Loading the theme styles in a shadow root does not move Angular Material's component styles or +overlay containers into that root. Components that render overlays, such as dialogs and menus, +may therefore need additional styling and overlay configuration when used inside Shadow DOM.