# style_qt

**Repository Path**: code_for_beauty/style_qt

## Basic Information

- **Project Name**: style_qt
- **Description**: 基于PySide6的Fluent UI组件库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fluent UI Library

基于 PySide6 的 Fluent 风格桌面组件库，提供主题化组件、可运行的组件 Gallery 和离屏行为回归测试。

## 组件范围

- **命令栏**：CommandBar 支持中文操作、图标、快捷键、强调色 Hover / Pressed 反馈与子菜单；按钮右键可复制文字，文本编辑和 SpinBox 共用中文右键菜单。

- **按钮**：基础、主操作、语义色、切换、标签、分组、下拉、加载与进度按钮。
- **输入与选择**：LineEdit、多选/单选 ComboBox、SpinBox / StackedSpinBox、DatePicker、TimePicker、CheckBox、RadioButton、Switch、Slider、ColorDialog。
- **导航与数据展示**：NavigationBar、TopNavigationBar / Pivot、ListView / ListItem、Pager、ImageWidget / CircularImageWidget、Card 系列、ProgressBar / ProgressRing。
- **反馈与窗口**：ToolTip、InfoBar、TeachingTip、Dialog、MessageBox、FilePicker、ScrollBar / ScrollArea。
- **基础设施**：Light / 暖色 Light / Dark Theme、跨平台字体 token、Lucide SVG 图标与 IconWidget。

组件列表、公开接口和用法见[组件使用手册](docs/component_guide.md)。设计约定与开发顺序见[设计规范](docs/design_spec.md)。

## 运行

```powershell
pip install PySide6
python main.py
```

Gallery 用于交互检查各组件状态和主题切换。

## 验证

```powershell
python -B -m compileall -q ui_library main.py
python -B -m unittest discover -s tests -v
```

测试默认使用 Qt offscreen 平台。它们检查组件行为和可渲染性；跨平台字体、DPI、弹层位置、系统阴影和焦点边框仍需人工视觉复核。