Refresh navigation control docs for current Avalonia APIs#1038
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refreshes Avalonia navigation control documentation pages so they align with the current API surface and documented behavior for CommandBar, ContentPage, DrawerPage, NavigationPage, and TabbedPage.
Changes:
- Adds
idfrontmatter and restructures/rewrites the five navigation control reference pages for updated concepts, properties, events, and examples. - Updates naming and guidance to match current controls (notably
CommandBar*types) and newer navigation patterns (page lifecycle timing, icon templates, drawer header/footer templates). - Improves page structure and cross-linking (new “See also” sections and more consistent navigation between related pages).
Reviewed changes
Copilot reviewed 5 out of 17 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| controls/navigation/tabbedpage.md | Reworks TabbedPage reference content, properties/events, and examples; adds new screenshots and cross-links. |
| controls/navigation/navigationpage.md | Rewrites NavigationPage docs with updated property/method/event coverage and refreshed examples/screenshots. |
| controls/navigation/drawerpage.md | Updates DrawerPage reference with new property tables, examples, and expanded behavior description. |
| controls/navigation/contentpage.md | Refreshes ContentPage reference, clarifies header usage and lifecycle events, and updates examples. |
| controls/navigation/commandbar.md | Updates CommandBar documentation to current control names and behavior, expands examples, and adds more property coverage. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR updates the navigation control documentation to match the current Avalonia API surface and behavior for
CommandBar,ContentPage,DrawerPage,NavigationPage, andTabbedPage.The docs had drifted from recently merged navigation-related API changes. This update replaces stale control names, corrects property defaults and event signatures, and aligns examples with the current source, themes, tests, and ControlCatalog samples.
ContentPage,NavigationPage,DrawerPage, andTabbedPagedocumentation shape.TabItem.Icon/IconTemplateTabbedPageicon guidance and examples.Page.IconTemplateandDrawerPage.DrawerIconTemplateContentPagestyle key overrideContentPagestyling guidance with current behavior.DrawerHeaderTemplate/DrawerFooterTemplateAppBarButton,AppBarToggleButton, andAppBarSeparatorreferences withCommandBarButton,CommandBarToggleButton, andCommandBarSeparator.DrawerPage,NavigationPage, andContentPage.NavigationPagebehavior documentation aligned with current back-navigation routing.