[dev-v5] Add migration documentation for Fluent UI Blazor V5 components#4543
Open
AClerbois wants to merge 2 commits intomicrosoft:dev-v5from
Open
[dev-v5] Add migration documentation for Fluent UI Blazor V5 components#4543AClerbois wants to merge 2 commits intomicrosoft:dev-v5from
AClerbois wants to merge 2 commits intomicrosoft:dev-v5from
Conversation
- Created migration guides for various components including FluentOverlay, FluentPopover, FluentPresenceBadge, FluentPullToRefresh, FluentRatingDisplay, FluentSkeleton, FluentSlider, FluentSplitter, FluentTabs, FluentText, FluentTextField, FluentToast, FluentToolbar, and FluentWizard. - Documented changes, removed properties, and migration examples for each component to assist users in transitioning from V4 to V5. - Added an index page for the migration guide, summarizing general changes, component changes, removed components, and new components in V5. - Included a dedicated page for minor removed components with migration strategies.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds and updates the Demo documentation to provide a V4 → V5 migration guide set for Fluent UI Blazor, including an index page, per-component migration notes, and guidance for removed components.
Changes:
- Added a migration guide index page that links to general guidance, component-specific migrations, removed components, and new V5 replacements.
- Added new migration pages for multiple components (e.g., Overlay/Popover, Dialog, Select/List, Toast, Wizard, etc.) and a “minor removed components” page.
- Updated several existing migration pages to align with the new V5 documentation structure/content.
Reviewed changes
Copilot reviewed 52 out of 52 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationRemovedComponents.md | New page documenting minor removed V4 components and suggested replacements/patterns. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationIndex.md | New index page aggregating and linking to the migration guide content. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationGeneral.md | Updated “general” migration guidance (base class, providers, FluentField, scoped CSS). |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentWizard.md | New page documenting FluentWizard removal and suggested DIY patterns. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentTreeView.md | Trimmed/updated TreeView migration notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentTooltip.md | Trimmed/updated Tooltip migration notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentToolbar.md | New page documenting FluentToolbar removal and suggested FluentStack pattern. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentToast.md | New page documenting toast system removal and suggested alternatives. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentTextField.md | New page documenting TextField/NumberField/Search consolidation into FluentTextInput. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentTextArea.md | Updated title and pruned “new properties/values” section. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentText.md | New page introducing FluentText and mapping from FluentLabel. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentTabs.md | New page documenting Tabs/Tab breaking changes and migration example. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentStack.md | Removed an outdated “new properties” note. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentSplitter.md | New page documenting FluentSplitter removal and FluentMultiSplitter changes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentSortableList.md | Added front matter; pruned an “added CSS vars” block. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentSlider.md | New page documenting Slider breaking changes (orientation nullability, removed label component, constraints). |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentSkeleton.md | New page documenting Skeleton rendering and API changes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentSelect.md | Expanded Select migration doc with new base class + generic type parameter changes and updated mappings. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentRatingDisplay.md | New page documenting migration from FluentRating to FluentRatingDisplay. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentRadio.md | Updated Radio migration notes (removed incorrect base-class claim; clarified ChildContent guidance). |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentProgressRing.md | Removed an outdated “new properties” section; retained renamed properties notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentProgressBar.md | Removed an outdated “new properties” section; retained renamed properties notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentPresenceBadge.md | New page documenting PresenceBadge redesign and parameter/enum mappings. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentPopover.md | New page documenting Popover rewrite, API renames, and removed positioning/focus props. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentOverlay.md | New page documenting Overlay rewrite and new API (CloseMode, Opacity type change, methods). |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentNavMenu.md | New page documenting NavMenu removal and FluentNav replacement mappings. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentMessageBar.md | Removed an outdated “new properties” section; kept rename notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentMenuButton.md | New page documenting MenuButton redesign and new composition model with FluentMenu. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentMenu.md | Added front matter; removed outdated “new parameters” section; kept removed params. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentList.md | New page covering list-family changes (Autocomplete removal, type params, Option changes). |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentLabel.md | Updated title and pruned “new properties” section. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentKeyCode.md | New page documenting KeyCode parameter behavioral change + provider async handling note. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentInputFile.md | New page documenting InputFile event args change + error consolidation. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentIcon.md | New page documenting FluentIcon default color behavior change. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentGrid.md | New page documenting Grid spacing default change + GridItem rename reminder. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentField.md | New page introducing FluentField and mapping from prior validation/label patterns. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentDivider.md | New page documenting Divider API removals and migration snippet. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentDialog.md | New page documenting dialog system redesign and major API changes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentDesignTheme.md | New page documenting theming component removals and CSS-variable approach. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentDateTime.md | New page documenting DatePicker/TimePicker generic parameterization and UX/API changes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentDataGrid.md | Added front matter to existing DataGrid migration doc. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentCounterBadge.md | Added front matter to existing CounterBadge migration doc. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentCheckbox.md | New page documenting FluentCheckbox label/field wrapping and removed ChildContent. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentCard.md | New page documenting Card web-component removal and removed properties. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentButton.md | Removed an outdated “new properties” section; kept rename notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentBreadcrumb.md | New page documenting Breadcrumb removal and suggested DIY replacement. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentBadge.md | Added front matter; pruned “new parameters” section. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentAppBar.md | New page documenting minor AppBar changes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentAnchor.md | New page documenting Anchor removal and mapping to FluentLink/FluentAnchorButton. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentAccordion.md | Added front matter; replaced long “new parameters” section with concise rename notes. |
| examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MIgrationFluentSpacer.md | Added front matter; pruned an “added properties” section (note file name casing). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationIndex.md
Show resolved
Hide resolved
examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MIgrationFluentSpacer.md
Show resolved
Hide resolved
...Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentRatingDisplay.md
Show resolved
Hide resolved
...Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentRatingDisplay.md
Show resolved
Hide resolved
examples/Demo/FluentUI.Demo.Client/Documentation/GetStarted/Migration/MigrationFluentAnchor.md
Show resolved
Hide resolved
- Added new properties for FluentSpacer, FluentAccordion, FluentAnchor, FluentBadge, FluentButton, FluentCard, FluentCheckbox, FluentCounterBadge, FluentDataGrid, FluentDivider, FluentIcon, FluentInputFile, FluentLabel, FluentMenu, FluentMessageBar, FluentPresenceBadge, FluentProgressBar, FluentProgressRing, FluentRadio, FluentSlider, FluentSortableList, FluentStack, FluentSwitch, FluentTabs, FluentTextArea, FluentTooltip, and FluentTreeView. - Documented renamed and removed properties across various components. - Updated type changes and migration examples for better clarity.
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
1 participant
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.
Pull Request
📖 Description
📑 Test Plan
Review each file and feel free to update the markdown files
✅ Checklist
General
Component-specific
⏭ Next Steps