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.

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.