Uno Navigation Regions — Agent Skill
Workflow
Docs lookup: call
uno_platform_docs_search(...)first, thenuno_platform_docs_fetch(sourcePath="…")using thesourcePathfield from a result (a relative.mdpath; add the result'sanchorfor a section). Never pass a URL, a.htmllink, or a hand-built path.
Step 1: Fetch the Regions Documentation
uno_platform_docs_search("Uno Navigation regions Region.Attached Region.Name navigator")
Primary documentation pages:
- Define Regions Walkthrough:
external/uno.extensions/doc/Learn/Navigation/Walkthrough/DefineRegions.md - How-To: Define Regions:
external/uno.extensions/doc/Learn/Navigation/HowTo-Regions.md - Navigation Region Reference:
external/uno.extensions/doc/Reference/Navigation/NavigationRegion.md
Fetch the walkthrough:
uno_platform_docs_fetch(sourcePath="external/uno.extensions/doc/Learn/Navigation/Walkthrough/DefineRegions.md")
Step 2: For Common Pitfalls
Fetch the how-to page for important warnings:
uno_platform_docs_fetch(sourcePath="external/uno.extensions/doc/Learn/Navigation/HowTo-Regions.md")
Critical warning: Do NOT use Region.Attached="True" inside Shell.xaml or ExtendedSplashScreen content.
Step 3: For NavigationView with Regions
The walkthrough includes a section on "Using Regions with NavigationView".
Step 4: For Visibility-Based Navigation
If the user needs visibility-based content switching:
See the uno-navigation-panel-visibility skill.
Key Principles (Stable)
uen:Region.Attached="True"— enables region-based navigation on a containeruen:Region.Name="RouteName"— identifies which route this region representsuen:Region.Navigator="Visibility"— switches content by toggling visibility- CRITICAL: Never use
Region.Attached="True"inside Shell.xaml content — the navigation host isn't ready yet - Regions mirror the navigation control hierarchy
- Navigation controls (TabBar, NavigationView) and content areas must share a common parent with
Region.Attached="True"
Related Skills
- [[uno-navigation-setup]] — Navigation host configuration
- [[uno-navigation-panel-visibility]] — Visibility-based navigation
- [[uno-navigation-navigationview]] — NavigationView with regions
- [[uno-navigation-tabbar]] — TabBar with regions