README_zh.md

PyQt-Fluent-Widgets

基于 PyQt5 的 Fluent Design 风格组件库

English | 简体中文 | 官方网站

安装📥

安装轻量版 (亚克力组件不可用)：

pip install PyQt-Fluent-Widgets -i https://pypi.org/simple/

安装完整版：

pip install "PyQt-Fluent-Widgets[full]" -i https://pypi.org/simple/

如果项目中使用的是 PySide2、PySide6 或者 PyQt6，需切换至 PySide2、PySide6 和 PyQt6 分支下载对应的代码。

商用高级版 组件库包含更多组件，可从 发行页面 下载体验编译好的示例程序 PyQt-Fluent-Widgets-Pro-Gallery.zip。

C++ QFluentWidgets 组件库非开源，可从 发行页面 下载体验编译好的示例程序 C++_QFluentWidgets.zip，价格见 官网。

Warning 请勿同时安装 PyQt-Fluent-Widgets、PyQt6-Fluent-Widgets、PySide2-Fluent-Widgets 和 PySide6-Fluent-Widgets，因为他们的包名都是 qfluentwidgets

运行示例▶️

使用 pip 安装好 PyQt-Fluent-Widgets 包并下载好此仓库的代码之后，就可以运行 examples 目录下的任意示例程序，比如：

cd examples/gallery
python demo.py

如果遇到 ImportError: cannot import name 'XXX' from 'qfluentwidgets'，这表明安装的包版本过低。可以按照上面的安装指令将 pypi 源替换为 https://pypi.org/simple 并重新安装.

许可证📄

PyQt-Fluent-Widgets 使用 GPLv3 许可证授权非商用项目，商用项目需购买商用许可证。

组件库受软件著作权保护，软著登字第12532763号，任何盗用、破解组件库或未经授权的商业使用均被视为侵权行为。

版权所有 © 2021 by zhiyiYo.

在线文档📕

想要了解 PyQt-Fluent-Widgets 的正确使用姿势？请仔细阅读 帮助文档 👈

演示视频📽️

请查收哔哩哔哩上的 视频合集，它展示了 PyQt-Fluent-Widgets 的全部组件和特性 🎉

Fluent Client🚩

Fluent Client 集成了设计师插件和脚手架功能，支持在 Designer 中直接拖拽使用 QFluentWidgets 的组件，所见即所得，让现代化界面搭建如丝般顺滑！可在 淘宝 购买使用 Fluent Client。

另见👀

下面是一些基于 PyQt-Fluent-Widgets 的项目：

• zhiyiYo/QMaterialWidgets: 基于 PyQt/PySide 的 Material Design 风格组件库
• zhiyiYo/Groove: 基于 PyQt5 的跨平台音乐播放器
• zhiyiYo/Alpha-Gobang-Zero: 基于强化学习的五子棋机器人

参考

• Windows design: Design guidelines and toolkits for creating native app experiences
• Microsoft/WinUI-Gallery: An app demonstrates the controls available in WinUI and the Fluent Design System