QSS

概述

QSS(Qt Style Sheets)Qt样式表，用于美化Qt程序界面。本文介绍如何使用QSS，以及一些参考QSS模版。

• 官方文档Qt Style Sheets Reference

• 参考博客muzing的杂货铺

基本语法

QSS规则集由选择器和声明组成，选择器选择改变的控件样式，声明为类似于字典的键值对。

QWidget #选择器
{
    #键值对
    color: blue;
    background-color: yellow;
}

使用方式

python

在 main.py 的 QApplication 或 QMainWindow 中加载样式。

编写QSS

新建一个扩展名为 .qss 的文件，添加至 qrc 中

加载QSS

创建一个加载QSS样式表的公共类

class QSSLoader:
    def __init__(self):
        pass

    @staticmethod
    def read_qss_file(qss_file_name):
        with open(qss_file_name, 'r',  encoding='UTF-8') as file:
            return file.read()

在代码中加载QSS样式表

app = QApplication(sys.argv)
window = MainWindow()
 
style_file = './style.qss'
style_sheet = QSSLoader.read_qss_file(style_file)
window.setStyleSheet(style_sheet)

window.show()
sys.exit(app.exec_())

QSS主题样例

Qt官方样例

Qt Style Sheets Examples

###PyQt-Fluent-Widgets
zhiyiYo/PyQt-Fluent-Widgets ——基于 C++ Qt/PyQt/PySide 的流畅设计小部件库

小部件库：

使用方法参考中文文档

Qt-Material

UN-GCPDS/qt-material ——PySide2、PySide6、PyQt5和PyQt6的Material风格样式表

暗色主题：

DarkThemes

亮色主题：

LightThemes

使用方法参考README

PyQtDarkTheme

5yutan5/PyQtDarkTheme ——PySide和PyQt的黑色主题

暗色主题：

DarkThemes

亮色主题：

LightThemes

使用方法参考PyQtDarkTheme documentation

飞扬青云-QSS

feiyangqingyun/QWidgetDemo ——Qt编写的开源demo，包括大量控件设计，在styledemo中包含几套QSS样式

QSS目录链接

Qt图标库

再也不用为了找图标而烦恼了

QtAwesome

• C++ gamecreature/QtAwesome
• Python spyder-ide/qtawesome

QSS编辑器

用于设计自己的QSS

• QssStylesheetEditor hustlei/QssStylesheetEditor
• QSS Editor HappySeaFox/qsseditor