基于 PyQt5 的 Fluent Design 风格组件库
English | 简体中文
安装轻量版 (AcrylicLabel
不可用):
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 分支下载对应的代码。
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 的正确使用姿势?请仔细阅读 帮助文档 👈
请查收哔哩哔哩上的 视频合集,它展示了 PyQt-Fluent-Widgets 的全部组件和特性 🎉
可以运行 python ./tools/designer.py
来启动安装了 PyQt-Fluent-Widgets 插件的 QtDesigner。如果操作成功,QtDesigner 的侧边栏中将会显示 PyQt-Fluent-Widgets 的组件。对于旧项目的改造,推荐使用 视频教程 中介绍的 提升为...
。
Note 推荐在虚拟环境中安装 pyqt5-tools 和 PyQt-Fluent-Widgets,并确保 PyQt5-Frameless-Window 的版本号 >= 0.2.7,不然可能出现各种奇怪的问题。
如果您正在使用这个项目并感觉良好,或者是想支持我继续开发,可以通过 爱发电 或者 ko-fi 请我喝一杯奶茶,还能获得相应的奖励哦😊。非常感谢您的支持与鼓励 🥰
可以在 PFW 小圈子 或者 Discord 上和我们一起交流探讨,分享自己对这个组件库的新发现和新想法 🚀
下面是一些使用了 PyQt-Fluent-Widgets 的项目:
- zhiyiYo/Groove: A cross-platform music player based on PyQt5
- zhiyiYo/Alpha-Gobang-Zero: A gobang robot based on reinforcement learning
- 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
PyQt-Fluent-Widgets is licensed under GPLv3.
Copyright © 2021 by zhiyiYo.