# Add Fluent-Qt to your existing project
include(FetchContent)
FetchContent_Declare(
fluentqt
GIT_REPOSITORY https://github.com/calvinhxx/Fluent-Qt.git
GIT_TAG v1.12.1
GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)
target_link_libraries(
my_app PRIVATE FluentQt::FluentQt
)
- UI 运行时
- Qt Widgets
- Qt 支持
- 5.15+ / 6.2+
- 工具链
- CMake + C++17
- 运行平台
- Windows / macOS / Linux / Web
01 / 开始使用
开始使用
在浏览器里直接试用 Gallery,或查看 C++ / Python 接入指南。
02 / GALLERY
控件示例
直接在浏览器中运行,无需本地安装 Qt;接入项目时需 Qt 5.15+ 或 6.2+。
- 01搜索
按控件名定位页面
- 02切换主题
切换浅色、深色、高对比度主题和动画模式
- 03查看示例
切换查看 C++ / Python 代码
05 / QUICK START
快速接入
将右侧 CMake 配置加入工程即可接入;同样支持 add_subdirectory 与 find_package。
- 保留现有 Widgets 工程与事件循环
- 核心库只依赖 Qt Widgets
- Qt 5 与 Qt 6 共用同一套接口
06 / SPATIAL · 可选 3D 扩展
Spatial 3D 透视视图
把现有 QWidget 界面放进 SpatialView,为卡片加上 3D 透视、旋转与景深;普通 2D 应用无需开启。
- 控件不必重写
保留原有布局、信号槽与数据模型,通过 SpatialItem 控制偏移与旋转。
- 硬件加速,按需刷新
桌面端使用 OpenGL,浏览器端使用 WebGL;画面不变时自动复用纹理。
- 按需启用,保留 2D
会话启动或视图创建失败时,由应用显示普通 QWidget 布局。
Gallery:Settings → 3D Gallery,再打开 Plugins → Spatial。
07 / QMLBRIDGE
嵌入 QML 页面
通过 QmlBridge 在 Qt Widgets 窗口中加载 QML 页面,直接共享业务数据与 Fluent 主题。
Gallery:Plugins → QmlBridge → QmlView。
C++ 片段
if (view->setContextObject(
"widgetInput", input)) {
view->load(QUrl("qrc:/Page.qml"));
}
Page.qml
import QtQuick 2.15
Text {
text: widgetInput.text
color: fluentTheme.text
font.family: fluentTheme.fontFamily
}
08 / POSITIONING
独立封装控件 不止是样式表
每个控件都提供完整的 C++ / Python 接口、交互状态与布局逻辑。
-
01
遵循 Qt Widgets 习惯
直接沿用现有的信号槽、布局器与事件循环。
-
02
同时兼容 Qt 5 与 Qt 6
业务代码无需针对 Qt 5 和 Qt 6 写两套调用。
-
03
接入简单干净
引入 <FluentQt/FluentQt.h> 并链接 FluentQt::FluentQt 即可使用。
09 / DOWNLOAD
下载 Gallery
下载桌面安装包即可离线浏览全部控件;项目集成请使用 CMake 或 pip。
python -m pip install FluentQt
10 / SPONSOR · 赛博投喂
大佬,赏点 Token?
开源用爱发电,奈何 AI 实在太费电。写 C++ 掉的是作者的头发,跑 Agent 烧的是真金白银的上下文。如果 Fluent-Qt 帮你的界面少踩了几个坑、省下了调样式的深夜,不妨投喂一点「赛博猫粮」——哪怕不够大模型塞牙缝,也能让维护者嘴角疯狂上扬。
在线投喂 · 美元(US$5 起)
正在召唤收款码…
哎呀,收款码在路上迷路了,刷新页面或换个档位再试试?
正在召唤收款码…
哎呀,收款码在路上迷路了,刷新页面或换个档位再试试?
正在召唤收款码…
哎呀,收款码在路上迷路了,刷新页面或换个档位再试试?
手机端冲浪?截屏后去微信或支付宝「扫一扫」里从相册召唤即可。
纯属自愿投喂,仅用于补充咖啡因与 Token,不解锁催更特权或付费服务(但会收获作者在心里的疯狂感谢)。 正经支持说明
正在加载示例…