Clarify the relationship between IsVisible and the visual tree in .NET MAUI documentation

[bhavanesh2001]

Type of issue

Missing information

Description

The current documentation in the Performance Best Practices for .NET MAUI article states:

"The IsVisible property of each element determines whether the element should be part of the visual tree or not."

This statement can be misleading because, in reality:

Setting IsVisible to false does not remove the element from the visual tree.
The element remains in the visual tree but is excluded from rendering and layout calculations.
This is inconsistent with the more accurate explanation in the VisualElement.IsVisible API documentation, which states:

"Gets or sets a value that determines whether this element will be visible on screen and take up space in layouts."

Suggested Action:

Clarify the performance article to specify that setting IsVisible to false excludes the element from rendering and layout calculations but keeps it in the visual tree for faster toggling.
This clarification would prevent misunderstandings about the behavior of the IsVisible property.

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0#reduce-the-visual-tree-size

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/deployment/performance.md

Document Version Independent Id

5845bd05-2151-862c-9b29-1d76664a9f0d

Article author

@davidbritch

Metadata

• ID: 5845bd05-2151-862c-9b29-1d76664a9f0d
• Service: dotnet-mobile
• Sub-service: dotnet-maui

Related Issues

---

Associated WorkItem - 359140