更新客户端渲染，更新了壳

2026-07-06 23:05:40 +08:00
parent e7dd87bf7e
commit 31d778710b
1311 changed files with 172662 additions and 1582 deletions
@@ -0,0 +1,94 @@
+# 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.