Fluent-Qt

面向 Qt Widgets 的 Fluent UI 元件庫

提供輸入、導覽、資料表與圖表等常用控制項,內建淺色與深色主題及流暢動畫,輕鬆打造跨平台桌面介面。

C++17 Qt 5.15+ / 6.2+ MIT

Python / PySide6 Python 專案亦可透過 PySide6 使用同一套控制項 pip install FluentQt Gallery
Windows 下啟用 3D 與 Mica 效果的 Fluent-Qt Gallery Home 實機截圖,展示控制項目錄與範例
UI 執行環境
Qt Widgets
Qt 支援
5.15+ / 6.2+
工具鏈
CMake + C++17
執行平台
Windows / macOS / Linux / Web

03 / CHECKBOX

屬性動態預覽

在支援屬性預覽的元件頁面中,可即時調整真實 Qt 控制項的屬性並複製產生的 C++ 或 PySide6 程式碼。

CheckBox 屬性面板,顯示已勾選的核取方塊與產生的 C++ 程式碼。

04 / GUI SKILL

用 AI 輔助建置桌面 GUI

  • 專案結構產生分層清晰的 C++ 或 PySide6 專案架構
  • UI 與主題精準搭配 Fluent 控制項、配色與字級規範
  • 即時預覽先於 Live Scene 即時檢視修改,再編譯確認實際 C++ 渲染結果
  • UI 自動檢查檢查淺色/深色主題、窄視窗排版與無障礙屬性
參考實作 DeepSeek Desktop
C++ · FluentQt
使用 build-fluentqt-gui 建置的 DeepSeek Desktop 原生桌面參考介面

任務分組、執行時間軸、輸入區與淺色 / 深色主題。

由 FluentQt 獨立實作,非 DeepSeek 官方應用程式。

上游專案

05 / QUICK START

快速開始

將右側 CMake 設定加入專案即可整合;亦支援 add_subdirectory 與 find_package。

  • 沿用現有的 Qt Widgets 專案與事件迴圈
  • 核心函式庫僅依賴 Qt Widgets
  • Qt 5.15+ 與 Qt 6.2+ 共用相同介面
CMakeLists.txt
# 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
)

06 / SPATIAL · 選用 3D 擴充

Spatial 3D 透視檢視

將現有 QWidget 版面放入 SpatialView,為卡片加上 3D 透視、旋轉與景深;一般 2D 應用無需啟用。

  • 無需重寫既有控制項

    沿用原有的版面配置、訊號槽與資料模型,透過 SpatialItem 控制 3D 偏移與傾角。

  • 硬體加速,按需更新

    桌面端採用 OpenGL,瀏覽器端採用 WebGL;靜態畫面自動重用快取紋理。

  • 按需啟用,保留 2D 回退

    若工作階段啟動或檢視建立失敗,應用程式會回退至一般 QWidget 版面。

Gallery:Settings → 3D Gallery,接著開啟 Plugins → Spatial。

SpatialView · C++ / WebAssembly
正在載入範例…

拖動滑桿調整視角,移動游標體驗景深效果。

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
}
Widgets 輸入框與 QML 文字的繫結範例。

08 / POSITIONING

獨立封裝控制項, 而不只是樣式表

每個控制項皆提供完整的 C++ / Python 介面、互動狀態與版面配置行為。

  1. 01

    遵循 Qt Widgets 慣例

    無縫搭配既有的訊號槽、版面配置器與事件迴圈。

  2. 02

    一套 API 同時支援 Qt 5 與 Qt 6

    業務程式碼無需為 Qt 5 與 Qt 6 分別維護兩套實作。

  3. 03

    簡潔乾淨的 CMake 整合

    引入 <FluentQt/FluentQt.h> 並連結 FluentQt::FluentQt 即可開始。

09 / DOWNLOAD

下載 Gallery

下載獨立桌面安裝檔即可離線瀏覽所有控制項;專案整合請使用 CMake 或 pip。

10 / SPONSOR · 贊助支持

請作者喝杯咖啡?

開源專案主要靠熱情與咖啡因維持,而現在開發與維護也離不開大量的 AI 代理推論與上下文消耗。如果 Fluent-Qt 幫你的 Qt 介面省下了反覆調整樣式與排版的心力,歡迎隨心贊助支持,每一份鼓勵都是持續更新的動力。

微信掃碼贊助
維護者的微信收款 QR Code
支付寶掃碼贊助
維護者的支付寶收款 QR Code
掃描 Ko-fi 行動條碼
維護者的 Ko-fi 主頁 QR Code

前往 Ko-fi 贊助 ↗

正在使用手機瀏覽?可先截圖後,於微信或支付寶的「掃一掃」從相簿選取。

純屬自願贊助,僅用於補充咖啡與維護成本,不提供付費 SLA 或優先處理承諾,由衷感謝。 支持說明

透過 Ko-fi 贊助 Fluent-Qt(USD)

支援 PayPal 與信用卡;按 Esc 關閉,或 前往 Ko-fi 贊助 ↗