# WpfUITemplate

**Repository Path**: erick1999/wpf-uitemplate

## Basic Information

- **Project Name**: WpfUITemplate
- **Description**: wpfui快速开发界面 包含简单的主界面设置 适合简单快速开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WpfMainUIDemo — WPF 快速界面开发模板

基于 **.NET 8 + WPF-UI(Fluent) + Prism(DryIoc)** 的可复用 WPF 主界面模板框架。

核心特性：

- **特性驱动的页面注册**：新增页面只需给视图类加一个 `[NavPage]` 特性，菜单自动出现、点击即切换，无需改任何导航代码。
- **菜单可配置**：菜单名称 / 图标 / 顺序 / 显隐可通过 `Config/nav.json` 覆盖，改配置不改代码。
- **四套可复用主界面样式(Shell)**：经典左侧导航、工业大屏、顶部横向菜单、无边框折叠菜单。通过 `Config/shell.json` 或界面右上角下拉框一键切换。
- **深/浅色主题**：一键切换。

## 目录结构

```
WpfMainUIDemo.sln
src/
  WpfMainUIDemo.Core/            # 与 UI 无关的内核：导航特性、注册中心、配置、MVVM 基类
    Navigation/                  #   NavPageAttribute / NavItem / NavigationRegistry / RegionNames
    Config/                      #   nav.json / shell.json 加载器
    Mvvm/                        #   ViewModelBase
  WpfMainUIDemo.App/             # 启动宿主 + 四套 Shell + 主题
    Shells/                      #   ClassicNav / Dashboard / TopMenu / Frameless
    Themes/Shared.xaml           #   共享样式与转换器
    Converters/                  #   StringToSymbolConverter
    Config/nav.json, shell.json  #   运行期配置(拷贝到输出目录)
    App.xaml(.cs)                #   Prism 启动器
  WpfMainUIDemo.Modules.Sample/  # 示例业务模块：4 个演示页面
    Views/ ViewModels/           #   HomePage / DeviceMonitorPage / ReportPage / SettingsPage
docs/                            # 文档
```

## 运行

```powershell
dotnet build
dotnet run --project src/WpfMainUIDemo.App
```

## 更多文档

- [使用指南](使用指南.md)：如何新增页面、改菜单名、切换/新增主界面样式。
- [架构说明](架构说明.md)：分层设计与导航原理。
- [立体仓库 3D 示例讲解](立体仓库3D示例.md)：HelixToolkit 数字孪生大屏入门。