# OnePro.WPF

**Repository Path**: one996/one-pro.-wpf

## Basic Information

- **Project Name**: OnePro.WPF
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-28
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OnePro WPF Controls

面向现代桌面应用的 WPF 自定义控件库：主题化（Light/Dark/HighContrast）、Design Tokens、控件模板可扩展、MVVM 友好，并提供 Demo 工程用于快速预览与回归验证。

- 目标框架：.NET 8（`net8.0-windows`）
- 主题：Light / Dark / HighContrast，可运行时切换
- 质量：xUnit（含 `StaFact`）单元测试 + Demo 回归页

## 快速开始

1. 打开解决方案：`onepro.sln`
2. 运行 Demo：

```bash
dotnet run --project .\samples\OnePro.Controls.Demo\OnePro.Controls.Demo.csproj
```

3. Demo 顶部按钮可切换主题：Light / Dark / HighContrast

## 功能概览

**控件（部分）**
- Button / Input：OneButton、OneTextBox、NumberBox、AutoCompleteBox
- Toggles：ToggleSwitch、SegmentedControl、Tabs
- Layout / Visual：Card、Badge、Divider、Skeleton、ProgressRing
- Navigation：OneNavigator、Breadcrumb、OneNavigationBar
- Panels：VirtualizingWrapPanel、UniformPanel、ResponsivePanel

**全局样式（原生控件美化）**
- DataGrid：表头 hover/pressed、排序箭头、文本一致性修复
- ListBox / ListView：容器 + Item 全局皮肤（hover/selected/disabled），字符串内容不丢字
- TreeView：全局皮肤 + 默认开启虚拟化

**服务能力**
- Dialog（模态弹窗）：`DialogService` + `OneDialogHost`（Demo 已提供全局 Host）
- Toast（消息提示）：`ToastService` + `OneToastHost`（Demo 已提供全局 Host）

**增强控件**
- OneToolTip：延迟显示、最大宽度、自动换行、主题化
- OneTreeView：懒加载（展开触发 LoadChildrenCommand）+ 复选框三态联动（Down/Up/Both）

**通用转换器（Primitives）**
- `BoolToVisibility`、`InverseBoolConverter`、`NullToVisibility`、`ColorToBrush`
- 主题字典已合并 converters 资源，XAML 可直接 `StaticResource` 使用

## 开发与验证

构建：

```bash
dotnet build .\onepro.sln -c Debug
```

运行测试：

```bash
dotnet test
```

## 目录结构

- `src/OnePro.Controls`：控件库（主题/模板在 `Themes/Generic.xaml`）
- `src/OnePro.Controls.Primitives`：基础设施（Converters 等）
- `samples/OnePro.Controls.Demo`：Demo 预览工程（含各控件回归页）
- `tests/OnePro.Controls.Tests`：单元测试
- `docs`：规划/设计/文档（含本仓库的 specs/plans）

## 文档（可选）

仓库内置 DocFX（可选），见 `docs` 目录。快速预览：

```bash
docfx build
docfx serve site -p 8080
```

## 贡献

欢迎通过 Issue/PR 参与共建；贡献指南见 [docs/contributing.md](docs/contributing.md)。