[docs] Unclear documentation for container prop when using Shadow DOM

[trygve-aaberge-adsk]

Related page

https://mui.com/material-ui/customization/shadow-dom/

Kind of issue

Unclear explanations

Issue description

The documentation says:

Material UI components like Menu, Dialog, Popover, and others use the Portal component to render a new "subtree" in a container outside of current DOM hierarchy.

However, the example below only sets the container prop for MuiPopover, MuiPopper and MuiModal, not for MuiMenu or MuiDialog. After looking into it, I see that Menu inherits the Popover props and Dialog inherits the Modal props. So presumably setting it for Popover and Modal will make it be used by Menu and Dialog too? However, I can't find documentation stating that the default props are inherited too, and it's not clear that this inheritance exists from the shadow DOM documentation.

This is a bit besides the point for documentation, but it's also a bit inconvenient having to specify the container separately for each component. What if new components are added that also requires setting a container? This could be easy to miss.

Context

Trying to use Material UI inside a shadow DOM element.

Search keywords: shadow dom container

[mj12albert]

In the API docs (dialog for example) there's usually a sentence saying

Props of the Modal component are also available.

Is that the general issue you find unclear about the docs? (and not specifically the container prop or shadow dom) @trygve-aaberge-adsk

[trygve-aaberge-adsk]

No, I saw that part. The issues are:

1. It's hard to know which components I have to set the container prop for. The docs say "Material UI components like Menu, Dialog, Popover, and others". Do I have to go through all the components to see if they have the container prop to figure out which ones to set it for?
2. It's unclear if the default props are inherited when a component inherits from another component. So since Dialog inherits from Modal, it also has the container prop. But do I have to set the default prop for Dialog as well, or will it use the default prop from Modal automatically?

Since the example code only sets it for MuiPopover, MuiPopper and MuiModal, presumably that's enough? But it's not clear whether this is a complete example or not.