95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
# Migration plan
|
||
|
||
This page outlines key changes and important details to consider when migrating. It highlights what’s new, what’s changed, and any steps you need to take to ensure a smooth transition. This isn’t a full step-by-step guide but a quick reference to help you navigate the most critical parts of the migration process.
|
||
|
||
## Key changes in v2
|
||
|
||
### Global namespace change
|
||
|
||
In version 2.0 the namespace has been changed from `WPF-UI` to the more .NET compatible `Wpf.Ui`. The package name has not been changed to maintain branding and consistency.
|
||
|
||
### Navigation
|
||
|
||
The navigation control has been rewritten yet again, making it almost completely incompatible.
|
||
|
||
All navigation controls inherit from `Wpf.Ui.Controls.Navigation.NavigationBase` base class.
|
||
|
||
```xml
|
||
<ui:NavigationStore
|
||
Frame="{Binding ElementName=RootFrame}"
|
||
Precache="False"
|
||
SelectedPageIndex="-1"
|
||
TransitionDuration="200"
|
||
TransitionType="FadeInWithSlide">
|
||
<ui:NavigationStore.Items>
|
||
<ui:NavigationItem
|
||
Cache="True"
|
||
Content="Home"
|
||
Icon="Home24"
|
||
PageTag="dashboard"
|
||
PageType="{x:Type pages:Dashboard}" />
|
||
<ui:NavigationSeparator />
|
||
</ui:NavigationStore.Items>
|
||
<ui:NavigationStore.Footer>
|
||
<ui:NavigationItem
|
||
Click="NavigationButtonTheme_OnClick"
|
||
Content="Theme"
|
||
Icon="DarkTheme24" />
|
||
</ui:NavigationStore.Footer>
|
||
</ui:NavigationStore>
|
||
```
|
||
|
||
```xml
|
||
<ui:NavigationFluent
|
||
Frame="{Binding ElementName=RootFrame}"
|
||
Precache="False"
|
||
SelectedPageIndex="-1"
|
||
TransitionDuration="200"
|
||
TransitionType="FadeInWithSlide">
|
||
<ui:NavigationFluent.Items>
|
||
<ui:NavigationItem
|
||
Cache="True"
|
||
Content="Home"
|
||
Icon="Home24"
|
||
PageTag="dashboard"
|
||
PageType="{x:Type pages:Dashboard}" />
|
||
<ui:NavigationSeparator />
|
||
</ui:NavigationFluent.Items>
|
||
<ui:NavigationFluent.Footer>
|
||
<ui:NavigationItem
|
||
Click="NavigationButtonTheme_OnClick"
|
||
Content="Theme"
|
||
Icon="DarkTheme24" />
|
||
</ui:NavigationFluent.Footer>
|
||
</ui:NavigationFluent>
|
||
```
|
||
|
||
```xml
|
||
<ui:NavigationCompact
|
||
Frame="{Binding ElementName=RootFrame}"
|
||
Precache="False"
|
||
SelectedPageIndex="-1"
|
||
TransitionDuration="200"
|
||
TransitionType="FadeInWithSlide">
|
||
<ui:NavigationCompact.Items>
|
||
<ui:NavigationItem
|
||
Cache="True"
|
||
Content="Home"
|
||
Icon="Home24"
|
||
PageTag="dashboard"
|
||
PageType="{x:Type pages:Dashboard}" />
|
||
<ui:NavigationSeparator />
|
||
</ui:NavigationCompact.Items>
|
||
<ui:NavigationCompact.Footer>
|
||
<ui:NavigationItem
|
||
Click="NavigationButtonTheme_OnClick"
|
||
Content="Theme"
|
||
Icon="DarkTheme24" />
|
||
</ui:NavigationCompact.Footer>
|
||
</ui:NavigationCompact>
|
||
```
|
||
|
||
### Titlebar
|
||
|
||
The titlebar control has been rewritten yet again, making it almost completely incompatible.
|