# Add Fluent-Qt to your existing project
include(FetchContent)
FetchContent_Declare(
fluentqt
GIT_REPOSITORY https://github.com/calvinhxx/Fluent-Qt.git
GIT_TAG v1.9.3
GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)
target_link_libraries(
my_app PRIVATE FluentQt::FluentQt
)
Fluent-Qt
Qt Widgets 的 Fluent UI 组件库
提供基础输入、导航与数据展示等组件，内置主题切换与流畅动画，构建跨平台桌面应用。
C++17 Qt 5.15+ / 6.2+ MIT
- UI 运行时
- Qt Widgets
- Qt 支持
- 5.15+ / 6.2+
- 工具链
- CMake + C++17
- 运行平台
- Windows / macOS / Linux / Web
01 / 开始使用
开始使用 Fluent-Qt
先打开在线 Gallery 查看控件效果，或直接查看 C++ / Python 接入说明。
- 01搜索
按控件名定位页面
- 02验证
切换浅色、深色、高对比度主题与动效级别
- 03查看示例
展开对应的 C++ 代码
04 / QUICK START
快速接入
将片段放在 add_executable(my_app ...) 之后。新建工程可参考完整的 hello_world 示例。
- 保留现有 Widgets 工程与事件循环
- 库目标只依赖 Qt Widgets
- Qt 5 / Qt 6 使用同一应用层接口
05 / SPATIAL · 可选 3D 扩展
熟悉的控件，多一层空间。
把现有 QWidget 组合放进 SpatialView，为卡片加入透视、旋转与景深。普通 2D 应用无需启用。
- 控件不必重写
保留原有布局、signals / slots 和模型；SpatialItem 管理整组控件的姿态。
- 空间合成，按需刷新
桌面使用 OpenGL，WebAssembly 使用 WebGL；内容不变时复用纹理。
- 按需启用，保留 2D
C++ 链接 FluentQt::Spatial，Python 通过可选绑定使用。Gallery 在加速不可用时回退到 2D。
Gallery：Settings → 3D Gallery，再打开 Controls → Spatial。
直接运行真实的 SpatialView
两张卡片、实时图表和镜头控件，来自 C++ Gallery 的同一个示例。点击后加载 Qt / WASM。
06 / POSITIONING
原生控件 C++ 接口
每个控件都有独立的 C++ API、状态与布局行为
-
01
Qt Widgets 原生用法
沿用 signals、slots、layout 与事件循环
-
02
Qt 5 / Qt 6 共用接口
应用侧无需为 Qt 主版本维护两套调用
-
03
CMake 接入
包含 FluentQt/FluentQt.h，链接 FluentQt::FluentQt
07 / COMPONENTS
控件按用途分类
以下为 Gallery 中的部分控件
01
BASIC INPUT
Button
包含默认、强调、禁用和图标状态
02 / COLLECTIONSListView · GridView · TreeView
03 / SHELLNavigation · Windowing
08 / DOWNLOAD
下载 Gallery
桌面安装包用于离线体验；应用接入仍使用 CMake 或 PyPI。
为当前设备推荐
下载 Gallery
Windows · x64
最新 ReleaseLatest
全部版本与校验文件
可选兼容
Python / PySide6
python -m pip install FluentQt