# 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 / 快速開始
開始使用 Fluent-Qt
直接在瀏覽器體驗 Gallery,或前往 C++ / Python 整合指南。
02 / GALLERY
控制項範例
直接在瀏覽器執行,無需本機安裝 Qt(專案整合需要 Qt 5.15+ 或 6.2+)。
- 01搜尋
依控制項名稱快速定位頁面
- 02切換主題
即時切換淺色、深色、高對比主題與動畫模式
- 03檢視範例碼
於 C++ 與 Python 程式碼之間切換
05 / QUICK START
快速開始
將右側 CMake 設定加入專案即可整合;亦支援 add_subdirectory 與 find_package。
- 沿用現有的 Qt Widgets 專案與事件迴圈
- 核心函式庫僅依賴 Qt Widgets
- Qt 5.15+ 與 Qt 6.2+ 共用相同介面
06 / SPATIAL · 選用 3D 擴充
Spatial 3D 透視檢視
將現有 QWidget 版面放入 SpatialView,為卡片加上 3D 透視、旋轉與景深;一般 2D 應用無需啟用。
- 無需重寫既有控制項
沿用原有的版面配置、訊號槽與資料模型,透過 SpatialItem 控制 3D 偏移與傾角。
- 硬體加速,按需更新
桌面端採用 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
一套 API 同時支援 Qt 5 與 Qt 6
業務程式碼無需為 Qt 5 與 Qt 6 分別維護兩套實作。
-
03
簡潔乾淨的 CMake 整合
引入 <FluentQt/FluentQt.h> 並連結 FluentQt::FluentQt 即可開始。
09 / DOWNLOAD
下載 Gallery
下載獨立桌面安裝檔即可離線瀏覽所有控制項;專案整合請使用 CMake 或 pip。
python -m pip install FluentQt
10 / SPONSOR · 贊助支持
請作者喝杯咖啡?
開源專案主要靠熱情與咖啡因維持,而現在開發與維護也離不開大量的 AI 代理推論與上下文消耗。如果 Fluent-Qt 幫你的 Qt 介面省下了反覆調整樣式與排版的心力,歡迎隨心贊助支持,每一份鼓勵都是持續更新的動力。
線上贊助 · 美元(US$5 起)
正在載入付款條碼…
付款條碼載入失敗,請重新整理或切換其他方案再試。
正在載入付款條碼…
付款條碼載入失敗,請重新整理或切換其他方案再試。
正在載入付款條碼…
付款條碼載入失敗,請重新整理或切換其他方案再試。
正在使用手機瀏覽?可先截圖後,於微信或支付寶的「掃一掃」從相簿選取。
純屬自願贊助,僅用於補充咖啡與維護成本,不提供付費 SLA 或優先處理承諾,由衷感謝。 支持說明
正在載入範例…